Finding traces

Stackdriver Trace displays a list of recent requests to your application in the Trace list. You can use this list to browse and filter all associated traces by URI, service, version, time range and other parameters. Once you have found a trace, you can click the displayed request URI to view its details.

Find a trace

To view your trace list, select Stackdriver > Trace > Trace list in the Google Cloud Platform Console, or click the following button:

Go to the Trace list page

It can take a few minutes for traces to appear the first time you use Trace. The following screenshot shows an example of the trace list for a Compute Engine configuration:

Stackdriver Trace list

To the right of the chart, the trace list shows the following information for each request:

  • Latency: The time it took the application to handle the request, end-to-end.
  • HTTP Method: The HTTP method of the request: GET, DELETE, POST, or PUT.
  • URI: The relative URI of the request.
  • Analysis Report: A link to the associated analysis report, if one is available.
  • Time: When the request was made.

Browse traces

By default, the trace list displays the 5 most recent requests to your application. You can browse forward and backward in the list by clicking Previous (navigate_before) and Next (navigate_next), or you can set a predetermined time range using the selections at the top of the page.

You can also click and drag inside the graph to select a custom time range:

Selecting a custom time range in the trace graph

Filter traces

To filter the traces that appear in the trace list, do either of the following:

  • Use the Request filter field. Comparisons are case-sensitive.

    • To list all traces for a project with root span name "Recv", enter the root span name,"Recv", or a prefix for the root span name, such as "Re".

    • To list all traces that returned an HTTP status code in the range 200–299, where the latency is one second or more, and the trace contains a span with the exact name "/modules/GetNumInstances", use the following filter:

      +span:/modules.GetNumInstances latency:1s /http/status_code:2
      

      The trace filter term +span forces an exact match on the span name. If you want to include all traces where "/modules/GetNumInstances" is a prefix for a span name, omit the plus sign. For more information on trace filter terms, see Trace filters.

  • Use the drop-down lists. The match is case-sensitive.

    • The values you select for the HTTP method and HTTP status are applied only to trace root spans. If you select GET for the HTTP method, only traces whose root span HTTP method is GET match this filter.
    • For App Engine environments, you have the additional options to filter for Service and for Version. These choices are applied to all spans of a trace.
    • For all environments, you can enter the start of a request URI in the Request filter text box.

View trace details

You can click any request URI displayed to view the trace details. See Viewing trace details for more information.

Was this page helpful? Let us know how we did:

Send feedback about...

Stackdriver Trace Documentation