k6 : les tests de charge dans Alloy

1. Pourquoi passer par Alloy #

Résultats et métriques au même endroit.

Le principe #

k6 affiche un résumé en fin de test, mais pendant un test de charge on veut voir en temps réel la latence côté client et la saturation des services. En envoyant les métriques de k6 à Alloy, elles rejoignent Mimir à côté des métriques de production : un seul tableau de bord pour les deux.

2. Configuration et lancement #

Alloy puis k6.

config.alloy #

otelcol.receiver.otlp "k6" {
  grpc {
    endpoint = "0.0.0.0:4317"
  }
  output {
    metrics = [otelcol.processor.batch.k6.input]
  }
}

otelcol.processor.batch "k6" {
  output {
    metrics = [otelcol.exporter.prometheus.mimir.input]
  }
}

otelcol.exporter.prometheus "mimir" {
  forward_to = [prometheus.remote_write.mimir.receiver]
}

prometheus.remote_write "mimir" {
  endpoint {
    url = "http://mimir:9009/api/v1/push"
  }
}

Configuration validée avec alloy validate (Alloy v1.21.3, novembre 2026).

Lancer le test #

import http from 'k6/http';
import { check, sleep } from 'k6';
export const options = { vus: 5, duration: '15s', thresholds: { http_req_duration: ['p(95)<500'] } };
export default function () {
  const res = http.get('http://127.0.0.1:8099/');
  check(res, { 'statut 200': (r) => r.status === 200 });
  sleep(0.5);
}

K6_OTEL_GRPC_EXPORTER_INSECURE=true K6_OTEL_METRIC_PREFIX=k6_ \
  k6 run --tag testid=checkout-001 -o opentelemetry load.js

3. Ce que reçoit Alloy : un test réel #

Les séries produites.

Les métriques #

Avec otelcol.exporter.debug, Alloy a affiché toutes les 5 secondes 16 métriques envoyées par k6 v2.3.0 (extrait) :

ResourceMetrics service.name=k6 service.version=2.3.0
k6_http_reqs{method=GET,scenario=default,status=200,testid=checkout-001,url=http://127.0.0.1:8099/} 90
k6_http_req_duration{…,testid=checkout-001} count=90 sum=467.6 min=0.446 max=21.05 le5=52 le10=27 le25=11

Les durées sont en millisecondes et arrivent en histogrammes. Le tag testid passé en ligne de commande se retrouve sur chaque série : il permet de comparer deux exécutions. En fin de test, k6 a affiché 150 requêtes, 0 % d'échec et un p95 de 12,38 ms.

Cardinalité. Les labels url et name créent une série par URL : regroupez les URL dynamiques avec le paramètre name de http.get (par exemple /produit/{id}).

Sources #

• k6 : sortie OpenTelemetry
• Grafana Alloy : otelcol.receiver.otlp