Skip to content
Monitoring Stack

Test local

Oui, tu peux tester la stack localement.

Utilise compose.local.yml pour le test de dev. Le compose.yml principal est pense pour une VM Linux de production et monte des chemins comme /proc, /sys, /var/lib/docker pour node-exporter et cAdvisor. Ces montages ne sont pas fiables depuis Windows/Docker Desktop.

Ce que le test local lance

Section titled “Ce que le test local lance”
  • VictoriaMetrics
  • Loki
  • Tempo
  • OpenTelemetry Collector central
  • Grafana
  • Documentation Starlight

Il ne lance pas:

  • Caddy et HTTPS automatique
  • node-exporter
  • cAdvisor
  • Diun

Demarrage

Section titled “Demarrage”

Depuis la racine du repo:

Terminal window
docker compose -f compose.local.yml up -d

Grafana sera disponible ici:

http://localhost:3000

La documentation Starlight sera disponible ici:

http://localhost:4321

Identifiants Grafana par defaut du mode local:

admin / admin

Tu peux changer le mot de passe pour la session:

Terminal window
$env:GF_ADMIN_PASSWORD="un-mot-de-passe-local"
docker compose -f compose.local.yml up -d

Verifications rapides

Section titled “Verifications rapides”
Terminal window
docker compose -f compose.local.yml ps
docker compose -f compose.local.yml logs --tail=100 grafana
docker compose -f compose.local.yml logs --tail=100 otel-collector
docker compose -f compose.local.yml logs --tail=100 docs

Dans Grafana, les datasources sont provisionnees automatiquement:

  • VictoriaMetrics
  • Loki
  • Tempo

Envoyer de la telemetrie locale

Section titled “Envoyer de la telemetrie locale”

Les ports OTLP sont exposes uniquement sur localhost:

OTLP gRPC: 127.0.0.1:4317
OTLP HTTP: http://127.0.0.1:4318

Pour une app locale instrumentee OpenTelemetry:

Terminal window
$env:OTEL_EXPORTER_OTLP_ENDPOINT="http://127.0.0.1:4318"
$env:OTEL_SERVICE_NAME="local-test-app"
$env:OTEL_RESOURCE_ATTRIBUTES="deployment.environment=local"

Arret

Section titled “Arret”
Terminal window
docker compose -f compose.local.yml down

Pour supprimer aussi les volumes locaux:

Terminal window
docker compose -f compose.local.yml down -v

Limites du test local

Section titled “Limites du test local”

Le test local prouve que Grafana, VictoriaMetrics, Loki, Tempo, le collector et la documentation se lancent. Il ne valide pas:

  • le firewall Scaleway,
  • Caddy et Let’s Encrypt,
  • les metriques hote reelles via node-exporter,
  • les metriques containers via cAdvisor,
  • les buckets Object Storage,
  • les DNS publics.

Ces points se valident sur la VM Scaleway.