Task: Centralisation Logs Loki + Archivage O2switch

Date: 15-01-2026 Status: TERMINE Duree: ~2h

Contexte

Grafana ne voyait que 3 sources de logs (containers Docker prod-portainer uniquement). Objectif : centraliser TOUS les logs vers Loki et archiver sur O2switch.

Actions réalisées

1. Audit état actuel

Promtail existait sur PVE et nginx mais logs non reçus
Promtail absent sur gitlab et dev-portainer
Containers Docker sans labels (container, stack)

2. Correction Promtail PVE/nginx

Vérification config : OK
Test push log : logs arrivent dans Loki

3. Installation Promtail sur gitlab et dev-portainer

Script créé : /stock_8to/33800-stack/scripts/logs/install-promtail.sh
Promtail installé et configuré (syslog, auth, journal + logs spécifiques)

4. Upgrade Loki/Promtail 2.9 → 3.0

Docker API version incompatible avec Promtail 2.9
Config Loki mise à jour (allow_structured_metadata: false)
Containers recreated

5. Enrichissement Promtail prod-portainer

Docker service discovery activé
Labels automatiques : container, stack, service, env, host, type
29 containers détectés et loggés

6. Script archivage O2switch

Script créé : /stock_8to/33800-stack/scripts/logs/sync-logs-o2switch.sh
Cron : 3h quotidien
Rétention : 90 jours sur O2switch

7. Documentation

CLAUDE.md : Section Logging Centralisé complète
CLAUDE.md : Symlinks docs/ et scripts/ ajoutés
STATUS.md : Actions documentées

Fichiers créés/modifiés

Fichier	Action
/stock_8to/33800-stack/scripts/logs/install-promtail.sh	Créé
/stock_8to/33800-stack/scripts/logs/sync-logs-o2switch.sh	Créé
/etc/cron.d/sync-logs-o2switch	Créé
/stock_8to/33800-stack/docker/stacks/monitoring/docker-compose.yml	Modifié (Loki/Promtail 3.0)
/stock_8to/33800-stack/docker/stacks/monitoring/promtail-config.yml	Modifié (Docker SD)
/stock_8to/33800-stack/docker/stacks/monitoring/loki-config.yml	Modifié (3.0 compat)
/etc/promtail/config.yml (gitlab)	Créé
/etc/promtail/config.yml (dev-portainer)	Créé
~/.claude/CLAUDE.md	Modifié (section Logging + symlinks)

Résultat

Métrique	Avant	Après
Hosts dans Loki	1	5
Containers détectés	~3	29
Labels standardisés	Non	Oui
Archivage O2switch	Non	Oui (cron 3h)

Labels Loki (convention)

env: prod | dev
host: pve | nginx | gitlab | prod-portainer | dev-portainer
type: system | app | cron | access | error
service: docker | nginx | gitlab | ...
container: ntfy | loki | grafana | ...
stack: monitoring | notifications | ...

Commandes utiles

# Vérifier hosts dans Loki
curl -s "http://192.168.1.12:3100/loki/api/v1/label/host/values" | jq

# Vérifier containers
curl -s "http://192.168.1.12:3100/loki/api/v1/label/container/values" | jq

# Installer Promtail sur nouvelle machine
scp /stock_8to/33800-stack/scripts/logs/install-promtail.sh user@machine:/tmp/
ssh user@machine "sudo /tmp/install-promtail.sh <hostname>"