Traceringsgegevens bekijken

Stackdriver Trace toont de details van een tracering in de weergave Traceringsgegevens. Deze weergave toont een samenvatting van de details van het verzoek, een grafische tijdlijn die het hoofdbereik aangeeft voor het end-to-end-verzoek en subbereiken voor eventuele RPC-aanroepen, en een gedetailleerd overzicht van wachttijdgegevens die zijn verzameld voor elk bereik.

Traceringsgegevens

Ga als volgt te werk om de details van een tracering bekijken:

  1. Ga naar uw traceerlijst via Stackdriver> Tracering > Traceerlijst in de Google Cloud Platform Console of klik op de volgende knop:

    Ga naar de pagina Traceerlijst

    Zie Traceringen zoeken voor meer informatie over het vinden van traceringen.

  2. Klik in de traceerlijst op een aanvraag-URI. De traceringsdetails worden hieronder weergegeven:

    Details van Stackdriver Trace

Verzoekoverzicht

Het venster aan de rechterkant in de weergave Traceringsgegevens bevat een samenvatting en details voor dit verzoek. De details omvatten de volgende informatie:

Property Beschrijving
Tijdstempel Het tijdstip waarop de app het inkomende verzoek heeft ontvangen.
Getraceerde tijd De totale hoeveelheid tijd die benodigd is om alle RPC-aanroepen te voltooien.
Niet-getraceerde tijd De tijd waarin geen RPC-oproepen zijn gedaan (dat wil zeggen tijd die lokaal in de app is doorgebracht). Als deze tijd langer is dan de standaard niet-getraceerde tijd aan het begin van een verzoek, wordt dit vaak worden veroorzaakt door een nieuwe instantie die wordt gemaakt om het werk uit te voeren.
Logboek Een link naar de bijbehorende logboekitems.
Rapport Een link naar de details van het bijbehorende analyserapport.
Service De App Engine-service waarmee het verzoek is afgehandeld. Zie de documentatie voor Java, Python, Go en PHP.
Versie De versie van de App Engine-app waarmee het verzoek is afgehandeld.
HTTP-methode De HTTP-methode van het verzoek.
Statuscode De HTTP-status die is geretourneerd door het verzoek.

Logboekitems

Stackdriver Trace koppelt logboeken aan traceringen met behulp van annotaties in de logboekitems. App Engine Standard koppelt de logboekitems automatisch aan traceringen, maar niet alle services doen dit.

Als u de Trace-SDK gebruikt, kunt u een logboekitem annoteren door het veld trace van het object LogEntry in te stellen op een tracerings-ID in de volgende indeling:

projects/[PROJECT-ID]/traces/[TRACE-ID]

U kunt een logboekitem ook koppelen aan een specifiek traceringsbereik. U doet dit door het LogEntry-veld span_id in te stellen op de hexadecimale codering van zestien tekens van het ID van het bereik. Een bereik met een ID van '74' wordt bijvoorbeeld weergegeven als '000000000000004a'.

Vanuit de traceringsdetailweergave van de GCP-console zijn er verschillende manieren om logboekitems te vinden:

  • Klik op de knop Logboeken weergeven in het venster Tijdlijn om logboekitems naast de tracering weer te geven. Deze knop verschijnt wanneer er logboekitems aan de tracering zijn gekoppeld.

  • Klik op de link Logboek: weergeven in het venster Samenvatting om een Stackdriver Logging-venster te openen en de logboekitems te bekijken die aan uw tracering zijn gekoppeld. Als er geen logboekitems aan uw tracering zijn gekoppeld, is het Logging-venster leeg.

  • Klik op de koppeling VM-logboek: weergeven in het venster Samenvatting dat aanwezig is voor traceringen die zijn gegenereerd door Cloud Load Balancer. De koppeling wordt geopend in een Stackdriver Logging-venster en toont u de logboeken van de VM-instantie die het verzoek heeft verwerkt. Het Logging-venster toont alleen het tijdstempelbereik van de tracering.

Vereiste rechten

Als u logboekitems wilt weergeven, moet u het recht logging.logEntries.list in uw project hebben. Dit recht wordt geleverd door de IAM-rollen Logging Logs Viewer en Project Viewer.

Als u logboeken van VM-instanties wilt weergeven, moet u het recht compute.instances.get in uw project hebben. De IAM-rollen Computing Engine Network Viewer en Project Viewer bieden dit recht.

Zie Logboekviewer voor meer informatie over het weergeven van logboekitems in Stackdriver Logging.

Span Annotations and Message Events (bèta)

Bereikannotaties en berichtgebeurtenissen kunnen worden geschreven met behulp van de Stackdriver Trace API v2. Indien aanwezig, worden ze weergegeven in de traceringstijdlijn. Net als bij bereiken en logboekitems kunt u een annotatie of berichtgebeurtenis selecteren om de volledige details te zien in het detailvenster rechts.

Zie het object TimeEvents in de Stackdriver Trace API v2 voor meer informatie.

Tijdlijn

De tijdlijn is een grafische weergave van wachttijdgegevens voor het verzoek. U ziet een hoofdbereik dat de tijd aangeeft die de app nodig had om het verzoek end-to-end te verwerken. U ziet ook subbereiken die aangeven hoeveel tijd nodig was om RPC-aanroepen te voltooien die werden uitgevoerd bij het verwerken van het verzoek.

U kunt klikken op een bereik in de tijdlijn om de details te zien. De relatie tussen het geselecteerde bereik en de bijbehorende subbereiken wordt weergegeven op de tijdlijn. Aanvullende gegevens die tijdens de runtime van de app aan Stackdriver Trace zijn gerapporteerd, worden in het rechtervenster weergegeven.

Voor het hoofdbereik toont Stackdriver Trace de volgende property's:

Property Beschrijving
Naam Relatieve URL voor het verzoek. Wordt weergegeven in het bereiklabel.
Wachttijd De tijd die de app nodig had om het verzoek volledig af te handelen. Wordt weergegeven in het bereiklabel.
gae/request_log_id Interne verzoek-ID van App Engine. Wordt weergegeven in het detailvenster onder de tijdlijn.
http/host Naam van de host waar de toepassing wordt uitgevoerd. Wordt weergegeven in het detailvenster onder de tijdlijn.
http/response/size Aantal bytes in het HTTP-antwoordgedeelte. Wordt weergegeven in het detailvenster onder de tijdlijn.
http/url Relatieve URL voor het verzoek. Wordt weergegeven in het detailvenster onder de tijdlijn.

Welke informatie wordt weergegeven voor subbereiken, is afhankelijk van de RPC-aanroep. Stackdriver Trace geeft echter altijd het volgende weer:

Property Beschrijving
Naam Naam van de RPC-aanroep in de vorm service_name.call_name (bijvoorbeeld datastore_v3.RunQuery). Wordt weergegeven in het bereiklabel. Opmerking: De naam van de aanroep is een interne App Engine-naam die mogelijk niet exact hetzelfde is als de naam van de aanroep in de taalspecifieke service-API.
Wachttijd De tijd die nodig was om de RPC-oproep volledig te voltooien. Wordt weergegeven in het bereiklabel.

Insights

Insights over de uitvoering van het verzoek worden weergegeven onder de tijdlijn, indien beschikbaar.

Zie Prestatie-insights voor meer informatie.

Traceringen in projecten weergeven

U kunt Stackdriver Trace instellen om traceringsbereiken weer te geven van projecten die uw doelproject aanroepen, evenals traceringsbereiken van andere projecten die verzoeken voor uw doelproject uitvoeren.

Zie Traceringen in projecten weergeven voor meer informatie.