Retour au blog Bonnes Pratiques - 6 min

Documenter un incident de site web

Tenir la fiche d’un incident web : horodatage, impact constaté, actions, cause une fois connue, et contrôle fait après le rétablissement.

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).

ChampExemple de contenuÀ éviter
Début / fin2026-03-12 18 h 02 → 18 h 41, heure de Paris« En début de soirée »
DétectionAppel client, sonde, journal« On a vu »
SymptômeGET /commande en 500, message PHP dans le journal« Le site était down »
PérimètrePaiement cassé, catalogue en 200Une liste d’URL non testées présentées comme cassées
Actions18 h 10 extension X désactivée, 18 h 22 curl en 200Une liste de pistes non tentées
CauseColonne manquante après mise à jour de l’extension X, une fois le journal reluUn coupable sans ligne de preuve
Contrôle de finURL, 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 -sI de 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 :

  1. Le même déploiement peut-il reproduire le cas ?
  2. Quelle alerte aurait raccourci les 39 minutes ?
  3. 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.

Questions fréquentes

Quand ouvrir la fiche d’incident ?

Dès que l’incident est confirmé, pas le lendemain. Les heures et les essais se perdent. Une fiche incomplète mise à jour en direct vaut mieux qu’un récit rédigé de mémoire.

Faut-il nommer un responsable dans le document ?

On note qui a fait quelle action, pour pouvoir le recontacter. On ne rédige pas un document de faute. La cause technique et la décision à changer suffisent.

Que faire si la cause reste inconnue ?

On l’écrit. « Cause non établie, symptôme : 504 sur /panier entre 18 h 02 et 18 h 19, plus reproduit après redémarrage de PHP-FPM » est un fait. Inventer une cause empêche de la retrouver la prochaine fois.

Surveiller mes URL