RUM de Dynatrace: configurar el Real User Monitoring y leer los Core Web Vitals

RUM de Dynatrace: inyecta el JavaScript de RUM, verifica la recogida y lee LCP, CLS e INP en el percentil 75 con DQL para fijar SLO del lado del usuario.
RUM Dynatrace : configurer le Real User Monitoring et lire les Core Web Vitals

Los dashboards de servidor están en verde, los tiempos de respuesta de los servicios son buenos y, sin embargo, el soporte recibe quejas: «el sitio va lento». El servidor solo ve una parte del trayecto. El RUM de Dynatrace (Real User Monitoring) mide lo que ocurre en el navegador de cada usuario: carga, renderizado, interacciones, errores de JavaScript.

Para un SRE, es la única fuente que dice si el SLO se cumple desde el punto de vista del usuario. Los Core Web Vitals (LCP, CLS, INP) dan un lenguaje común con los equipos de frontend y de producto: tres cifras, umbrales públicos y una lectura en el percentil 75 que evita guiarse por una media engañosa.

Objetivo de este tutorial: activar el RUM en una aplicación web, verificar que los datos llegan y leer después los Core Web Vitals con DQL. La configuración vale para Dynatrace SaaS y Dynatrace Managed; las consultas DQL sobre user.events corresponden a la nueva experiencia RUM en Grail, disponible en SaaS.

Qué miden los Core Web Vitals

Indicador Qué mide Campo en user.events
LCP (Largest Contentful Paint) El momento en que se muestra el elemento visible más grande web_vitals.largest_contentful_paint
CLS (Cumulative Layout Shift) La estabilidad visual: ¿«salta» la página durante la carga? web_vitals.cumulative_layout_shift
INP (Interaction to Next Paint) La capacidad de respuesta: retraso entre un clic y la actualización de la pantalla web_vitals.interaction_to_next_paint

Los umbrales «bueno / mejorable / malo» los publica el proyecto web.dev de Google; evolucionan, así que consulta la página oficial en lugar de una cifra copiada.

Requisitos previos

  • Un entorno de Dynatrace SaaS o Managed, con permiso para configurar aplicaciones web.
  • O bien OneAgent instalado en los servidores web o de aplicaciones que sirven las páginas HTML (inyección automática), o bien acceso al código o a la plantilla HTML de la aplicación (inserción manual).
  • Para las consultas DQL: la nueva experiencia RUM activada en un entorno SaaS y acceso a Notebooks.
  • El visto bueno de tu DPO sobre la recogida: dirección IP, identificación de usuarios, Session Replay.

Configurar el RUM de Dynatrace paso a paso

Paso 1: elegir el modo de inyección

Dos caminos llevan al mismo JavaScript de monitorización:

  • Inyección automática: OneAgent, presente en el servidor web, inserta la etiqueta en cada página HTML servida. No hay que modificar nada en el código; es el camino más rápido.
  • Inserción manual: añades la etiqueta en la plantilla HTML. Indispensable cuando el servidor no está instrumentado: CDN, alojamiento estático, SaaS de terceros, aplicación de página única servida desde un bucket.

Paso 2: declarar la aplicación web

Crea la aplicación web en los ajustes de Dynatrace y define las reglas de detección (dominio o patrón de URL) que asocian el tráfico a esa aplicación. Una aplicación por cada producto visible para los usuarios es un buen reparto; evita agrupar todo en la aplicación por defecto, o los Core Web Vitals de la intranet se mezclarán con los del sitio público.

Paso 3: obtener la etiqueta para una inserción manual

Si has elegido la inserción manual, obtén la etiqueta más reciente mediante la API (SaaS; en Managed, la URL sigue el formato https://<tu-dominio>/e/<env-id>):

curl -s "$DT_URL/api/v2/rum/javaScriptTag/APPLICATION-0123456789ABCDEF?scriptExecutionAttribute=ASYNC" \
  -H "Authorization: Api-Token $DT_API_TOKEN"

La respuesta es un texto <script ...> que debes colocar lo más arriba posible en el <head>. El parámetro scriptExecutionAttribute acepta ASYNC, DEFER o NONE. Automatiza esta llamada en tu build: la etiqueta hace referencia a un archivo de configuración que evoluciona con los ajustes de la aplicación. Para el scope exacto del token, consulta la página del endpoint en la documentación.

Paso 4: adaptar la Content Security Policy

Una CSP estricta bloquea en silencio el script o el envío de los datos. En el caso más sencillo (inyección automática, endpoint de beacon por defecto, Session Replay desactivado), basta la regla básica:

Content-Security-Policy: script-src 'self'; connect-src 'self';

Si el script se carga desde un CDN o si los beacons salen hacia otro dominio, añade esos orígenes a script-src y connect-src. Prueba en preproducción con la consola del navegador abierta: una infracción de la CSP aparece ahí de inmediato.

Paso 5: ajustar la privacidad

Activa el enmascaramiento de las direcciones IP, respeta la señal «Do Not Track» si tu política lo exige e identifica a los usuarios solo con un identificador seudónimo. Si activas Session Replay, elige un nivel de enmascaramiento que oculte los campos de entrada (consulta Session Replay en Grail).

Cómo comprobar que funciona

Abre la página en un navegador y después la pestaña Red de las herramientas de desarrollo: deberías ver la carga del script de Dynatrace y, tras algunas interacciones, peticiones de beacon. En Dynatrace, las primeras sesiones aparecen en pocos minutos.

En SaaS, con la nueva experiencia RUM, lee el LCP en el percentil 75 por página en un Notebook:

fetch user.events
| filter characteristics.has_page_summary
| filter isNotNull(web_vitals.largest_contentful_paint)
| summarize page_LCP = percentile(web_vitals.largest_contentful_paint, 75), by:{ page.name }
| sort page_LCP desc

Después, los tres indicadores juntos, por aplicación:

fetch user.events, from:now()-24h
| filter characteristics.has_page_summary
| summarize {
    lcp_p75 = percentile(web_vitals.largest_contentful_paint, 75),
    cls_p75 = percentile(web_vitals.cumulative_layout_shift, 75),
    inp_p75 = percentile(web_vitals.interaction_to_next_paint, 75),
    pages = count()
  }, by:{ frontend.name }

Una columna vacía para INP no es necesariamente un error: el indicador solo existe si el usuario ha interactuado con la página. En Managed (RUM clásico), los Core Web Vitals se leen en el análisis de la aplicación web y de las acciones de usuario.

Buenas prácticas

  • Guíate por el percentil 75, nunca por la media: una media oculta a los usuarios móviles lentos.
  • Divide por página y por dispositivo: una regresión del LCP suele afectar a una sola plantilla.
  • Convierte un indicador en un SLO: por ejemplo, «90 % de las páginas de pago con un LCP bueno» a 28 días, con alertas de burn rate en lugar de un umbral fijo.
  • Vincula el frontend con el backend: una acción lenta se sigue hasta los spans del servicio llamado (consulta OpenTelemetry de extremo a extremo).
  • Complementa con monitorización sintética para las horas sin tráfico, en las que el RUM no tiene nada que medir.

Preguntas frecuentes

¿El RUM ralentiza las páginas?

El script se carga de forma asíncrona y envía sus datos por lotes. Su coste es bajo, pero mídelo: compara el LCP antes y después de la activación en una página de prueba, en preproducción.

¿Por qué no llega ningún dato aunque la etiqueta esté presente?

Las tres causas más frecuentes: una CSP que bloquea el script o los beacons, una regla de detección que asocia el tráfico a otra aplicación, o un bloqueador de anuncios en el equipo de prueba. Revisa la pestaña Red y después la consola.

¿Hay que activar Session Replay a la vez?

No, es una decisión aparte. Empieza solo con el RUM, valida la privacidad con tu DPO y activa después Session Replay en un porcentaje reducido de sesiones.

Conclusión

El RUM de Dynatrace se pone en marcha en una hora: inyección automática o etiqueta manual, una CSP adaptada y reglas de privacidad claras. El verdadero trabajo empieza después: leer LCP, CLS e INP en el percentil 75, página por página, y convertirlos en SLO que reflejen por fin lo que viven los usuarios.

span.observer es un blog independiente de la comunidad, no afiliado a Dynatrace LLC. Dynatrace es una marca de su propietario. Los nombres de campos, pantallas y ajustes evolucionan: compruébalos en la documentación oficial de tu versión.

Total
0
Shares
Leave a Reply

Your email address will not be published. Required fields are marked *

Previous Post
Monitoring synthétique Dynatrace : tutoriel HTTP et navigateur, API, coût et emplacements

Monitorización sintética de Dynatrace: tutorial HTTP y navegador, API, coste y ubicaciones

Next Post
DQL avancé : lookup, join, parse et fonctions de fenêtre

DQL avanzado: lookup, join, parse y funciones de ventana

Related Posts