Skip to content
Merged
Show file tree
Hide file tree
Changes from 1 commit
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
51 changes: 51 additions & 0 deletions src/content/changelog/workers/2025-11-06-automatic-tracing.mdx
Original file line number Diff line number Diff line change
@@ -0,0 +1,51 @@
---
title: Workers automatic tracing, now in open beta
description: Gain instant visibility into Workers execution with automatic tracing and OpenTelemetry exports
products:
- workers
date: 2025-11-06
---

Enable automatic tracing on your Workers, giving you detailed metadata and timing information for every operation your Worker performs.

![Tracing example](~/assets/images/workers-observability/R2_Screenshot.png)

Tracing helps you identify performance bottlenecks, resolve errors, and understand how your Worker interacts with other services on the Workers platform. You can now answer questions like:
* Which calls are slowing down my application?
* Which queries to my database take the longest?
* What happened within a request that resulted in an error?

**You can now:**
* View traces alongside your logs in the Workers Observability dashboard
* Export traces (and correlated logs) to any [OTLP-compatible destination](https://opentelemetry.io/docs/specs/otel/protocol/), such as [Honeycomb](/workers/observability/exporting-opentelemetry-data/honeycomb/), [Sentry](/workers/observability/exporting-opentelemetry-data/sentry/) or [Grafana](/workers/observability/exporting-opentelemetry-data/grafana-cloud/), by configuring a tracing destination in the [Cloudflare dashboard](https://dash.cloudflare.com/?to=/:account/workers-and-pages/observability/destinations)
* Analyze and query across span attributes (operation type, status, duration, errors)

## To get started, set:

```jsonc
{
"observability": {
"tracing": {
"enabled": true
}
}
}
```

Starting with the compatibility date of [2025-11-19](/workers/configuration/compatibility-flags/#automatic-tracing), the following will also enable tracing **in addition to** logs:

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


## Want to learn more?
* [Read the announcement](https://blog.cloudflare.com/workers-tracing-now-in-open-beta/)
* [Check out the documentation](/workers/observability/traces/)



35 changes: 35 additions & 0 deletions src/content/compatibility-flags/automatic-tracing.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,35 @@
---
_build:
publishResources: false
render: never
list: never

name: "Automatic tracing"
sort_date: "2025-11-05"
enable_date: "2025-11-19"
enable_flag: "enable_workers_observability_tracing"
---

This flag will enable [Workers Tracing](/workers/observability/traces/) by default if you have the following configured in your Wrangler configuration file:

```json
{
"observability": {
"enabled": true
}
}
```


You can also explictly turn on automatic tracing without the flag and with older compatibility dates by setting the following:


```json
{
"observability": {
"traces": {
"enabled": true,
}
}
}
```
16 changes: 8 additions & 8 deletions src/content/docs/workers/observability/traces/index.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -32,32 +32,32 @@ For a full list of instrumented operations , see the [spans and attributes docum

### How to enable tracing

If you have already set `observability.enabled = true` in your [wrangler configuration file](/workers/wrangler/configuration/#observability), tracing **and** logs will be automatically enabled.
You can configure tracing by setting `observability.traces.enabled = true` in your [wrangler configuration file](/workers/wrangler/configuration/#observability).

<WranglerConfig>

```json
{
"observability": {
"enabled": true
"traces": {
"enabled": true,
// optional sampling rate (recommended for high-traffic workloads)
"head_sampling_rate": 0.05
}
}
}
```

</WranglerConfig>

You can also configure tracing independently by setting `observability.traces.enabled = true` in your [wrangler configuration file](/workers/wrangler/configuration/#observability).
Starting with the [compatibility date of 2025-11-19](/workers/configuration/compatibility-flags/#automatic-tracing), the following will also enable tracing **in addition to** logs.

<WranglerConfig>

```json
{
"observability": {
"traces": {
"enabled": true,
// optional sampling rate (recommended for high-traffic workloads)
"head_sampling_rate": 0.05
}
"enabled": true
}
}
```
Expand Down