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.