Documentationbreadcrumb arrow Grafana Cloudbreadcrumb arrow Observe and actbreadcrumb arrow Agent Observabilitybreadcrumb arrow Guidesbreadcrumb arrow Claude Platform
Grafana Cloud

Send Claude Platform traces

Note

OpenTelemetry ingestion in Agent Observability is currently in public preview. Grafana Labs offers limited support, and breaking changes might occur prior to the feature being made generally available.

OpenTelemetry export from the Claude Platform is now in public beta. It exports traces for Messages API requests and Claude Managed Agents sessions. Send Messages API traces to Grafana Cloud to see each request in Agent Observability, with token usage, cost, and evaluations, without changing your code.

Before you begin

Before you start, make sure you have:

  • Agent Observability enabled on your Grafana Cloud stack. Refer to Set up Agent Observability.
  • The Admin role in your Claude Console organization.

Add a Grafana Cloud destination

Add your Grafana Cloud stack as a telemetry destination in the Claude Console.

  1. In the Grafana Cloud portal, open your stack and copy the OTLP endpoint URL and the Instance ID from the OpenTelemetry card. Refer to OpenTelemetry card on the Grafana Cloud portal.
  2. Create a Cloud Access Policy token with the traces:write scope. Refer to Cloud access policy.
  3. In the Claude Console, open the OpenTelemetry settings page and click Add destination.
  4. Select Grafana Cloud as the Provider.
  5. Enter the OTLP endpoint, the Instance ID, and the token as the Access policy token.
  6. Under Content mode, select Full content to see prompts and responses. Metadata only sends token counts and timing without content.
  7. Choose which workspaces send traces: all, selected ones, or all except selected ones.
  8. Click Add destination.
The Add destination dialog in the Claude Console with Grafana Cloud selected as the provider

For more about the export, refer to Export OpenTelemetry traces from the Claude API in the Claude documentation.

Group requests into conversations

Agent Observability groups the requests of one trace into one conversation. By default, each request is its own trace. To keep a multi-turn conversation together, send the same W3C traceparent header, with the sampled flag set, on each of its requests. The Claude SDK sets traceparent for you when you call it inside one of your own spans.

Verify data

Send a Messages API request, then check the export:

  1. In the Claude Console, check that the Delivery column for your destination shows Healthy.
  2. Open Conversations in Agent Observability. The request appears with its model, token usage, cost, and stop reason. With Full content, it also shows the prompt and response.