Cómo ejecutar un nuevo test de carga k6

Ejecutar una Nueva Prueba de Carga k6 en LoadFocus

Abre la página Nueva Prueba k6 (necesitas haber iniciado sesión), sube tu script k6, define la carga y las ubicaciones y haz clic en Ejecutar prueba. LoadFocus ejecuta tu script en la nube con el binario estándar de k6 (v2.3.0).

Dos tipos de script o de destino no funcionan con esta versión de k6. Las extensiones de k6 no son compatibles: un script que importa un módulo k6/x/... falla antes de generar carga. Y un destino HTTPS que todavía usa TLS 1.2 y solo acepta firmas SHA-1 falla en el handshake TLS, así que cada petición a ese destino termina con un error (tls: handshake failure).

Pasos para Configurar una Nueva Prueba de Carga k6

La página tiene tres pasos numerados (1 Su script de prueba, 2 ¿Cuánta carga?, 3 ¿Desde dónde?), una sección Más opciones y una barra abajo con el botón de ejecución.

1. Elige un Nombre de Prueba

Generamos automáticamente un nombre de prueba con la fecha y la hora actuales. Aparece arriba en la página, después de Nueva prueba:. Haz clic en el nombre o en el icono del lápiz para cambiarlo. Puedes renombrar la prueba cuando quieras.

2. Sube tu Script k6

En el paso 1 Su script de prueba, sube tu script de prueba k6 y los archivos de datos que lee. Puedes arrastrar y soltar archivos en el área de subida o hacer clic en Subir scripts y archivos k6. Una prueba puede contener hasta 10 archivos, cada uno de hasta 100 MB. Tipos aceptados:

.js: tu script de prueba k6 (obligatorio)
.ts: un script k6 en TypeScript
.csv, .json, .txt: archivos de datos que tu script lee con open()
.env, .properties: archivos de configuración

Solo se ejecuta un archivo de script por prueba, así que incluye en él los módulos locales (los módulos remotos https:// están bien). Para leer archivos de datos, consulta Subir scripts y archivos de datos de k6. ¿Aún no tienes un script? Debajo del área de subida, Importar desde cURL, HAR, Postman u OpenAPI convierte una petición existente en un script k6 (consulta Importar cURL, HAR, Postman u OpenAPI a una prueba k6), y Descríbala y deje que la IA la escriba abre el generador de pruebas con IA. Consulta Crear una prueba de carga con IA.

Validación del Script k6

LoadFocus comprueba tu script al subirlo:

Debe ser un archivo .js o .ts con un punto de entrada: export default function, o scenarios cuyas entradas nombren su función con exec. Sin él, el script se rechaza.
Las advertencias, que no bloquean la prueba, señalan un script sin imports de k6, sin llamadas a check() o sin bloque options, uno que usa __ENV o uno que importa un archivo local.

La comprobación no ejecuta tu script, así que un error de sintaxis solo aparece cuando se ejecuta la prueba.

Script k6 de Ejemplo

import http from 'k6/http';
import { check, sleep } from 'k6';

export default function () {
    const res = http.get('https://test-api.k6.io/public/crocodiles/');

    check(res, {
        'status is 200': (r) => r.status === 200,
        'response time < 500ms': (r) => r.timings.duration < 500,
    });

    sleep(1);
}

3. Ajustes de Carga Predefinidos

El paso 2 ¿Cuánta carga? empieza con cuatro ajustes predefinidos:

Comprobación rápida: pocos usuarios, para comprobar que funciona.
Típica: tu tráfico habitual.
Pico: tus momentos de más tráfico, para encontrar el límite.
Personalizada: ajusta tus propios valores abajo.

Cada tarjeta muestra los usuarios y el tiempo total de ejecución que fija, dentro de los límites de tu plan. Haz clic en una para rellenar la configuración y ajústala después si quieres.

4. Define la Carga

Debajo de los ajustes predefinidos defines:

Usuarios virtuales: el número de usuarios virtuales concurrentes que se simulan.
Duración (s): cuánto dura la prueba.
Tiempo de Ramp-Up: cuánto tarda en alcanzarse el número total de usuarios virtuales.

Abre Ajuste fino para Pasos de Ramp-Up (el número de pasos con los que se aumenta la carga), para Ejecutar por iteraciones en lugar de por tiempo (un número fijo de iteraciones en lugar de una duración) y para Cambiar unidades de tiempo, que te permite introducir la duración en minutos en lugar de segundos. El gráfico de ramp-up muestra cómo se añaden los usuarios virtuales a lo largo de la prueba, y la línea de debajo resume la ejecución. Los controles deslizantes se detienen en los límites de tu plan. Con iteraciones, el número es el total de toda la prueba, no por usuario: todos los usuarios virtuales arrancan a la vez, el ramp-up no se usa y los usuarios se reparten las iteraciones (la línea dice, por ejemplo, "10 usuarios comparten 50 iteraciones en total y arrancan a la vez.").

En el plan Free, las ejecuciones también tienen límites por día y por sitio web: consulta Límites en el plan Free.

LoadFocus aplica estos valores al ejecutar tu script, así que sustituyen cualquier vus, duration o stages de las options propias del script.

5. Distribución de Carga

En el paso 3 ¿Desde dónde?, elige las ubicaciones cloud desde las que llega la carga (Agregar ubicación añade otra). Cada ubicación recibe un valor de % Tráfico, y LoadFocus calcula su Número de usuarios a partir de tu total. Los porcentajes deben sumar 100%. Por ejemplo:

US East (N. Virginia): 100% (10 usuarios)

Ejecutar una prueba desde varias ubicaciones a la vez requiere un plan Pro o Enterprise; los demás planes usan una ubicación. Consulta la lista de ubicaciones disponibles.

6. Más Opciones

En Más opciones puedes añadir Criterios de éxito/fallo, Ejecutar con programación y Enviar resultados a Datadog, New Relic…, que envía las métricas de la prueba a una herramienta de monitoreo externa: Datadog, New Relic, Dynatrace u OpenTelemetry. Haz clic en Gestionar integraciones para configurar una.

7. Ejecutar la Prueba

Después de configurar tu prueba de carga y subir tu script k6:

Haz clic en Ejecutar prueba en la barra de abajo y confirma en el diálogo ¿Ejecutar esta prueba?. Si falta algo, la barra lo indica después de Aún no se puede ejecutar:.
Haz clic en Guardar borrador para guardar la configuración sin ejecutarla.

LoadFocus inicia las máquinas en la nube, ejecuta tu script y te envía los resultados mientras se ejecuta. Cuando termina, consulta Análisis de resultados de tests de carga k6.

Para iniciar una prueba k6 guardada desde un pipeline de CI/CD con un plan de pago, consulta la API de pruebas de carga.