⚠️ Para k6 Cloud tests, sigue las instrucciones de k6 Cloud.
k6 puede enviar métricas de pruebas de rendimiento a Datadog. Esto permite visualizar y correlacionar las métricas de pruebas de rendimiento con otras métricas monitorizadas en Datadog.
Este artículo describe las instrucciones de la integración con Datadog:
- Ejecutar el agente de Datadog
- Ejecutar la prueba con k6
- Visualizar en Datadog
Ejecute el agente Datadog
Para obtener las métricas de k6 en Datadog, k6 envía las métricas a través del Datadog Agent, que recoge, agrega y reenvía las métricas a la plataforma Datadog.
Ejecute el servicio Datadog Agent como un contenedor Docker con este comando:
Reemplace <YOUR_DATADOG_API_KEY> con su clave API de Datadog. Si su cuenta está registrada en Datadog EU, cambie el valor de DD_SITE a datadoghq.eu.
Para obtener información adicional, lea la documentación de Datadog Docker Agent.
DogStatsD
El agente Datadog incluye el servicio DogStatsD para recoger y agregar métricas. DogStatsD implementa el protocolo StatsD con algunas extensiones. Por ejemplo, el etiquetado de DogStatsD permite recopilar métricas de k6 con etiquetas para distinguir entre solicitudes de diferentes URLs, estatus de la respuesta, grupos, etc.
La instrucción anterior ejecuta el servicio DogStatsD en un contenedor Docker, pero también es posible ejecutarlo como Host Agent, Kubernetes, and Helm.
Ejecutar el test k6
Una vez que el servicio de Datadog Agent está funcionando, ejecute la prueba con k6 y envíe las métricas al Agent con:
Las variables de entorno para el comando son:
Nombre | Valor |
---|---|
K6_DATADOG_ADDR | Dirección del servicio DogsStatsD, actualmente sólo se admite UDP. El valor por defecto es localhost:8125. |
K6_DATADOG_NAMESPACE | El espacio de nombres utilizado como prefijo para todos los nombres de las métricas. El valor por defecto es k6. |
K6_DATADOG_PUSH_INTERVAL | Configure la frecuencia con la que se envían los lotes de datos. El valor por defecto es 1s. |
K6_DATADOG_BUFFER_SIZE | El tamaño del buffer. El valor por defecto es 20. |
K6_DATADOG_TAG_BLACKLIST | Es una lista separada por comas de las etiquetas que NO deben enviarse a Datadog. Por ejemplo, "tag1, tag2". El valor por defecto es vacío. |
Visualización en Datadog
Mientras se ejecuta la prueba, k6 envía métricas periódicamente a Datadog. Por defecto, estas métricas tienen el prefijo k6 como nombre.
Puede visualizar las métricas de k6 en tiempo real con el explorador de métricas, monitores, o dashboards personalizados.
Para saber más sobre todos los tipos de métricas de k6, lea la guía de métricas de k6.
La primera vez que Datadog detecta la métrica k6.http_reqs, la integración de k6 se instala automáticamente, y el panel de control de k6 por defecto se añade a su lista de paneles.
Opcionalmente, puede instalar la integración de k6 siguiendo estas instrucciones:
- Inicie sesión en Datadog.
- En el menú de la barra lateral, seleccione Integrations > Integrations.
- Busque k6, luego seleccione la integración con k6.
- Haga clic en la opción de la pestaña Configuration.
- Haga scroll hasta abajo y haga clic en el botón Install integration.