El reporte HTML - la herramienta definitiva

title

Una vez completada la ejecución de una prueba en modo CLI (non-GUI) hay dos opciones para visualizar los resultados: 1. leer el file de resultados (jtl) usando JMeter en modo GUI y usar complementos (plugins) para graficar los resultados, o 2. producir el reporte HTML. En esta entrada les presento un herramienta (shell script) que les permitirá generar el reporte HTML en forma eficiente, además de otros beneficios:

  1. generar el reporte HTML usando el fichero generado por la ejecución de test (jtl)
  2. archivar la información relevante del test

Beneficio importante

El segundo punto es sumamente importante puesto que permite reunir toda la información relevante de un test en forma permanente e inequívoca: el script crea un directorio único (usando el sello del tiempo) donde se guardan los files requeridos para crear el reporte. Adicionalmente, el script copia los siguientes files al mencionado directorio:

  1. *.jmx (jmeter script file)
  2. *.jtl (jmeter log/bitácora file)
  3. jmeter.log (jmeter run log file)
  4. errors.xml (log/bitácora de errores - opcional)

Uso

El uso es muy sencillo. El primer paso es ejecutar el JMeter script en modo CLI:

jmeter -n -t escenario.jmx -l escenario.jtl

En el segundo paso ejecutamos la herramienta usando el file jtl como parámetro:

jmRpt.sh escenario.jtl

El script crea un directorio único con un sello del tiempo (por ejemplo: 2020-09-25_18:36:58.391). El listado del directorio será aproximadamente asi:

ls -l 2020-09-25_18:36:58.391
total 760
-rw-r--r--  1 carlos  staff   36657 Sep 26 19:05 escenario.jmx
-rw-r--r--  1 carlos  staff  293822 Sep 25 18:27 escenario.jtl
drwxr-xr-x  5 carlos  staff     160 Sep 25 18:37 content
-rw-r--r--@ 1 carlos  staff    9678 Sep 25 18:37 index.html
-rw-r--r--  1 carlos  staff    2598 Sep 25 18:34 jmeter.log
drwxr-xr-x  7 carlos  staff     224 Sep 25 18:37 sbadmin2-1.0.7
-rw-r--r--  1 carlos  staff     992 Sep 25 18:37 statistics.json

Finalmente, cambie al directorio y abra el reporte HTML en el browser:

open index.html

Descarga de la herramienta

La herramienta (y el README file) se pueden descargar de la siguiente manera:

git clone git@github.com:cgodinez1271/jmeter-dashboard-rpt.git

Nota: Este script ha sido diseñado para ser ejecutado en MacOS. Probablemente funcione en Linux.

-Carlos