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 on 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 Stackdriver Trace. The screenshot below shows the Trace List page:

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 the Previous and Next links that appear at the bottom of the page, or 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:

  • Select values from the HTTP method, HTTP status, Service, and Version menus. Only the traces matching all the selected values are shown. You can also enter the start of a request URI in the Request filter text box. The match is case-sensitive.

  • Enter a trace filter in the Request filter text box. For example, the following filter matches traces that show a latency of one second or more, that contain a span named "/modules/GetNumInstances", and that returned an HTTP status code in the range 200–299.

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

    The comparisons are all case-sensitive. For more information, see Trace Filters.

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