Troubleshooting

This page contains troubleshooting information for Trace.

No data in the Trace interface

If you can't view traces in your Google Cloud project when you expect trace data to be present, try the following steps:

  1. In the Google Cloud Console, in the toolbar click Navigation menu and select APIs & Services.

  2. In the dashboard that lists all APIs, ensure that the Cloud Trace API is listed. If Cloud Trace API is listed in the table, then the API is enabled. Please proceed to the next numbered step.

    If Cloud Trace API isn't listed, then the API isn't enabled. To enable the Cloud Trace API, click Enable APIs and Services, and then search for Trace API. If you see an entry for Cloud Trace API, select it. Otherwise, select Stackdriver Trace API. After you have selected the API, click Enable.

  3. In the dashboard that lists all APIs, if the row for the Cloud Trace API doesn't list any numeric values for the Requests column, Errors column, or for other columns, that indicates that no trace requests are reaching your Google Cloud project. Check your applications and proxies to ensure they are configured to send the traces to the correct project.

  4. To view details about the API usage, click Cloud Trace API, and then click Metrics.

    To narrow down the source of the errors, use the Credentials and Methods filters and view the effect your selections have on the Errors by API method chart:

    • If all writes are failing, ensure that your service account has access to the Cloud Trace Agent role. This role includes the permission cloudtrace.traces.patch. For more information, see Cloud Trace IAM roles.

    • If reads are failing, ensure that you have access to the Cloud Trace User role for this Google Cloud project. For a full list of permissions for this role, see Cloud Trace IAM roles.