JMeter

Supported OS Linux Mac OS Windows

Versión de la integración1.0.0

Información general

Datadog Backend Listener para Apache JMeter es un complemento de JMeter de código abierto utilizado para enviar los resultados de los tests a la plataforma de Datadog. Proporciona informes en tiempo real de las métricas de test como la latencia, el número de bytes enviados y recibidos, etc. También puedes enviar a Datadog los resultados completos de los tests como entradas de log.

Configuración

Instalación

El complemento Datadog Backend Listener debe instalarse manualmente. Consulta la última versión y las instrucciones de instalación más actualizadas en su repositorio de GitHub.

Instalación manual

  1. Descarga el archivo JAR del complemento Datadog desde la página de versiones
  2. Coloca el JAR en el directorio lib/ext dentro de tu instalación de JMeter.
  3. Inicia JMeter (o sal de la aplicación y vuelve a abrirla).

Administrador de complementos de JMeter

  1. Si aún no está configurado, descarga el JAR del gestor de complementos JMeter.
  2. Una vez completada la descarga, coloca .jar en el directorio lib/ext en tu instalación de JMeter.
  3. Inicia JMeter (o sal de la aplicación y vuelve a abrirla).
  4. Ve a Options > Plugins Manager > Available Plugins (Opciones > Gestor de complementos > Complementos disponibles).
  5. Busca “Datadog Backend Listener”.
  6. Haz clic en la casilla situada junto al complemento Datadog Backend Listener.
  7. Haz clic en “Apply Changes and Restart JMeter” (Aplicar cambios y reiniciar JMeter).

Configuración

Para empezar a informar métricas a Datadog:

  1. Haz clic con el botón derecho del ratón en el grupo de subprocesos o en el plan de tests del que quieras enviar métricas a Datadog.
  2. Ve a Add > Listener > Backend Listener (Añadir > Listener > Backend Listener).
  3. Modifica la Backend Listener Implementation y selecciona org.datadog.jmeter.plugins.DatadogBackendClient en el menú desplegable.
  4. Configura la variable apiKey en tu clave de API Datadog.
  5. Ejecuta tu test y valida que las métricas han aparecido en Datadog.

El complemento dispone de las siguientes opciones de configuración:

NombreObligatorioValor por defectodescripción
apiKeyverdaderoNATu clave de API de Datadog.
datadogUrlfalsohttps://api.datadoghq.com/api/Puedes configurar un endpoint diferente, por ejemplo https://api.datadoghq.eu/api/ si tu instancia de Datadog se encuentra en la UE.
logIntakeUrlfalsohttps://http-intake.logs.datadoghq.com/v1/input/Puedes configurar un endpoint diferente, por ejemplo: https://http-intake.logs.datadoghq.eu/v1/input/ si tu instancia de Datadog se encuentra en la UE.
metricsMaxBatchSizefalso200Las métricas se envían cada 10 segundos en lotes de tamaño metricsMaxBatchSize.
logsBatchSizefalso500Los logs se envían en lotes de tamaño logsBatchSize en cuanto se alcanza este tamaño.
sendResultsAsLogsfalsofalsoPor defecto, solo se informan métricas a Datadog. Para notificar resultados de tests individuales como eventos de logs, configura este campo como true.
includeSubresultsfalsofalsoUn subresultado se produce, por ejemplo, cuando una solicitud HTTP individual tiene que seguir redirecciones. Por defecto, los subresultados se ignoran.
excludeLogsResponseCodeRegexfalso""Si seleccionas sendResultsAsLogs, todos los resultados se enviarán por defecto como logs a Datadog. Esta opción permite excluir los resultados cuyo código de respuesta coincida con una expresión regular determinada. Por ejemplo, puedes establecer esta opción en [123][0-5][0-9] para enviar solo los errores.
samplersRegexfalso.*Una expresión regular opcional para filtrar los muestreadores a monitorizar.
customTagsfalso""Lista de etiquetas (tags) separada por comas para añadir a cada métrica

Datos recopilados

Métricas

jmeter.byte_received.avg
(gauge)		Valor medio del número de bytes recibidos.
Se muestra como byte
jmeter.byte_received.count
(gauge)		Número de muestras utilizadas para calcular la distribución de bytes recibidos.
Se muestra como solicitud
jmeter.byte_received.max
(gauge)		Valor máximo del número de bytes recibidos.
Se muestra como byte
jmeter.byte_received.min
(gauge)		Valor mínimo del número de bytes recibidos.
Se muestra como byte
jmeter.byte_received.p90
(gauge)		Valor del P90 del número de bytes recibidos.
Se muestra como byte
jmeter.byte_received.p95
(gauge)		Valor del P95 del número de bytes recibidos.
Se muestra como byte
jmeter.byte_received.p99
(gauge)		Valor del P99 del número de bytes recibidos.
Se muestra como byte
jmeter.byte_sent.avg
(gauge)		Valor medio del número de bytes enviados.
Se muestra como byte
jmeter.byte_sent.count
(gauge)		Número de muestras utilizadas para calcular la distribución de bytes enviados.
Se muestra como solicitud
jmeter.byte_sent.max
(gauge)		Valor máximo del número de bytes enviados.
Se muestra como byte
jmeter.byte_sent.min
(gauge)		Valor mínimo del número de bytes enviados.
Se muestra como byte
jmeter.byte_sent.p90
(gauge)		Valor del P90 del número de bytes enviados.
Se muestra como byte
jmeter.byte_sent.p95
(gauge)		Valor del P95 del número de bytes enviados.
Se muestra como byte
jmeter.byte_sent.p99
(gauge)		Valor del P99 del número de bytes enviados.
Se muestra como byte
jmeter.latency.avg
(gauge)		Valor medio de la latencia.
Se muestra como segundo
jmeter.latency.count
(gauge)		Número de muestras utilizadas para calcular la distribución de la latencia.
Se muestra como solicitud
jmeter.latency.max
(gauge)		Valor máximo de la latencia.
Se muestra como segundo
jmeter.latency.min
(gauge)		Valor mínimo de la latencia.
Se muestra como segundo
jmeter.latency.p90
(gauge)		Valor del P90 de la latencia.
Se muestra como segundo
jmeter.latency.p95
(gauge)		Valor del P95 de la latencia.
Se muestra como segundo
jmeter.latency.p99
(gauge)		Valor del P99 de la latencia.
Se muestra como segundo
jmeter.response_time.avg
(gauge)		Valor medio del tiempo de respuesta.
Se muestra como segundo
jmeter.response_time.count
(gauge)		Número de muestras utilizadas para calcular la distribución del tiempo de respuesta.
Se muestra como solicitud
jmeter.response_time.max
(gauge)		Valor máximo del tiempo de respuesta.
Se muestra como segundo
jmeter.response_time.min
(gauge)		Valor mínimo del tiempo de respuesta.
Se muestra como segundo
jmeter.response_time.p90
(gauge)		Valor del P90 del tiempo de respuesta.
Se muestra como segundo
jmeter.response_time.p95
(gauge)		Valor del P95 del tiempo de respuesta.
Se muestra como segundo
jmeter.response_time.p99
(gauge)		Valor del P99 del tiempo de respuesta.
Se muestra como segundo
jmeter.responses_count
(count)		Recuento del número de respuestas recibidas por muestreador y por estado.
Se muestra como respuesta

Checks de servicio

JMeter no incluye ningún check de servicio.

Eventos

JMeter no incluye ningún evento.

Solucionar problemas

¿Necesitas ayuda? Ponte en contacto con el servicio de asistencia de Datadog.

Referencias adicionales

Documentación útil adicional, enlaces y artículos: