Información general

Datadog recopila eventos Real User Monitoring (RUM) a partir de los SDK RUM de navegadores y móviles, que puedes utilizar para crear un Quick Graph y calcular métricas de indicadores de rendimiento como Apdex.

Para calcular tu puntuación de Apdex, puedes utilizar la monitorización de servicios de APM o los datos de monitorización de usuarios a partir de los SDK RUM. Esta guía proporciona instrucciones sobre el cálculo de Apdex para una aplicación con datos RUM y el widget Valor de consulta en un Quick Graph.

Para obtener más información sobre el cálculo de Apdex utilizando datos de monitorización de servicios, consulta Configurar la puntuación de Apdex por servicio.

Requisitos previos

• Tu aplicación web o móvil debe estar instrumentada con el SDK RUM. Para configurar la instrumentación, consulta Monitorización del Navegador RUM, Monitorización de RUM Android y Monitorización de RUM iOS.
• Los eventos de tu aplicación deben estar disponibles en Datadog.

Cálculo de una puntuación de Apdex

En el siguiente ejemplo se calcula una puntuación de Apdex utilizando la métrica de rendimiento Largest Contentful Paint de eventos RUM y un umbral hipotético de T = 2 sec. La latencia de frustración mínima es 4T = 8 sec. El valor resultante se muestra en un Quick Graph del widget de valor de consulta, que puedes exportar a dashboards o notebooks.

Crear un Quick Graph

1. Ve a dashboards > Quick Graph.
2. Crea tres consultas RUM:
   • Consulta a para todas las cargas de páginas satisfactorias (vistas RUM en las que Largest Contentful Paint tarda menos de 2 segundos en cargarse).
   • Consulta b para todas las cargas de páginas toleradas (vistas RUM en las que Largest Contentful Paint tarda menos de 8 segundos en cargarse).
   • Consulta c para todas las cargas de páginas (todas las vistas RUM).
3. En el campo Fórmula, introduce la fórmula de Apdex (a + 0.5 * b) / c .
4. En Seleccionar una visualización, haz clic en Valor de consulta. Aparece un widget de valor de consulta.
5. En el selector de marco temporal, selecciona Pasado 1 día. Por defecto, el widget se muestra en Hora global.
6. Introduce un nombre para el gráfico, por ejemplo Apdex Score.
7. También puedes exportar o copiar y pegar el Quick Graph en un dashboard o notebook o puedes hacer clic en Exportar > Nuevo dashboard para crear un dashboard con este Quick Graph.

Consulta A

1. En Grafica tus datos, selecciona RUM como fuente de datos para la consulta a e introduce @view.largest_contentful_paint:<2s.
2. Pulsa Intro o haz clic en Actualizar consulta en el menú desplegable. La consulta Largest Contentful Paint:<2s aparece junto a RUM para la consulta a.

Consulta B

1. Para crear la consulta b, haz clic en + Añadir consulta.
2. Selecciona RUM como fuente de datos para la consulta b e introduce @view.largest_contentful_paint:[2s TO 8s].
3. Pulsa Intro o haz clic en Actualizar consulta en el menú desplegable. La consulta Largest Contentful Paint:[2s - 8s] aparece junto a RUM para la consulta b.

Consulta C

1. Para crear la consulta c, haz clic en + Añadir consulta.
2. Selecciona RUM como fuente de datos para la consulta c e introduce @Type:view.
3. Pulsa Intro o haz clic en Actualizar consulta en el menú desplegable. La consulta Type:view aparece junto a RUM para la consulta c.

Configuración JSON

Para acceder al código JSON de este gráfico, haz clic en la pestaña JSON junto a Editar.

Haz clic en el icono de copia en la esquina derecha para copiar el Quick Graph JSON en el portapapeles.

{
    "viz": "query_value",
    "requests": [
        {
            "formulas": [
                {
                    "formula": "(query1 + 0.5 * query2) / query3"
                }
            ],
            "queries": [
                {
                    "search": {
                        "query": "@type:view @view.largest_contentful_paint:<2000000000"
                    },
                    "data_source": "rum",
                    "compute": {
                        "aggregation": "count"
                    },
                    "name": "query1",
                    "indexes": [
                        "*"
                    ],
                    "group_by": []
                },
                {
                    "search": {
                        "query": "@type:view @view.largest_contentful_paint:[2000000000 TO 8000000000]"
                    },
                    "data_source": "rum",
                    "compute": {
                        "aggregation": "count"
                    },
                    "name": "query2",
                    "indexes": [
                        "*"
                    ],
                    "group_by": []
                },
                {
                    "search": {
                        "query": "@type:view"
                    },
                    "data_source": "rum",
                    "compute": {
                        "aggregation": "count"
                    },
                    "name": "query3",
                    "indexes": [
                        "*"
                    ],
                    "group_by": []
                }
            ],
            "response_format": "scalar",
            "conditional_formats": []
        }
    ],
    "autoscale": true,
    "precision": 2
}

Visualizaciones y puntuaciones de Apdex adicionales

En el ejemplo anterior, la puntuación de Apdex es relevante para los eventos de visualización RUM y para la métrica de rendimiento Largest Contentful Paint.

También puedes calcular otras puntuaciones de Apdex con los siguientes métodos:

• Para ver la tendencia de la puntuación de Apdex a lo largo del tiempo, selecciona Timeseries en lugar de Query Value en Selecciona tu visualización.
• Para calcular la puntuación de Apdex para una aplicación específica, añade una consulta adicional @application.name y actualiza tu fórmula.
• Para calcular la puntuación de Apdex con otra métrica de rendimiento RUM, como First Contentful Paint, sustituye @view.LargestContentfulPaint por @view.FirstContentfulPaint en las consultas.

Para calcular indicadores de rendimiento adicionales para tus aplicaciones, determina qué puntos de datos necesitas y qué eventos RUM son relevantes para ti, antes de crear un Quick Graph.

Referencias adicionales

Más enlaces, artículos y documentación útiles:

Configurar la puntuación de Apdex por servicioDOCUMENTACIÓN Dashboards RUMDOCUMENTACIÓN Datos del navegador RUM recopiladosDOCUMENTACIÓN Datos de RUM Android recopiladosDOCUMENTACIÓN Datos de RUM iOS recopiladosDOCUMENTACIÓN