Stackdriver Trace

Stackdriver Trace is a distributed tracing system for Google Cloud Platform that collects latency data from Google App Engine, Google HTTP(S) load balancers, and applications instrumented with the Stackdriver Trace SDKs, and displays it in near real time in the Google Cloud Platform Console. It helps you understand how long it takes your application to handle incoming requests from users or other applications, and how long it takes to complete operations like RPC calls performed when handling the requests. Currently, Stackdriver Trace collects end-to-end latency data for requests to App Engine URIs and additional data for round-trip RPC calls to App Engine services like Datastore, URL Fetch, and Memcache.

As micro-services become more popular, the cross-application tracing provided by Stackdriver Trace becomes essential in pinpointing the root cause of latency issues.

Stackdriver Trace overview page

You can use Stackdriver Trace to:

  • Quickly view a snapshot of last-day latency data for your application in the trace overview.
  • Drill down to detailed latency data, including performance insights and detailed data for the most frequent application requests and RPC calls.
  • Find latency data for individual requests and view latency details.
  • Generate custom analysis reports that show an overview of latency data for all or a subset or requests, and allow you to compare two different sets of latency data.
  • View the current and previous calendar months' trace span ingestion counts.

Why Stackdriver Trace?

Latency management — managing the amount of time it takes for your application to handle incoming requests and perform operations — is an important part of managing overall application performance. Stackdriver Trace helps you monitor application latency, identify its sources, and optimize your application based on the data it collects.

Because Stackdriver Trace is tightly integrated with Google App Engine, it provides a high level of coverage and fidelity when collecting latency data from your applications. It also provides built-in, automatic analysis reporting that makes it easier to understand application latency and bottlenecks, and how these impact overall performance.

Stackdriver Trace can help you answer the following questions:

  • How long does it take my application to handle a given request?
  • Why is it taking my application so long to handle a request?
  • Why do some of my requests take longer than others?
  • What is the overall latency of requests to my application?
  • Has latency for my application increased or decreased over time?
  • What can I do to reduce application latency?

How does Stackdriver Trace work?

Stackdriver Trace works for any running App Engine application. During application runtime, App Engine sends latency data to Stackdriver Trace for requests to application URIs and, within the requests, for round-trip RPC calls to App Engine services. Stackdriver Trace works with all App Engine APIs, with the exception of Cloud SQL.

App Engine sends latency data to the Stackdriver Trace backends in the form of a trace. The trace consists of a root span that contains overall latency information about the request, as well as subspans that contain latency information about any completed RPC calls. Each span contains a set of properties that provide information about the source and amount of latency. These spans are ingested by Stackdriver Trace.

Stackdriver Trace stores the incoming latency data in its storage backends, and makes it available for real-time viewing and reporting in the GCP Console. Spans that are retrieved from the storage backends are scanned by Stackdriver Trace.

Stackdriver Trace pricing is determined by the number of Trace spans ingested, and scanned, on a monthly basis. See Trace Pricing for details.

Trace Terminology


A trace charts an incoming request to your application and the various events (typically RPC calls or instrumented sections of code) that took place in order to generate a response to the request, along with precise timings. These events are represented as spans in the trace.


A component of a trace which typically represents an RPC call that took place as a result of the initial request to the application.


You can attach annotations to spans. Common examples of annotations include adding the version of the service which generated the span, adding data related to the generator of a captured RPC call, and adding custom data that the developer chose to include with a span. You may be able to filter on an annotation in the Stackdriver Trace UI or via the analysis tools.

Get started

Open the trace overview for your project in the GCP Console or see the Quickstart to get started.

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

Send feedback about...

Stackdriver Trace Documentation