Ejecutar una prueba de carga Apache JMeter desde el modo línea de comandos (Principiante/Intermedio)

AaronLopez

¿Por qué ejecutar planes de prueba desde el modo Command-line? <\/H1>La razón principal para ejecutar una prueba de carga desde el modo Command-line (CLI) y no a través del modo GUI es que este último puede disminuir las capacidades de JMeter. Usar la GUI para ejecutar la prueba puede consumir CPU y memoria adicionales que pueden afectar negativamente los resultados de la prueba. El entorno en modo CLI es la opción óptima para la ejecución de pruebas y es la metodología recomendada por el equipo de Apache JMeter.<\/P>Ejecutar una prueba a través de una ventana de comandos puede ser un poco old school<\/EM>, pero sigue siendo muy efectivo.<\/P>Verificación de la lista de verificación previa a la prueba<\/H1>Es una buena práctica de prueba utilizar una lista de verificación previa para ayudar a aprovechar al máximo el tiempo de su prueba.<\/P>Los elementos recomendados en la lista incluyen:<\/P>Coordinar la hora de inicio y duración de la prueba de carga con el personal administrativoAsegura un impacto mínimo de la prueba para los usuarios y otros colegas del Sitio ArcGIS Enterprise<\/LI>Ayuda a prevenir system noise<\/EM> de otras actividades y usos que pueden "contaminar" los resultados de la prueba<\/LI><\/UL><\/LI>Al probar un Servicio ArcGIS tradicional (por ejemplo, dedicado), asegúrese de que las instancias mínimas y máximas estén configuradas adecuadamenteEsto es necesario si su objetivo de prueba es tratar de entender el rendimiento máximo alcanzable del servicioPara el rendimiento máximo, una regla general es establecer las instancias máximas al número de núcleos CPU<\/LI>Para un rendimiento predecible, establezca las instancias mínimas al número de instancias máximas<\/LI><\/UL><\/LI>Ajustar las instancias causará que un servicio se reinicie (planifique en consecuencia)Aumentar las instancias mínimas de un servicio requerirá memoria física adicional en la máquina ArcGIS Server<\/LI><\/UL><\/LI><\/UL><\/LI><\/UL><\/span><\/P>Si el Plan de Prueba contiene un Listener como View Results Tree, asegúrese de deshabilitarlo desde la GUIEjecutar Listeners puede aumentar el consumo de recursos del cliente de prueba y potencialmente afectar la prueba<\/LI><\/UL><\/LI><\/UL><\/span><\/P>Validar el Thread Group para lógica de carga escalonada y duración de la pruebaSi la prueba está programada para una ventana específica, asegúrese que la prueba esté configurada para ejecutarse durante el tiempo esperado<\/LI><\/UL><\/LI>Asegurarse que el Nivel de Registro (Log Level) del ArcGIS Server no esté configurado en DEBUG o VERBOSE. Aunque estos niveles pueden ser útiles para solucionar problemas, pueden afectar el rendimiento y escalabilidad del(los) servicio(s) probado(s)<\/LI><\/UL><\/LI><\/UL>Recorrido por el script batch<\/H1>Dado que se utiliza la línea de comandos para ejecutar la prueba de carga Apache JMeter, es ventajoso reunir las acciones y preparación del entorno en un script batch (por ejemplo, archivo *.bat en Windows). Esto favorece la repetibilidad y mantenimiento.<\/P>Variables<\/H2>Usar variables es una forma útil para mejorar el mantenimiento del script. Aunque codificar valores directamente es técnicamente válido, puede dificultar la legibilidad si las rutas para ciertos elementos son muy largas. Las siguientes secciones son los componentes principales donde nuestro batch utilizará variables.<\/P>Memoria<\/H3>Por defecto, Apache JMeter (versión 5.4.1) se ejecuta con un mínimo y máximo de 1GB de memoria. Esto es adecuado para pruebas simples ejecutándose en hardware antiguo, pero algunas pruebas requieren lógica más compleja o múltiples archivos de datos y podría necesitarse más memoria para asegurar que los resultados no se vean afectados.<\/P>Nota: Muchas pruebas de carga se enfocan en la utilización del hardware del servidor. Sin embargo, las capacidades del cliente de prueba también pueden ser un cuello de botella que limita lograr los objetivos.<\/P>Aumentar la memoria por defecto se puede hacer fácilmente con lo siguiente:<\/P>set heap=-Xms4g -Xmx4g -xyz:MaxMetaspaceSize=256m<\/LI><\/UL>Rutas JMeter y Proyecto<\/H3>Queremos indicarle al script batch dónde encontrar Apache JMeter y nuestro Plan de Prueba.<\/P>Configurar la ruta a la carpeta bin de JMeter es sencillo:<\/P>set jmeterbin=C:\apache-jmeter-5.4.1\bin<\/LI><\/UL>Así como también a la carpeta del proyecto (creada manualmente) donde residirá el archivo jmx (por ejemplo, el Plan de Prueba)<\/P>set projectdir=C:\JMeter Tests\sampleworldcities3<\/LI><\/UL>Para mayor extensibilidad, se crea una variable para el nombre del archivo jmx separada del directorio del proyecto (sin extensión jmx e incluso si usan el mismo nombre)<\/P>set testname=sampleworldcities3<\/LI><\/UL>Para mayor comodidad, se crea una variable que se añadirá a cada ejecución. Por múltiples razones, una típica prueba de carga puede ejecutarse varias veces, cada una con una opción ligeramente diferente habilitada dentro del Plan. Esto ayuda a llevar control sobre diferentes ejecuciones.<\/P>set runname=run1<\/LI><\/UL>Ejecución y switches del test<\/H3>Gracias al uso de las variables mencionadas arriba, ejecutar JMeter pasando un Plan como switch en línea comando puede revisarse fácilmente en pocas líneas:<\/P>%jmeterbin%\jmeter -n -f -t "%projectdir%\%testname%.jmx" ^
-l "%projectdir%\results\results_%testname%_%runname%.jtl" ^
-j "%projectdir%\logs\debug_%testname%_%runname%.log" ^
-e -o "%projectdir%\reports\%testname%_%runname%" ^
El switch -n ejecuta JMeter en modo commad-line<\/LI>El switch -t "path_to_jmx" indica a JMeter dónde encontrar el archivo jmx en el sistema.<\/LI>El switch -l "path_to_jtl" indica dónde registrar las muestras; este es el archivo resultados y artefacto más importante.
El switch -j "path_to_log" indica dónde almacenar el log run JMeter (por ejemplo información del entorno). El switch -e indica generar reporte (dashboard) cuando finalice.
El switch -o "path_to_report_folder" indica dónde generar reporte (dashboard).
El switch -f indica forzar eliminación de archivos resultados existentes y carpeta reporte si están presentes antes iniciar test. Cambiar variable "runname" en script es forma más fácil asegurar nuevo archivo resultados e informe con cada ejecución.
El carácter caret o ^ es un carácter "escape" añadido al script batch Windows para que el siguiente carácter (salto línea) sea interpretado como ordinario. Esto ayuda legibilidad.
Uniendo todo junto< /H2 >< P > El script batch completo es como sigue : < / P >< P > < / P >< P > < / P >< P > < / P >< P > < / P >< P > < / P >< pre class = "lia-code-sample language-php" > < code > echo off
rem Ejecución plan test JMeter guionizada
rem Utilizando jmeter.bat para invocación
rem
rem 2021/06/07.1
rem


rem ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
rem *** Variables ***

rem Establecer memoria JMeter min/máx 4GB (ajustar según recursos cliente)
set heap=-Xms4g -Xmx4g -xyz:MaxMetaspaceSize=256m

rem Ubicación %JAVA_HOME%\bin (actualmente no usado)
rem set javadir=C:\jdk-16.0.1\bin

rem Ubicación bin Apache JMeter
set jmeterbin=C:\apache-jmeter-5.4.1\bin

rem Ubicación carpeta raíz Plan Test JMeter (donde reside Plan Test)
set projectdir=C:\JMeter Tests\sampleworldcities3

rem Nombre Plan Test JMeter (sin extensión JMX)
set testname=sampleworldcities3

rem Cadena añadida archivo resultados cada ejecución
set runname=run1
rem ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~





echo on
rem *** Test iniciado ***
%jmeterbin%\jmeter -n -f -t "%projectdir%\%testname%.jmx" ^
-l "%projectdir%\results\results_%testname%_%runname%.jtl" ^
-j "%projectdir%\logs\debug_%testname%_%runname%.log" ^
-e -o "%projectdir%\reports\%testname%_%runname%" ^
rem *** Test completado ***
echo off < / code > < / pre >< P > < / P >< P > < / P >< P > < / P >< P > < / P >< P > < / P >< H1 id = "toc-hId--1217181122" > Ejecutando la prueba carga < / H1 >< P > Para las primeras ejecuciones su prueba, se recomienda ejecutarla  desde ventana comando ya abierta. Así, si hay problemas inmediatos invocando comandos batch script, persistirán en pantalla para corregir más fácilmente (por ejemplo error tipográfico). < / P >< UL >< LI > Desde Windows puede invocar ventana Command Prompt haciendo clic Inicio y escribiendo cmd . < UL class = "lia-list-style-type-circle" > < LI > Cuando aparezca esta ventana ingrese ruta a su script batch : < UL class = "lia-list-style-type-square" > < LI > "C:\JMeter Tests\sampleworldcities3\runMe.bat", presione Enter < UL class = "lia-list-style-type-square" > < LI > El script correrá durante duración configurada luego volverá al prompt comando < / LI > < / UL > < / LI > < / UL > < / LI > < / UL > < / LI > < / UL > < P >< span class = "lia-inline-image-display-wrapper lia-image-align-inline" image-alt = "batfile_execution.png" style = "width: 979px;" >< img src = "https:\/\/us.v-cdn.net\/6038851\/uploads\/images\/15370iC0611A307C75DA4B/batfile_execution.png" role = "button" title = "batfile_execution.png" alt = "batfile_execution.png" \/ >< / span >< / P >< P > Ejecutar desde modo command-line no proporcionar a la consola estadísticas en tiempo real de la ejecución de la prueba. Tal funcionalidad se puede obtener pero no está cubierta en este Artículo.<\/P>Artefactos de Prueba<\/H1>Los artefactos de prueba son elementos creados a partir de la prueba de carga que pueden usarse para análisis. Elementos como el informe y los archivos JMeter Text Logs (JTL) que contienen los resultados crudos de la prueba suelen ser los más importantes para conservar. El registro de ejecución también puede ser útil ya que su listado puede usarse para confirmar la memoria configurada del entorno  para la ejecución de la prueba así como las actualizaciones sobre qué paso se estaba ejecutando y cuándo. Después de múltiples ejecuciones de la misma prueba, donde se usó un nombre de ejecución diferente en el script, es fácil terminar con muchos archivos jtl y carpetas de informes. Aquí es donde seguir la estrategia de pruebas utilizando una carpeta de proyecto para la gestión es clave.<\/P>Nota: El informe generado por JMeter está basado en HTML y JavaScript. Si algunos componentes del informe están en blanco o no parecen renderizarse, intente ajustar la configuración de seguridad del navegador o ábralo en otro navegador, si está disponible.<\/STRONG><\/FONT><\/P>La página inicial  y la sección Tiempos de Respuesta a lo Largo del Tiempo de un informe generado por JMeter<\/FONT><\/LI><\/UL><\/span><\/P><\/span><\/P>Para descargar el Plan de Prueba Apache JMeter usado en este Artículo vea: <\/SPAN>sampleworldcities3.zip<\/A><\/P>

Esta prueba requiere que el plugin Custom Thread Groups esté instalado en JMeter.<\/P>

Preparándose para el Análisis<\/SPAN><\/H1>El informe generado es uno de los mejores lugares para comenzar a realizar análisis con el fin de determinar si se lograron los objetivos de la prueba. <\/SPAN>Dado que este análisis de una prueba de carga puede ser un proceso complejo que vale la pena discutir en detalle, es un procedimiento que merece su propio Artículo.<\/SPAN><\/P>Para un conjunto adicional de tutoriales de pruebas (de complejidad creciente), vea: <\/SPAN>Performance Engineering: Load Testing ArcGIS Enterprise<\/A> <\/SPAN><\/P> <\/P> <\/P>Apache JMeter<\/A> lanzado bajo la Apache<\/A> Licencia 2.0.<\/A> Apache, Apache JMeter, JMeter, la pluma Apache y el logo Apache JMeter son marcas registradas de la Apache Software Foundation.<\/SPAN><\/P>

 <\/P>