Fiche mémo Supervision et journaux

Les quatre notions

Notion	Répond à	Exemple fictif
Métrique	combien, depuis quand	42 requêtes/s
Journal	que s'est-il passé	`ERROR connexion refusée`
Trace	où passe le temps	requête sur trois services
Alerte	qui agit maintenant	erreurs élevées depuis 10 min

Métriques et alertes détectent ; journaux et traces expliquent.

Alerte utile : cinq questions

Quel symptôme (pas la cause) ?
Quel seuil, sur quelle durée ?
Qui, par quel canal, quelle urgence ?
Quelle action (lien vers la procédure) ?
Quand elle s'éteint ?

Bruit d'alerte : supprimer les alertes sans action, allonger la durée, regrouper les doublons, séparer page (urgent) et ticket (en journée). Pas de seuil copié : le régler sur sa propre charge. Compléter par une surveillance externe.

Journaux macOS (lecture seule)

Terminal

log show --last 10m --style compactlog show --last 1h --predicate 'process == "Finder"' --style compactlog show --last 1h --predicate 'messageType == error' --style compactlog stream --predicate 'process == "Finder"' --style compact

Contexte : Terminal macOS, version non confirmée.
Droits : utilisateur ; certaines entrées demandent plus (non vérifié).
Effet : lecture seule ; stream s'arrête avec Control-C.
Vérification : période et processus conformes à la demande.
Retour arrière : sans objet.

Option	Rôle
`--last 10m`	période (`s`, `m`, `h`, `d`)
`--predicate`	filtre (`subsystem`, `category`, `process`, `messageType`)
`--style`	`default`, `compact`, `json`, `ndjson`, `syslog`
`--info`, `--debug`	niveaux plus détaillés, plus volumineux

Attention : log erase (supprime des journaux) et log config (change la journalisation) modifient le système, droits root ; log collect écrit une archive. Hors fiche : lire man log.

Syslog (RFC 5424)

Message : PRI, VERSION, TIMESTAMP, HOSTNAME, APP-NAME, PROCID, MSGID, données structurées facultatives, message.
PRI = facilité × 8 + gravité. Facilités 0 à 23 ; gravités 0 (urgence) à 7 (débogage).
Transport TLS exigé, UDP recommandé, pas de garantie de livraison.

Rotation, rétention, centralisation

Rotation : fermer, compresser, supprimer les anciens (outils macOS non vérifiés).
Rétention : durée à décider selon le besoin.
Centralisation : recherche globale, preuve préservée ; point central critique, transport à chiffrer, accès limité.
Horloges synchronisées (à confirmer). Ne jamais effacer un journal pendant un incident : copier d'abord.

SLI, SLO, budget d'erreur (Google SRE Book)

Terme	Sens
SLI	mesure quantitative d'un aspect du service
SLO	cible pour un SLI
SLA	contrat avec conséquences
Budget	échecs acceptables = 100 % − SLO

Exemple fictif : SLO 99,5 % sur 30 jours, 1 000 000 de requêtes = 5 000 échecs permis. Préférer les percentiles aux moyennes.

Points non vérifiés

Version de macOS ; syntaxe fine des prédicats ; syslog réseau et rotation sous macOS ; rétention ; rôle de NTP ; alertes sur budget d'erreur ; versions de Prometheus et d'OpenTelemetry.

Sources

Consultées le 17 octobre 2026.