---
description: Trace model calls, tool runs, and approvals across agent sessions, and inspect them with session replay and trace waterfalls in the Cloudflare Dashboard.
title: "Cloudflare Agents: trace every model call, tool run, and decision"
image: https://developers.cloudflare.com/changelog/post/2026-08-04-agent-tracing/og.png?v=3dfbdf634b3a73e1
---

[Skip to content](#main-content)

[View RSS feeds](https://developers.cloudflare.com/fundamentals/new-features/available-rss-feeds/) [ Subscribe to RSS](https://developers.cloudflare.com/changelog/rss/index.xml)

[Back to all posts](https://developers.cloudflare.com/changelog)

August 4, 2026

## Cloudflare Agents: trace every model call, tool run, and decision

[Agents](https://developers.cloudflare.com/agents/) [Workers](https://developers.cloudflare.com/workers/)

Copy as Markdown| [View as Markdown](https://developers.cloudflare.com/changelog/post/2026-08-04-agent-tracing/index.md)| [Agent setup](https://developers.cloudflare.com/agent-setup/)

[Cloudflare Agents ↗︎](https://dash.cloudflare.com/?to=/:account/agents) now has a dedicated home in the Cloudflare dashboard that lists your traced agents and subagents.

Select an agent to inspect its traces in two ways:

**Replay a session** assembles the full conversation for a turn: system instructions, user messages, model reasoning, tool calls with arguments and results, and the final response.

![Session replay showing messages, reasoning, and subagent tool calls](https://developers.cloudflare.com/cdn-cgi/image/onerror=redirect,width=1980,height=1352,format=webp/_astro/agent_tracing_session_replay.uwseMu6e.png)

**View a trace** shows the execution timeline, connecting agent operations to Workers infrastructure so you can see where time was spent.

![Trace waterfall showing nested agent, model, tool, and D1 spans](https://developers.cloudflare.com/cdn-cgi/image/onerror=redirect,width=2832,height=1290,format=webp/_astro/agent_tracing_waterfall.Bw-JYiiV.png)

Enable tracing in your Wrangler configuration:

```jsonc
{
	"observability": {
		"enabled": true,
		"traces": {
			"enabled": true
		}
	}
}
```

```toml
[observability]
enabled = true

  [observability.traces]
  enabled = true
```

#### Framework support

Think and Flue agents are instrumented automatically. For direct AI SDK calls, wrap the namespace with [`wrapAISDK()`](https://developers.cloudflare.com/agents/runtime/observability/tracing/#ai-sdk). Custom harnesses can use the [Workers custom spans API](https://developers.cloudflare.com/workers/observability/traces/custom-spans/) with [OpenTelemetry Generative AI semantic conventions ↗︎](https://opentelemetry.io/docs/specs/semconv/registry/attributes/gen-ai/).

#### Get Started

Check out the full blog post: [Introducing: Cloudflare Agents ↗︎](https://blog.cloudflare.com/agents-on-cloudflare).

For setup details, refer to the [Agent tracing documentation](https://developers.cloudflare.com/agents/runtime/observability/tracing/).

```json
{"@context":"https://schema.org","@type":"BlogPosting","@id":"https://developers.cloudflare.com/changelog/post/2026-08-04-agent-tracing/#page","headline":"Cloudflare Agents: trace every model call, tool run, and decision","description":"Trace model calls, tool runs, and approvals across agent sessions, and inspect them with session replay and trace waterfalls in the Cloudflare Dashboard.","url":"https://developers.cloudflare.com/changelog/post/2026-08-04-agent-tracing/","inLanguage":"en","image":"https://developers.cloudflare.com/changelog/post/2026-08-04-agent-tracing/og.png?v=3dfbdf634b3a73e1","dateModified":"2026-08-04","datePublished":"2026-08-04","publisher":{"@type":"Organization","name":"Cloudflare","description":"One platform for your apps, agents, and workforce. Build, secure, and scale without managing infrastructure","url":"https://www.cloudflare.com/","sameAs":["https://github.com/cloudflare","https://www.linkedin.com/company/cloudflare","https://x.com/cloudflare"],"logo":{"@type":"ImageObject","url":"https://developers.cloudflare.com/logo.svg"},"address":{"@type":"PostalAddress","streetAddress":"101 Townsend St","addressLocality":"San Francisco","addressRegion":"CA","postalCode":"94107","addressCountry":"US"},"contactPoint":[{"@type":"ContactPoint","contactType":"Customer Support","url":"https://support.cloudflare.com/","availableLanguage":["English"]},{"@type":"ContactPoint","contactType":"Sales","url":"https://www.cloudflare.com/contact/","availableLanguage":["English"]}]},"isPartOf":{"@type":"WebSite","@id":"https://developers.cloudflare.com/#website","name":"Cloudflare Docs","url":"https://developers.cloudflare.com/"}}
```