Aller au contenu

Pedago Watch — Erreurs courantes

Loki permission denied sur WAL

Symptôme : Loki ne démarre pas, logs affichent permission denied sur le répertoire WAL

Cause : Le conteneur Loki tourne avec un utilisateur qui n'a pas les droits sur le volume.

Solution : Dans le docker-compose.yml, ajouter user: "0" au service Loki :

services:
  loki:
    image: grafana/loki:2.9.0
    user: "0"
    # ...

Puis redémarrer :

cd /root/projects/pedago-tools-monitoring
docker compose up -d loki

Grafana ne démarre pas

Symptôme : docker compose ps montre Grafana en "Restarting"

Causes possibles :

  1. Port 6050 déjà utilisé par un autre service
  2. Volume corrompu

Solution :

# Vérifier le port
lsof -i :6050

# Voir les logs
docker compose logs grafana --tail 50

# Si volume corrompu (attention : perte des dashboards manuels)
docker compose down
docker volume rm pedago-tools-monitoring_grafana-data
docker compose up -d

Promtail ne collecte pas les logs

Symptôme : Aucun log visible dans Grafana > Explore > Loki

Causes possibles :

  1. Promtail n'a pas accès au Docker socket
  2. Loki n'est pas accessible

Diagnostic :

cd /root/projects/pedago-tools-monitoring

# Vérifier que Promtail tourne
docker compose logs promtail --tail 20

# Vérifier que Loki est accessible
curl -s http://127.0.0.1:6100/ready

Uptime Kuma inaccessible

Symptôme : L'interface Uptime Kuma ne répond pas

Solution :

cd /root/projects/pedago-tools-monitoring

# Vérifier le conteneur
docker compose ps uptime-kuma

# Redémarrer
docker compose restart uptime-kuma

# Vérifier
curl -s http://127.0.0.1:6001

Port conflict avec d'autres services

Symptôme : docker compose up échoue avec port is already allocated

Cause : Un autre service utilise déjà le port.

Diagnostic :

# Voir tous les ports utilisés
docker ps --format "table {{.Names}}\t{{.Ports}}"

# Vérifier un port spécifique
lsof -i :6001
lsof -i :6050
lsof -i :6100

Ports réservés Pedago Watch : Uptime Kuma 6001, Grafana 6050, Loki 6100

Pipeline CI/CD échoue

SCP échoue

  • Vérifier les secrets : gh secret list --repo EpitechAfrik/pedago-tools-monitoring
  • Vérifier que SERVER_SSH_KEY est la clé privée complète

Services pas running après deploy

  • Vérifier le GRAFANA_ADMIN_PASSWORD : gh secret list --repo EpitechAfrik/pedago-tools-monitoring
  • Vérifier les logs : docker compose logs --tail 20