Zum Hauptinhalt springen
Das Verknüpfen von Traces mit Logs ermöglicht es Ihnen, Fehlervorfälle und Traces mit Log-Nachrichten zu korrelieren, was das Debuggen von Problemen erleichtert, indem relevante Logs direkt neben Ihren Traces angezeigt werden. Durch das Hinzufügen einer Kennung zu sowohl Ihren Traces als auch Logs können Sie in der AppSignal-Oberfläche zwischen ihnen navigieren.

​
Wie es funktioniert

Um Traces mit Logs zu verknüpfen, müssen Sie beiden dieselbe Kennung hinzufügen, wie z. B. request_id oder trace_id. Dies wird in den meisten Fällen automatisch eingerichtet, aber wenn nicht, stellen Sie sicher, dass die folgenden Kennungen gesetzt sind.
  1. Fügen Sie Ihrem Trace eine Request- oder Trace-Kennung als AppSignal-Tag oder OpenTelemetry-Attribut hinzu.
  2. Fügen Sie Ihren Logs dieselbe Kennung als Log-Attribut hinzu.
Wenn AppSignal Traces und Logs mit übereinstimmenden Kennungen empfängt, kann es sie korrelieren, sodass Sie verwandte Logs anzeigen können, wenn Sie ein Trace-Sample inspizieren.

​
Wahl einer Kennung

Sie können eine der folgenden Kennungen verwenden, um Traces und Logs zu verknüpfen:
  • request_id - Eine eindeutige Kennung für jede HTTP-Anfrage (üblich in Web-Frameworks).
  • trace_id - Die AppSignal- oder OpenTelemetry-Trace-ID.
Viele Web-Frameworks generieren automatisch eine request_id für jede Anfrage, was sie zu einer praktischen Wahl macht. Für OpenTelemetry-basierte Integrationen können Sie die Trace-ID direkt verwenden.

​
Anwendungs-Logs verknüpfen

Melden Sie Logs aus Ihrer Anwendung, indem Sie Logging einrichten mit den AppSignal-Paketen oder dem OpenTelemetry-SDK. Die meisten Framework-Konfigurationen haben bereits request_id- oder trace_id-Tags eingerichtet. Wenn keine relevanten Logs erkannt werden, folgen Sie den Logging-Einrichtungsanweisungen für das Framework, das Ihre Anwendung verwendet, oder melden Sie die Kennung manuell als Trace-Tag und Log-Attribut.

​
Verknüpfte Logs anzeigen

Sobald Sie Ihre Anwendung konfiguriert haben, um Traces mit Logs zu verknüpfen, können Sie verwandte Logs direkt in der AppSignal-Oberfläche anzeigen:
  1. Navigieren Sie zu einem Performance-Trace-Sample oder Fehlervorfall.
  2. Suchen Sie nach dem Block mit verwandten Logs, der auf die relevanten Log-Nachrichten verweist.
  3. Verwenden Sie die Logs, um zusätzlichen Kontext darüber zu erhalten, was während der Anfrage passiert ist.
Diese Korrelation macht das Debuggen schneller, da Sie schnell den relevanten Trace und die Logs finden können.

​
Nächste Schritte