Documenter un incident, c’est garder de quoi le reconnaître s’il revient, et de quoi expliquer au client ce qui a été constaté. Un fil de discussion et des captures dispersées ne se relisent pas. Une fiche courte, commencée pendant la panne, si.
La fiche minimale
Ouvrez-la au moment où quelqu’un confirme le problème sur l’URL publique. Tenez les heures dans un fuseau annoncé (heure de Paris, ou UTC, mais un seul).
| Champ | Exemple de contenu | À éviter |
|---|---|---|
| Début / fin | 2026-03-12 18 h 02 → 18 h 41, heure de Paris | « En début de soirée » |
| Détection | Appel client, sonde, journal | « On a vu » |
| Symptôme | GET /commande en 500, message PHP dans le journal | « Le site était down » |
| Périmètre | Paiement cassé, catalogue en 200 | Une liste d’URL non testées présentées comme cassées |
| Actions | 18 h 10 extension X désactivée, 18 h 22 curl en 200 | Une liste de pistes non tentées |
| Cause | Colonne manquante après mise à jour de l’extension X, une fois le journal relu | Un coupable sans ligne de preuve |
| Contrôle de fin | URL, code, parcours rejoué | « C’est revenu » |
Le symptôme et la cause sont deux lignes. Le 500 est le symptôme. L’exception dans le journal est la piste. Les deux se rejoignent seulement quand l’heure du journal colle à l’heure des requêtes. Savoir où chercher ces lignes : trouver les erreurs 500.
Si des clients attendent des nouvelles, le texte qu’on leur envoie suit la fiche, il ne la remplace pas. Les formulations sont dans que dire pendant une panne.
Ce qu’on colle en preuve
- La sortie
curl -sIde l’URL en cause, pendant la panne si vous l’avez, et après. - L’extrait de journal (une dizaine de lignes), pas le fichier entier.
- La version ou le nom de l’extension déployée juste avant, s’il y a eu un déploiement.
- Le lien vers la page de statut de l’hébergeur ou du paiement, si vous vous en êtes servi. Une erreur d’API de paiement se documente avec l’identifiant de requête du prestataire, pas avec une capture floue du navigateur.
N’y mettez pas de mots de passe, de numéros de carte, ni de dumps clients. Un journal de paiement mal copié contient parfois un jeton : coupez-le avant de coller la fiche dans un outil partagé.
Après le rétablissement
La fiche n’est pas close quand la page répond. Ajoutez le contrôle : quelle URL, quel code, quel parcours (connexion, ajout au panier, ou page de confirmation selon le cas). Si la panne était une maintenance, notez le code prévu. Un 503 de maintenance mal réglé devient un incident SEO en plus d’un incident de disponibilité : la fiche doit dire quel code a réellement été servi.
Une semaine plus tard, trois questions suffisent pour que le document serve :
- Le même déploiement peut-il reproduire le cas ?
- Quelle alerte aurait raccourci les 39 minutes ?
- Quelle sauvegarde ou quelle marche arrière a vraiment été utilisée ? Si aucune restauration n’a été testée depuis des mois, la fiche le dit sans en faire un roman.
Rangez ces fiches au même endroit, avec la date dans le titre. La prochaine personne d’astreinte cherche « 500 commande extension X », pas « compte rendu final v3 ».
Reliez la fiche au déploiement quand il y en a un : hash ou version, heure de mise en ligne, personne qui peut revenir en arrière. Sans ce lien, le journal PHP montre une exception et personne ne sait quel fichier a changé dix minutes plus tôt. Si l’incident n’a pas de déploiement (panne d’hébergeur, certificat, DNS), écrivez « aucun déploiement » pour que la relecture ne parte pas chercher un plugin.
