Quickstart

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

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 Cloud Platform project.

    Go to the Manage resources page

  3. Enable billing for your project.

    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.

Note: If you enabled Stackdriver Trace within the last day, no latency data appears in the trace overview. Stackdriver Trace prompts you to create a custom analysis report instead.

Find a trace

Click the Trace List tab 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 view appears in the console.

This 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. In the trace details view described above, click Analysis Reports.

  2. Click Create a report in the analysis reports list that appears.

  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 Latency Density Distribution and Cumulative Distribution.

  3. View the distribution of average latencies for requests by percentage 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

Monitor your resources on the go

Get the Google Cloud Console app to help you manage your projects.

Send feedback about...

Stackdriver Trace Documentation