Aller au contenu

Modélisation et Résultats - Module 8 : Résultats et Grafana

Modélisation et Résultats

Module 8 : Résultats et Grafana


8.1 Formats de Sortie

Export JSON

k6 run --out json=results.json script.js

Liste des outputs disponibles

  • Amazon CloudWatch
  • Grafana Cloud k6
  • CSV
  • Datadog
  • Dynatrace
  • Elasticsearch
  • Grafana Cloud Prometheus
  • InfluxDB
  • Netdata
  • New Relic
  • OpenTelemetry
  • Prometheus
  • TimescaleDB
  • StatsD

8.2 Installation de Prometheus & Grafana

Mettre en place Grafana & Prometheus

Installation avec Docker Compose
Créer docker-compose.yml :

services:
  prometheus:
    image: prom/prometheus:v3.15.0
    ports:
      - "9090:9090"
    volumes:
      - ./config/prometheus.yml:/etc/prometheus/prometheus.yml
      - prometheus_data:/prometheus
    command:
      - '--config.file=/etc/prometheus/prometheus.yml'
      - '--storage.tsdb.path=/prometheus'
      - '--storage.tsdb.retention.time=168h'  # Conserve 7 jours
      - '--web.enable-remote-write-receiver' # Obligatoire pour recevoir le remote write de k6
  grafana:
    image: grafana/grafana:13.2.4
    ports:
      - "3000:3000"
    environment:
      - GF_SECURITY_ADMIN_PASSWORD=admin
      - GF_SECURITY_ADMIN_USER=admin
    volumes:
      - grafana_data:/var/lib/grafana
      - ./config/grafana:/etc/grafana/provisioning  
    depends_on:
      - prometheus

volumes:
  prometheus_data:
  grafana_data:

Lancer

docker compose up -d


8.2 Configuration de Prometheus & Grafana

Configuration de la datasource Prometheus dans Grafana
Faisons le via le docker compose :

apiVersion: 1
datasources:
  - name: k6
    type: prometheus
    url: http://prometheus:9090
    access: proxy
    isDefault: true
    basicAuth: true
    basicAuthUser: admin
    secureJsonData:
      basicAuthPassword: admin
N'oubliez pas de l'importer via la prop volumes

Import du dashboard k6

  1. Dashboards > Import
  2. Choisissez un dashboard compatible (ex : ID 19665, « k6 Prometheus »)
  3. Sélectionner la datasource Prometheus

8.2 Installation et Configuration Grafana

Lancer un test avec export Prometheus

K6_PROMETHEUS_RW_SERVER_URL=http://localhost:9090/api/v1/write \
  K6_PROMETHEUS_RW_USERNAME=admin \
  K6_PROMETHEUS_RW_PASSWORD=admin \
  K6_PROMETHEUS_RW_TREND_STATS="p(95),p(99),min,max" \
  k6 run --out experimental-prometheus-rw load.js


8.2 Grafana - Metrics

Metrics built-in

k6 Prometheus Name label
Counter Counter k6_*_total
Gauge Gauge k6_*_
Rate Gauge k6_*_rate
Trend Counter and Gauges (default) or Native Histogram k6_*_

8.2 Installation et Configuration Grafana

Exercice pratique

Objectif : Visualiser un test en temps réel

  • Lancer un test de 5 minutes avec rampe
  • Observer en temps réel dans Grafana
  • Identifier les métriques clés
  • Créer des annotations pour marquer des événements

8.3 Génération et Analyse de Rapports

Rapport HTML avec k6-reporter

Script avec summary :

import http from 'k6/http';
import { htmlReport } from "https://raw.githubusercontent.com/benc-uk/k6-reporter/main/dist/bundle.js";

export default function () {
  http.get('https://example.com');
}

export function handleSummary(data) {
  return {
    "summary.html": htmlReport(data),
    "summary.json": JSON.stringify(data),
  };
}

k6-html-reporter


8.3 Génération et Analyse de Rapports

Custom Summary - STDOUT

import { htmlReport } from 'https://raw.githubusercontent.com/benc-uk/k6-reporter/main/dist/bundle.js'
import { textSummary } from 'https://jslib.k6.io/k6-summary/0.1.0/index.js'

export function handleSummary(data) {

  return {
    'stdout': textSummary(data, { indent: ' ', enableColors: true }),
  };
}

8.3 Génération et Analyse de Rapports

Exercice pratique

Objectif : Analyser un rapport de test

  • Exécuter un test de stress complet
  • Générer un rapport HTML
  • Identifier dans le rapport :
  • Le point de rupture
  • Les métriques qui se dégradent en premier
  • Le comportement des erreurs
  • Les recommandations d'optimisation

8.4 Utilisation d'extension - xk6

k6 est écrit en Go, mais il ne charge pas dynamiquement des plugins
xk6 est un outil qui permet de compiler k6 avec des extensions personnalisées

Pourquoi ?
Donc pour ajouter une fonctionnalité (ex. Kafka, Redis, gRPC avancé, WebSocket custom…), il faut :

  1. écrire l’extension en Go
  2. créer un binaire k6 custom
  3. utiliser xk6 pour assembler tout ça
  4. exécuter ensuite vos scripts k6 avec le nouveau binaire généré

Depuis k6 v1.2, la résolution automatique des extensions évite ce build pour les extensions du catalogue k6 : un simple import ... from 'k6/x/...' suffit avec k6 run


8.4 Utilisation d'extension - Ex. web dashboard (ex-xk6-dashboard)

Le web dashboard affiche un dashboard HTML en direct pendant le test, sans avoir besoin de Prometheus/Grafana : d'abord extension xk6-dashboard, il est intégré à k6 depuis la v0.49, plus besoin de compiler un binaire

# Lancer
K6_WEB_DASHBOARD=true k6 run script.js

# Ouvrir sur http://localhost:5665 par défaut

# Exporter un rapport HTML à la fin du test
K6_WEB_DASHBOARD=true K6_WEB_DASHBOARD_EXPORT=report.html k6 run script.js

8.4 Utilisation d'extension - Ex. web dashboard (ex-xk6-dashboard)

xk6-web-dashboard-plugin