Supervision

Les commandes de ce chapitre se lancent sur le serveur, dans le dossier du code :

cd /opt/read/code

État des conteneurs#

docker compose ps -a

Exemple de résultat attendu :

NAME                          SERVICE      STATUS
read-plateforme-app-1         app          Up 2 days (healthy)
read-plateforme-caddy-1       caddy        Up 2 days
read-plateforme-db-1          db           Up 2 days (healthy)
read-plateforme-migrations-1  migrations   Exited (0) 2 days ago

• app est contrôlé toutes les 15 secondes par Docker : il interroge /health, qui vérifie aussi l'accès à la base. Après 5 échecs, il passe « unhealthy ».
• db est contrôlé par pg_isready.
• migrations doit être arrêté avec le code 0 : un autre code signale un échec de migration (Dépannage).
• app, db et caddy redémarrent seuls après un arrêt inattendu ou un redémarrage du serveur (restart: unless-stopped).

Journaux#

Lire les fichiers quotidiens de l'application :

docker run --rm -v read-plateforme_app-logs:/logs:ro alpine:3.24 sh -c 'ls -l /logs && tail -n 50 /logs/$(ls /logs | tail -n 1)'

Chaque requête est journalisée sur une ligne (méthode, adresse, code de réponse, durée). Les niveaux WRN et ERR méritent attention, notamment :

• Échec de la tâche quotidienne : une tâche de conservation n'a pas abouti ;
• Aucun administrateur : renseigner ADMIN_EMAIL et ADMIN_MOT_DE_PASSE : base sans administrateur ;
• les erreurs d'envoi SMTP.

Le journal d'audit (actions des utilisateurs) se consulte dans la plateforme, écran Journal d'audit de l'administrateur ; il n'est pas dans les journaux techniques.

Place disque#

df -h /
sudo du -sh /var/backups/read
docker system df

Les sauvegardes locales sont le premier poste de consommation (30 copies complètes de la base et des fichiers déposés). Les images Docker inutilisées laissées par les déploiements successifs s'accumulent aussi ; supprimez-les de temps en temps :

docker image prune -f

Sauvegardes#

Chaque jour ouvré, vérifiez que la sauvegarde de la nuit s'est terminée et que la copie hors serveur est partie :

sudo journalctl -u read-sauvegarde.service --since yesterday | tail -n 5
ls /var/backups/read | tail -n 3

Alertes conseillées#

La plateforme n'envoie pas elle-même d'alertes techniques. Mettez en place au minimum :

Statistiques d'utilisation#

L'administrateur dispose dans la plateforme d'un écran Statistiques d'utilisation (organisations actives, connexions par semaine, rapports transmis à temps, téléchargements). Il renseigne sur l'usage, pas sur la santé technique.