Tu primera prueba con k6

Por qué k6

Hay muchas herramientas (JMeter, Gatling, Locust). Usamos k6 porque los scripts son JavaScript —el mismo lenguaje de Playwright y Cypress—, es gratis, corre desde la terminal y se integra fácil en CI. Instalarlo es un comando y no necesitas interfaz gráfica.

Anatomía de un script

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

export const options = {
  stages: [
    { duration: '30s', target: 50 },  // ramp-up: 0 → 50 usuarios
    { duration: '1m',  target: 50 },  // meseta: 50 usuarios
    { duration: '20s', target: 0 },   // ramp-down: 50 → 0
  ],
  thresholds: {
    http_req_duration: ['p(95)<500'],  // criterio: p95 bajo 500 ms
    http_req_failed:   ['rate<0.01'],  // menos de 1% de errores
  },
};

export default function () {
  const res = http.get('https://test-api.k6.io/public/crocodiles/');
  check(res, {
    'status es 200': (r) => r.status === 200,
    'responde rápido': (r) => r.timings.duration < 500,
  });
  sleep(1);  // pausa entre iteraciones, simula un usuario real
}

Las tres piezas clave

• options.stages define el perfil de carga: cuántos usuarios virtuales (VUs) y por cuánto tiempo. Cada VU ejecuta la función default en bucle.
• check valida cada respuesta individual (¿status 200? ¿trae los datos?). Un check que falla no detiene la prueba, pero queda registrado.
• thresholds son tus criterios de aceptación en código: si el p95 supera 500 ms o los errores pasan del 1%, k6 falla la prueba (exit code ≠ 0).

Ejecutar y leer

k6 run script.js

Al terminar, k6 imprime un resumen: iteraciones, VUs, y para cada métrica el promedio, mínimo, máximo y percentiles. Busca http_req_duration ... p(95)=... y compáralo con tu threshold. Si algún threshold no se cumple, aparece en rojo y el exit code es ≠ 0 — la señal para bloquear en CI.

Ya sabes ejecutar una prueba. La próxima lección es lo difícil y valioso: interpretar el resultado y encontrar el cuello de botella.

Comprueba lo aprendido en el quiz y escribe tu script en el reto.