Observabilité API : relier les signaux à une décision

Relier les signaux à une tâche utilisateur

Métriques, journaux et traces répondent à des questions différentes. Un taux de disponibilité élevé peut masquer un parcours d’achat ou de connexion en échec. Définissez d’abord le résultat attendu par l’utilisateur, puis instrumentez les appels qui y contribuent.

• Choisir un indicateur par parcours : succès, délai et erreurs visibles par l’utilisateur.
• Propager un identifiant de corrélation entre services et limiter les données sensibles dans les traces.
• Rejouer une panne de dépendance pour vérifier que l’alerte conduit à une action et à un mode dégradé compréhensible.

Référence primaire : OpenTelemetry — Observability primer. Méthode connexe : consulter le guide pratique.

Panne de collecte : rapprocher les journaux et les événements manquants

Distinguer événements produits, reçus et exploitables pour expliquer une interruption sans confondre silence et absence d’incident.

• Cartographiez application, collecteur et stockage avec leurs responsables. Préparez une séquence finie d’événements fictifs portant des identifiants stables, sans secrets ni données clients. Conservez heure de l’événement et heure d’observation : un retard de collecte n’est pas automatiquement une perte.
• En test, interrompez la destination puis rétablissez-la. Observez remplissage de la file, tentatives, rejets et redémarrage. Une file persistante peut limiter certaines pertes mais reste bornée et dépend du stockage ; fixez le comportement si elle est pleine. Vérifiez que la collecte ne bloque pas silencieusement le service.
• Rapprochez la référence et les événements réellement lisibles au même arrêt d’observation. Comptez répétitions, retards et absences séparément ; un acquittement réseau ne prouve pas l’exploitation finale. Sans référence fiable, déclarez la couverture inconnue plutôt que zéro événement perdu ou zéro incident.

{
    "expected_ids": [
        "E1",
        "E2",
        "E3"
    ],
    "received_ids": [
        "E1",
        "E1",
        "E3"
    ],
    "received_rows": 3,
    "unique_received": 2,
    "missing_ids": [
        "E2"
    ],
    "observation_cutoff": "same_for_both_sets"
}

Référence primaire : OpenTelemetry — Collector resiliency. Méthode connexe : consulter le guide pratique.

Sous-domaines abandonnés : retirer un CNAME sans laisser de prise

Relier chaque nom DNS à une ressource contrôlée et intégrer le retrait du DNS à la fermeture d’un service.

• Inventoriez nom public, chaîne CNAME, ressource du fournisseur et responsable. Comparez la zone DNS avec l’inventaire du compte autorisé. Une erreur HTTP, un NXDOMAIN ou une cible absente est un signal à examiner, pas la preuve d’une prise de contrôle possible ; les protections dépendent du fournisseur.
• Pour un service à fermer, retirez le pointage ou remplacez-le par une destination que vous contrôlez avant de libérer la ressource. Tenez compte des TTL antérieurs et des caches ; vérifiez la zone autoritative et plusieurs résolveurs. Conservez les validations de propriété nécessaires au fournisseur plutôt que de supprimer indistinctement les TXT.
• Vérifiez liens, redirections, rappels OAuth, webhooks et domaines de cookies qui utilisent encore ce nom. Si la cible a déjà été libérée, corrigez le pointage et examinez une éventuelle exposition selon la procédure d’incident. Ajoutez un contrôle de rapprochement DNS–ressources après chaque suppression.

{
    "name": "portal.example",
    "cname_present": true,
    "resource_deleted": true,
    "provider_claimability": "not_verified",
    "takeover_observed": false,
    "expected": "remove_or_replace_mapping_and_review_exposure"
}

Référence primaire : Microsoft — Prevent dangling DNS entries. Méthode connexe : consulter le guide pratique.

Reprises API : compter le budget de bout en bout

Dans la supervision, séparez durée d’un appel, attentes de reprise et durée totale vécue par le client. Un appel moyen rapide peut coexister avec un parcours lent si les erreurs déclenchent des attentes successives.

Méthode connexe : consulter le guide pratique.