This page shows you how to perform basic operations for a project that has already been instrumented with Stackdriver Trace.

Trace is automatically enabled for all apps running on the App Engine standard environment. For apps running on a VM or a container, including VM instances from Compute Engine and App Engine flexible environment, and containers in Kubernetes Engine, see the Setup page for details on how to instrument your application in various environments and languages.

Before you begin

  1. Sign in to your Google Account.

    If you don't already have one, sign up for a new account.

  2. Select or create a GCP project.

    Go to the Manage resources page

  3. Make sure that billing is enabled for your project.

    Learn how to enable billing

View the trace overview

The trace overview is the default view in Stackdriver Trace. It displays a snapshot of the last-day latency data for your application.

  1. Open the trace overview for your project.
  2. Click Enable Trace on the notification that appears in the console.

Find a trace

Go to the Trace List page to view a list of recent requests to your application.

The trace list allows you to browse and filter all associated traces by URI, module, version, time range, and other parameters. You can use the trace list to find traces whose details you want to view:

Stackdriver Trace list

View trace details

Click on the URI of any displayed trace in the trace list. The trace details appear in the console.

The detail view shows a summary of details about the request, a graphical timeline that shows the root span for the end-to-end request and subspans for any RPC calls, and a detailed view of latency data collected for the spans:

Stackdriver Trace details

Create an analysis report

An analysis report shows you an overall view of latency for requests to your application, or a subset of the requests.

To create an analysis report:

  1. Click Analysis Reports in the left-side navigation panel. If you have any reports, they are listed:

    Stackdriver Trace details

  2. Click + New Report at the top of the Analysis Reports page.

  3. Enter a forward slash ('/') in the Request URI field. This specifies that the report should contain information on all requests to the application.

  4. Accept the remainder of the default settings for the report. For the time span, the default is the hour previous to when the report was created.

  5. Click Submit to create the report. The new report appears in the analysis report list.

View an analysis report

To view an analysis report:

  1. In the analysis report list described above, click on the name of the report.

    The analysis report view appears in the console.

    Stackdriver Trace analysis report

  2. Toggle between report graphs by clicking Density Distribution and Cumulative Distribution.

  3. View the distribution of average latencies for requests by percentile in the Latency panel below the report graphs.

  4. Click numbers in the Sample Traces column to view trace details for representative samples of requests at different percentiles.

  5. View any detected performance bottlenecks in the Bottlenecks panel.

  6. Click numbers in the Sample Traces column to view trace details for representative samples of requests where reported bottlenecks were detected.

What's next

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

Send feedback about...

Stackdriver Trace Documentation