---
title: "Agent Tracing"
description: "Debug agent runs and see where they fail or slow down."
url: https://docs.sentry.io/platforms/javascript/guides/nextjs/agent-tracing/
---

# Set Up Agent Tracing for Next.js

With [Sentry Agent Tracing](https://docs.sentry.io/product/agents.md), you can debug how an agent run flows through your application, and where it fails or slows down. Token usage, latency, and errors show up on that same trace, next to your requests, jobs, and logs. Multi-turn chats are grouped in [Conversations](https://docs.sentry.io/product/agents/conversations.md).

## Set up with Sentry CLI

Set up Sentry with the Sentry CLI. Install the CLI with one of these commands, then follow the Sentry CLI docs to finish setup.

**cURL**

```bash
curl https://cli.sentry.dev/install -fsS | bash
```

**PowerShell**

```powershell
irm https://cli.sentry.dev/install.ps1 | iex
```

**Homebrew**

```bash
brew install getsentry/tools/sentry
```

**npx**

```bash
npx sentry@latest
```

[Learn more about the Sentry CLI](https://cli.sentry.dev/)

## [Supported Instrumentation](https://docs.sentry.io/platforms/javascript/guides/nextjs/agent-tracing.md#supported-instrumentation)

As of SDK version `11.0.0`, Sentry auto-instruments the most popular AI SDKs and frameworks out of the box — you don't need to add their integrations yourself. Just enable [tracing](https://docs.sentry.io/platforms/javascript/guides/nextjs/tracing.md), then pick your AI stack below. Each integration page has the details. To group multi-turn chats in Conversations, also [track conversations](https://docs.sentry.io/platforms/javascript/guides/nextjs/agent-tracing.md#tracking-conversations) in the requests that make AI calls.

[![cloudflare icon](https://docs.sentry.io/_next/static/media/cloudflare.7e288bf9.svg)](https://docs.sentry.io/platforms/javascript/guides/cloudflare/agent-tracing/workers-ai.md)

[Workers AI](https://docs.sentry.io/platforms/javascript/guides/cloudflare/agent-tracing/workers-ai.md)

[![cloudflare icon](https://docs.sentry.io/_next/static/media/cloudflare.7e288bf9.svg)](https://docs.sentry.io/platforms/javascript/guides/cloudflare/agent-tracing/agents-sdk.md)

[Agents SDK](https://docs.sentry.io/platforms/javascript/guides/cloudflare/agent-tracing/agents-sdk.md)

[![vercel icon](https://docs.sentry.io/_next/static/media/vercel.08882b16.svg)](https://docs.sentry.io/platforms/javascript/guides/nextjs/configuration/integrations/vercelai.md)

[Vercel AI SDK](https://docs.sentry.io/platforms/javascript/guides/nextjs/configuration/integrations/vercelai.md)

[![openai icon](https://docs.sentry.io/_next/static/media/openai.2d7a0936.svg)](https://docs.sentry.io/platforms/javascript/guides/nextjs/configuration/integrations/openai.md)

[OpenAI](https://docs.sentry.io/platforms/javascript/guides/nextjs/configuration/integrations/openai.md)

[![anthropic icon](https://docs.sentry.io/_next/static/media/anthropic.6478e781.svg)](https://docs.sentry.io/platforms/javascript/guides/nextjs/configuration/integrations/anthropic.md)

[Anthropic](https://docs.sentry.io/platforms/javascript/guides/nextjs/configuration/integrations/anthropic.md)

[![google-genai icon](https://docs.sentry.io/_next/static/media/gemini.6a0c6609.svg)](https://docs.sentry.io/platforms/javascript/guides/nextjs/configuration/integrations/google-genai.md)

[Google Gen AI SDK](https://docs.sentry.io/platforms/javascript/guides/nextjs/configuration/integrations/google-genai.md)

[![langchain icon](https://docs.sentry.io/_next/static/media/langchain.00856afb.svg)](https://docs.sentry.io/platforms/javascript/guides/nextjs/configuration/integrations/langchain.md)

[LangChain](https://docs.sentry.io/platforms/javascript/guides/nextjs/configuration/integrations/langchain.md)

[![langgraph icon](https://docs.sentry.io/_next/static/media/langgraph.0ea576b7.svg)](https://docs.sentry.io/platforms/javascript/guides/nextjs/configuration/integrations/langgraph.md)

[LangGraph](https://docs.sentry.io/platforms/javascript/guides/nextjs/configuration/integrations/langgraph.md)

[![mistral icon](https://docs.sentry.io/_next/static/media/mistral.9a6254c9.svg)](https://docs.sentry.io/platforms/javascript/guides/nextjs/configuration/integrations/mistral.md)

[Mistral AI](https://docs.sentry.io/platforms/javascript/guides/nextjs/configuration/integrations/mistral.md)

[![groq icon](https://docs.sentry.io/_next/static/media/groq.fa8427cb.svg)](https://docs.sentry.io/platforms/javascript/guides/nextjs/configuration/integrations/groq.md)

[Groq](https://docs.sentry.io/platforms/javascript/guides/nextjs/configuration/integrations/groq.md)

[![together-ai icon](https://docs.sentry.io/_next/static/media/default.615d3e47.svg)](https://docs.sentry.io/platforms/javascript/guides/nextjs/configuration/integrations/together-ai.md)

[Together AI](https://docs.sentry.io/platforms/javascript/guides/nextjs/configuration/integrations/together-ai.md)

[![typesafe-ai icon](https://docs.sentry.io/_next/static/media/typesafe-ai.bed5ab6d.svg)](https://docs.sentry.io/platforms/javascript/guides/nextjs/configuration/integrations/typesafe.md)

[TypeSafe](https://docs.sentry.io/platforms/javascript/guides/nextjs/configuration/integrations/typesafe.md)

[![mastra icon](https://docs.sentry.io/_next/static/media/mastra.0ffd9091.svg)](https://docs.sentry.io/platforms/javascript/guides/mastra.md)

[Mastra](https://docs.sentry.io/platforms/javascript/guides/mastra.md)

[![eve icon](https://docs.sentry.io/_next/static/media/eve.1fd15661.svg)](https://docs.sentry.io/platforms/javascript/guides/eve.md)

[Eve](https://docs.sentry.io/platforms/javascript/guides/eve.md)

[![flue icon](https://docs.sentry.io/_next/static/media/flue.066f2fe9.svg)](https://docs.sentry.io/platforms/javascript/guides/flue.md)

[Flue](https://docs.sentry.io/platforms/javascript/guides/flue.md)

[![pi-durable icon](https://docs.sentry.io/_next/static/media/pi.40e46665.svg)](https://docs.sentry.io/platforms/javascript/guides/pi-durable.md)

[Pi Durable](https://docs.sentry.io/platforms/javascript/guides/pi-durable.md)

## [Tracking Conversations](https://docs.sentry.io/platforms/javascript/guides/nextjs/agent-tracing.md#tracking-conversations)

[Conversations](https://docs.sentry.io/product/agents/conversations.md) groups multi-turn AI activity into a single replay of messages and tool calls. Use `setConversationId()` so every AI span in a chat session shares the same `gen_ai.conversation.id`.

Some integrations infer a conversation ID automatically. For everything else (including Workers AI), set it yourself at the start of **every request or operation that makes AI calls**, before those calls run. Reuse the same session ID across messages in the chat. The ID is applied to AI-related spans on the current isolation scope (which is typically request-scoped). Pass `null` to unset it.

```javascript
Sentry.setConversationId("conv_abc123");
```

### [Identifying Users in Conversations](https://docs.sentry.io/platforms/javascript/guides/nextjs/agent-tracing.md#identifying-users-in-conversations)

The [Conversations](https://docs.sentry.io/product/agents/conversations.md) view includes a **User** column. To populate it, call `setUser` once per request or session, before any AI calls:

```javascript
Sentry.setUser({
  id: "user_123",
  email: "jane@example.com",
  username: "jane",
});
```

Any of `id`, `email`, or `username` is sufficient — the Conversations tab displays whichever fields are present. See the [setUser API reference](https://docs.sentry.io/platforms/javascript/guides/nextjs/configuration/apis.md#setUser) for the full list of supported fields.

## [Options](https://docs.sentry.io/platforms/javascript/guides/nextjs/agent-tracing.md#options)

### [Privacy Controls](https://docs.sentry.io/platforms/javascript/guides/nextjs/agent-tracing.md#privacy-controls)

The SDK records generative AI inputs and outputs by default. To turn them off:

```javascript
Sentry.init({
  dsn: "https://<key>@o<orgId>.ingest.sentry.io/<projectId>",
  dataCollection: {
    genAI: { inputs: false, outputs: false },
  },
});
```

You can also set `recordInputs` / `recordOutputs` on a specific AI integration. See each integration page for the API that applies on your platform.

### [Streaming Gen AI Spans](https://docs.sentry.io/platforms/javascript/guides/nextjs/agent-tracing.md#streaming-gen-ai-spans)

From SDK `10.61.0`, `gen_ai` spans are sent as standalone envelope items (avoids large-payload drops; required for [Conversations](https://docs.sentry.io/product/agents/conversations.md)).

## [Manual Instrumentation](https://docs.sentry.io/platforms/javascript/guides/nextjs/agent-tracing.md#manual-instrumentation)

You can also instrument agent spans yourself. See [manual instrumentation](https://docs.sentry.io/platforms/javascript/guides/nextjs/agent-tracing/manual-instrumentation.md).

## [MCP Server Monitoring](https://docs.sentry.io/platforms/javascript/guides/nextjs/agent-tracing.md#mcp-server-monitoring)

If you're building MCP (Model Context Protocol) servers, Sentry can also track tool executions, prompt retrievals, and resource access. See [MCP Monitoring](https://docs.sentry.io/platforms/javascript/guides/nextjs/mcp-monitoring.md) for setup instructions.

## Pages in this section

- [Manual Instrumentation](https://docs.sentry.io/platforms/javascript/guides/nextjs/agent-tracing/manual-instrumentation.md)
