Naar hoofdinhoud gaan
Door traces te koppelen aan logs kunt u foutincidenten en traces correleren met logberichten, waardoor het eenvoudiger wordt om problemen te debuggen door relevante logs direct naast uw traces te bekijken. Door dezelfde identifier toe te voegen aan zowel uw traces als logs, kunt u in de AppSignal-interface tussen beide navigeren.

​
Hoe het werkt

Om traces aan logs te koppelen, moet u dezelfde identifier aan beide toevoegen, zoals request_id of trace_id. Dit wordt in de meeste gevallen automatisch ingesteld, maar wanneer dat niet zo is, zorg ervoor dat de volgende identifiers worden ingesteld.
  1. Voeg een request- of trace-identifier toe aan uw trace als een AppSignal-tag of OpenTelemetry-attribuut.
  2. Voeg dezelfde identifier toe aan uw logs als een log-attribuut.
Wanneer AppSignal traces en logs met overeenkomende identifiers ontvangt, kan het deze correleren, zodat u gerelateerde logs kunt bekijken bij het inspecteren van een trace-sample.

​
Een identifier kiezen

U kunt een van de volgende identifiers gebruiken om traces en logs te koppelen:
  • request_id - Een unieke identifier voor elk HTTP-request (gebruikelijk in webframeworks).
  • trace_id - De AppSignal- of OpenTelemetry trace-ID.
Veel webframeworks genereren automatisch een request_id voor elk request, wat dit een handige keuze maakt. Voor op OpenTelemetry gebaseerde integraties kunt u de trace-ID direct gebruiken.

​
Applicatielogs koppelen

Rapporteer logs vanuit uw applicatie door logging op te zetten met de AppSignal-pakketten of OpenTelemetry SDK. De meeste frameworkconfiguraties hebben al request_id of trace_id tags ingesteld. Als er geen relevante logs worden gedetecteerd, volg dan de logging-configuratie-instructies voor het framework dat uw applicatie gebruikt of rapporteer de identifier handmatig als een trace-tag en log-attribuut.

​
Gekoppelde logs bekijken

Zodra u uw applicatie heeft geconfigureerd om traces aan logs te koppelen, kunt u gerelateerde logs direct in de AppSignal-interface bekijken:
  1. Navigeer naar een performance trace-sample of foutincident.
  2. Zoek naar het blok met gerelateerde logs, dat naar de relevante logberichten zal linken.
  3. Gebruik de logs om aanvullende context te krijgen over wat er tijdens het request is gebeurd.
Deze correlatie maakt debuggen sneller, omdat u snel de relevante trace en logs kunt vinden.

​
Volgende stappen