Une requête qui traverse plusieurs services peut créer des entrées de journal distinctes sans relation évidente. Un identifiant de corrélation fournit une référence partagée pour tracer cette opération sur son chemin.
Créer et propager l'identifiant
- Générez un identifiant au niveau d’une limite de confiance ou validez-en un à partir d’un service en amont.
- Transmettez-le via les requêtes en aval et incluez-le en tant que champ de journal structuré.
- Renvoyez-le à l'appelant lorsque cela est utile afin que le support puisse connecter un rapport aux événements côté serveur.
Gardez les journaux en sécurité et consultables
Utilisez un nom de champ cohérent et évitez d’intégrer l’ID dans un texte de forme libre. N'utilisez pas d'ID de corrélation comme identité d'utilisateur, jeton d'autorisation ou lieu de stockage de données personnelles.
Définissez les contrôles de rétention et d'accès pour le système de journalisation et testez que le même ID de demande apparaît dans les services attendus. Les identifiants aident à localiser les événements ; ils ne remplacent pas les métriques ou les traces distribuées.