NOTE: Some aspects of this product are in Beta. The hybrid installation options are GA. To join the Beta program, reach out to your Apigee representative.

Trace overview

Trace is a tool for troubleshooting and monitoring API proxies running on Apigee. Trace lets you probe the details of each step through an API proxy flow. Apigee lets you collect trace data, which shows the entire request/response flow of your API proxies. This includes all request/response parameters along with transformations applied to them at policy execution time. This is important for debugging and troubleshooting during API proxy development and deployment.

Using Trace

Create and manage debug sessions using the Trace tool via the UI or API, as described in Using Trace. Alternatively, you can download debug sessions and view and analyze them offline, as described in Using Offline Trace.

Apigee Support use of Trace

By default, Apigee allows Apigee Support to use the Trace tool on your API proxies to provide support.

Note the following:

  • Apigee Support has read-only permission to Trace data.
  • Apigee Support will request permission to run a Trace and will share a debug session link when it completes.

For Apigee hybrid users

If you are using Apigee hybrid, review the following sections.

Trace architecture

The following illustrates the process of creating a new debug session:

A high-level
  view of a request to start a debug session

Trace data is persisted in the management plane for up to 24 hours.


If you are using Apigee hybrid, before you can use trace you must be sure that the following are configured:

Service accounts:

  • apigee-synchronizer (role: Apigee Synchronizer Manager)
  • apigee-udca (role: Apigee Analytics Agent)

For more information, see Create service accounts.