[Article] Observing a k6 test

1. Pourquoi exporter ? #

Le résumé ne suffit pas.

Voir dans le temps #

Observer un test de charge — Les courbes de k6 et du système testé sur un même dashboard.

Le résumé de fin de test donne des moyennes et des percentiles globaux. Pour comprendre à quel moment la latence décroche et pourquoi, il faut voir les métriques de k6 dans le temps, à côté du CPU, des connexions à la base et des traces du système testé.

2. Vers Prometheus #

La sortie remote write.

Configuration #

# Prometheus doit accepter le remote write
prometheus --config.file=prometheus.yml --web.enable-remote-write-receiver

K6_PROMETHEUS_RW_SERVER_URL=http://localhost:9090/api/v1/write \
K6_PROMETHEUS_RW_TREND_STATS="p(95),p(99),avg,max" \
k6 run -o experimental-prometheus-rw --tag testid=release-2.4 script.js

Métrique Prometheus	Origine
`k6_http_reqs_total`	Compteur http_reqs
`k6_http_req_duration_p95`	Statistique demandée dans TREND_STATS
`k6_http_req_failed_rate`	Taux d'échec
`k6_vus`	Utilisateurs virtuels

Bonne Pratique : Avec K6_PROMETHEUS_RW_TREND_AS_NATIVE_HISTOGRAM=true, les durées sont envoyées en histogrammes natifs : n'importe quel percentile se calcule ensuite dans Grafana.

À savoir : Le tag testid distingue les exécutions : il permet de comparer deux tests dans le même dashboard. Grafana publie un dashboard officiel « k6 Prometheus » à importer.

En OpenTelemetry #

k6 dispose aussi d'une sortie OpenTelemetry (-o opentelemetry) qui envoie ses métriques en OTLP à un Collector ou à Alloy, pratique si votre pile est déjà OTLP.

3. Corréler avec le système testé #

Expliquer les résultats.

Méthode #

Marquer le test : tag testid et annotation Grafana au début et à la fin.
Afficher sur le même dashboard : débit et latence k6, saturation du service (CPU, mémoire, pool de connexions), erreurs.
Repérer le moment où la latence décroche et chercher la ressource saturée à cet instant (méthode USE).
Ouvrir des traces lentes de cette période (exemplars) et le profil CPU du service (Pyroscope).

import http from 'k6/http';
// Propager un en-tête de trace pour retrouver les requêtes du test dans Tempo
export default function () {
  http.get('http://api/produits', { headers: { 'X-Test-Id': __ENV.TEST_ID } });
}