Versión de la integración1.2.0
La integración Apollo en Datadog te permite reenviar métricas de rendimiento de Studio a tu cuenta Datadog. Datadog es compatible con una API de función avanzada, lo que te permite crear gráficos y alertas de métricas de GraphQL.
Studio reenvía las siguientes métricas a Datadog:
apollo.operations.count - El número de operaciones GraphQL que se ejecutaron. Esto incluye consultas, mutaciones y operaciones que dieron lugar a un error.
apollo.operations.error_count - El número de operaciones GraphQL que dieron lugar a un error. Esto incluye errores de ejecución de GraphQL y errores HTTP si Studio no pudo conectarse a tu servidor.
apollo.operations.cache_hit_count - Número de consultas GraphQL cuyo resultado se ha obtenido de la caché de consultas completas del servidor Apollo.
Un histograma de los tiempos de respuesta de las operaciones GraphQL medidos en milisegundos. Debido al método de agregación de Studio (binning logarítmico), estos valores tienen una precisión de +/- 5%:
apollo.operations.latency.minapollo.operations.latency.medianapollo.operations.latency.95percentileapollo.operations.latency.99percentileapollo.operations.latency.maxapollo.operations.latency.avg
Estas métricas se agregan en intervalos de 60 segundos y se etiquetan con el nombre de la operación GraphQL como operation:<query-name>. Las firmas de consulta única con el mismo nombre de operación se fusionan y las consultas sin nombre de operación se ignoran.
Estas métricas también se etiquetan con el ID del gráfico de Studio asociado (como graph:<graph-id>) y el nombre de la variante asociada (como variant:<variant-name>), por lo que varios gráficos de Studio pueden enviar datos a la misma cuenta Datadog. Si no has definido un nombre de variante, se utiliza current.
(Las integraciones configuradas antes de octubre de 2020 tienen nombres de métrica que empiezan por apollo.engine.operations en lugar de apollo.operations y utilizan una etiqueta (tag) service en lugar de graph. Puedes migrar a los nuevos nombres de métricas en la página Integraciones de tu gráfico en Apollo Studio).
Configuración
Configuración
La configuración con la integración Apollo en Datadog es tan simple como proporcionar una clave de API y una región de Datadog a Studio. No es necesaria ninguna otra configuración.
Ve a tu página de integraciones Datadog y haz clic en el cuadro Apollo. A continuación, ve a la pestaña Configuration (Configuración) y haz clic en Install Integration (Instalar integración) en la parte inferior.
Ve a la página de tu API Datadog y crea una clave de API.
Determina la región de tu API de Datadog observando la barra de direcciones de tu navegador:
- Si el nombre de dominio es
app.datadoghq.com, la región de tu API es US. - Si el nombre de dominio es
app.datadoghq.eu, la región de tu API es EU.
En Studio, ve a la página de integraciones de tu gráfico:
En la sección de reenvío de Datadog, haz clic en Configure (Configurar). Indica tu clave y tu región de API y luego haz clic en Enable (Habilitar). Dado que todas las métricas reenviadas se etiquetan con el ID del gráfico correspondiente (graph:<graph-id>), puedes utilizar la misma clave de API para todos tus gráficos.
Ve al Explorador de métricas de Datadog para ver tus métricas. Las métricas pueden tardar hasta cinco minutos para ser visibles.
Utilización
Consulta los documentos sobre las integraciones Apollo para obtener información de uso más detallada.
Datos recopilados
Métricas
| |
|---|
apollo.operations.count
(gauge) | Número de operaciones GraphQL (consultas y mutaciones) procesadas.
Se muestra como operación |
apollo.operations.latency.avg
(gauge) | Duración total de la solicitud de una operación GraphQL, promedio.
Se muestra como milisegundos |
apollo.operations.latency.median
(gauge) | Duración total de la solicitud de una operación GraphQL, mediana/percentil 50.
Se muestra como milisegundos |
apollo.operations.latency.95percentile
(gauge) | Duración total de la solicitud de una operación GraphQL, percentil 95.
Se muestra como milisegundos |
apollo.operations.latency.99percentile
(gauge) | Duración total de la solicitud de una operación GraphQL, percentil 99.
Se muestra como milisegundos |
apollo.operations.latency.max
(gauge) | Duración total de la solicitud de una operación GraphQL, máxima/percentil 100.
Se muestra como milisegundos |
apollo.operations.latency.min
(gauge) | Duración total de la solicitud de una operación GraphQL, mínima/percentil 0.
Se muestra como milisegundos |
apollo.operations.error_count
(gauge) | Número de operaciones GraphQL que han dado lugar a un error GraphQL, incluidos los errores HTTP de los orígenes.
Se muestra como error |
apollo.operations.cache_hit_count
(gauge) | Número de consultas GraphQL que se han proporcionado desde la caché de respuestas completas.
Se muestra como acierto |
apollo.engine.operations.count
(gauge) | Número de operaciones GraphQL (consultas y mutaciones) procesadas. (Métrica legacy, las nuevas integraciones utilizan apollo.operations.count.)
Se muestra como operación |
apollo.engine.operations.latency.avg
(gauge) | Duración total de la solicitud de una operación GraphQL, promedio. (Métrica legacy, las nuevas integraciones utilizan apollo.operations.latency.avg.)
Se muestra como milisegundos |
apollo.engine.operations.latency.median
(gauge) | Duración total de la solicitud de una operación GraphQL, mediana/percentil 50. (Métrica legacy, las nuevas integraciones utilizan apollo.operations.latency.median.)
Se muestra como milisegundos |
apollo.engine.operations.latency.95percentile
(gauge) | Duración total de la solicitud de una operación GraphQL, percentil 95. (Métrica legacy, las nuevas integraciones utilizan apollo.operations.latency.95percentile)
Se muestra como milisegundos |
apollo.engine.operations.latency.99percentile
(gauge) | Duración total de la solicitud de una operación GraphQL, percentil 99. (Métrica legacy, las nuevas integraciones utilizan apollo.operations.latency.99percentile.)
Se muestra como milisegundos |
apollo.engine.operations.latency.max
(gauge) | Duración total de la solicitud de una operación GraphQL, máxima/percentil 100. (Métrica legacy, las nuevas integraciones utilizan apollo.operations.latency.max)
Se muestra como milisegundos |
apollo.engine.operations.latency.min
(gauge) | Duración total de la solicitud de una operación GraphQL, mínima/percentil o. (Métrica legacy, las nuevas integraciones utilizan apollo.operations.latency.min.)
Se muestra como milisegundos |
apollo.engine.operations.error_count
(gauge) | Número de operaciones GraphQL que han dado lugar a un error GraphQL, incluidos los errores HTTP de los orígenes. (Métrica legacy, las nuevas integraciones utilizan apollo.operations.error_count.)
Se muestra como error |
apollo.engine.operations.cache_hit_count
(gauge) | Número de consultas GraphQL que se han proporcionado desde la caché de respuestas completas. (Métrica legacy, las nuevas integraciones utilizan apollo.operations.cache_hit_count.)
Se muestra como acierto |
Eventos
La integración Apollo no incluye eventos en este momento.
Checks de servicio
La integración Apollo no incluye checks de servicios en este momento.
Solucionar problemas
¿Necesitas ayuda? Ponte en contacto con el servicio de asistencia de Datadog.
