New Relic

⚠️   Para k6 Cloud tests, sigue las instrucciones de k6 Cloud.

k6 puede enviar los datos de telemetría a New Relic a través de la integración de New Relic StatsD. Dentro de New Relic puede encontrar sus datos de rendimiento de k6 junto con los datos de sus usuarios reales y el rendimiento del lado del servidor. Estos datos pueden ser visualizados en los dashboards y ser compartidos con otros usuarios, además pueden ser utilizados para comparar el impacto de la carga con el rendimiento del sistema, y también alertar sobre las métricas.

Esta guía cubre la ejecución de la integración de New Relic:

• Ejecutar la integración de New Relic StatsD
• Ejecutar la prueba con k6
• Visualizar la telemetría de k6 en New Relic

Ejecutar la integración de New Relic StatsD

Para obtener las métricas de k6 en New Relic, k6 envía las métricas a la integración New Relic StatsD que se encargará de recopilar, agregar, formatear y enviar la telemetría a la plataforma de datos de telemetría de New Relic. Puede ejecutar esto con o sin un agente de New Relic.

Ejecute la integración de New Relic como un contenedor Docker con el siguiente comando:

docker run --rm \
  -d --restart unless-stopped \
  --name newrelic-statsd \
  -h $(hostname) \
  -e NR_ACCOUNT_ID=<NR-ACCOUNT-ID> \
  -e NR_API_KEY="<NR-INSERT-API-KEY>" \
  -p 8125:8125/udp \
  newrelic/nri-statsd:latest

Reemplace <NR-ACCOUNT-ID> con su ID de cuenta de New Relic y <NR-INSERT-API-KEY> con su clave de API de New Relic Insert.

Si su cuenta está alojada en la región de la UE de New Relic, añada también esto al comando anterior: -e NR_EU_REGION=true \.

Acerca de la integración de New Relic

La integración de New Relic StatsD instalada anteriormente puede funcionar de forma independiente. La instalación de un agente de New Relic es opcional.

Todo lo proporcionado en el comando anterior es suficiente para enviar las métricas de rendimiento de k6 a New Relic. Sin embargo, opcionalmente puede añadir más configuración, definir más métricas y sus formatos (sin embargo, puede hacer esto en la configuración del lado de New Relic), añadir etiquetas personalizadas y crear alertas. Esto está cubierto en la tabla opcional de abajo.

Ejecutar la prueba con k6

Una vez que la integración esté lista, ejecute la prueba con k6 y envíe las métricas a la integración con el siguiente comando:

$ k6 run --out statsd script.js

Las variables de entorno necesarias utilizadas en el comando anterior son:

Variables de entorno opcionales que puede utilizar:

Visualización en New Relic

A medida que su prueba de k6 se ejecuta, k6 envía métricas de rendimiento a la integración con New Relic StatsD, que a su vez envía estas métricas a la plataforma de datos de telemetría de New Relic. Éstas llevarán el prefijo k6. para que pueda identificarlas.

Puedes visualizar las métricas enviadas desde esta integración en data explorer en la parte superior derecha de New Relic (consulta tus datos).

También puede añadir estas métricas a los dashboards y alertar sobre las métricas de k6.

Ejemplo de las consultas NRQL

note

New Relic no tiene soporte para calcular percentiles sobre datos enviados como métricas, que es el formato enviado por esta integración. Vea este hilo en el foro de New Relic y la documentación sobre el tipo de dato metric (en inglés) para más detalle.

A continuación se muestran algunos ejemplos de consultas NRQL que puedes copiar y pegar fácilmente en los widgets de un dashboard de New Relic, sin embargo, puedes seguir con el constructor de gráficos. Encuentre todas sus métricas de k6 en la pestaña de métricas, con el prefijo k6..

Número de usuarios virtuales

SELECT latest(k6.vus) FROM Metric TIMESERIES

Duración máxima, mediana y media de las solicitudes

SELECT max(k6.http_req_duration.summary) AS 'Max Duration', average(k6.http_req_duration.median) AS 'Median', average(k6.http_req_duration.mean) AS 'Avg' FROM Metric TIMESERIES

Tasa de solicitudes

SELECT rate(max(k6.http_reqs.per_second), 1 seconds) FROM Metric TIMESERIES

Datos enviados y datos recibidos

SELECT sum(k6.data_received) as 'Data Received', max(k6.data_sent) AS 'Data Sent' FROM Metric TIMESERIES

Histograma de solicitudes

SELECT histogram(`k6.http_reqs`, 80, 20) FROM Metric

Cambio en el número de solicitudes

SELECT derivative(k6.http_reqs, 30 seconds) AS 'Rate /reqs' FROM Metric TIMESERIES

Lista desplegable de todas las métricas de rendimiento de k6

SELECT uniques(metricName) FROM Metric WHERE metricName LIKE 'k6%' LIMIT MAX