Passer au contenu principal
Lier les traces aux logs vous permet de corréler les incidents d’erreur et les traces avec des messages de log, ce qui facilite le débogage des problèmes en visualisant les logs pertinents directement à côté de vos traces. En ajoutant un identifiant à la fois à vos traces et à vos logs, vous pouvez naviguer entre eux dans l’interface AppSignal.

​
Fonctionnement

Pour lier les traces aux logs, vous devez ajouter le même identifiant aux deux, tel que request_id ou trace_id. Cela sera configuré automatiquement dans la plupart des cas, mais lorsque ce n’est pas le cas, assurez-vous que les identifiants suivants sont définis.
  1. Ajoutez un identifiant de requête ou de trace à votre trace en tant que tag AppSignal ou attribut OpenTelemetry.
  2. Ajoutez le même identifiant à vos logs en tant qu’attribut de log.
Lorsqu’AppSignal reçoit des traces et des logs avec des identifiants correspondants, il peut les corréler, vous permettant de visualiser les logs associés lors de l’inspection d’un échantillon de trace.

​
Choisir un identifiant

Vous pouvez utiliser n’importe lequel des identifiants suivants pour lier les traces et les logs :
  • request_id — un identifiant unique pour chaque requête HTTP (courant dans les frameworks web).
  • trace_id — l’ID de trace AppSignal ou OpenTelemetry.
De nombreux frameworks web génèrent automatiquement un request_id pour chaque requête, ce qui en fait un choix pratique. Pour les intégrations basées sur OpenTelemetry, vous pouvez utiliser directement l’ID de trace.

​
Lier les logs de l’application

Rapportez les logs de votre application en configurant la journalisation à l’aide des packages AppSignal ou du SDK OpenTelemetry. La plupart des configurations de framework auront déjà les tags request_id ou trace_id configurés. Si aucun log pertinent n’est détecté, suivez les instructions de configuration de la journalisation pour le framework utilisé par votre application ou rapportez manuellement l’identifiant en tant que tag de trace et attribut de log.

​
Visualiser les logs liés

Une fois que vous avez configuré votre application pour lier les traces aux logs, vous pouvez visualiser les logs associés directement dans l’interface AppSignal :
  1. Accédez à un échantillon de trace de performance ou à un incident d’erreur.
  2. Recherchez le bloc des logs associés, qui renverra vers les messages de log pertinents.
  3. Utilisez les logs pour obtenir un contexte supplémentaire sur ce qui s’est passé pendant la requête.
Cette corrélation rend le débogage plus rapide, car vous pouvez rapidement trouver la trace et les logs pertinents.

​
Étapes suivantes

  • Configurez le rapport de logs pour envoyer les logs de votre application à AppSignal.
  • En savoir plus sur l’ajout de tags à vos traces.