references/tail-workers/README.md
Cloudflare Tail Workers
Use Tail Workers when execution events need custom processing. Fetch the current documentation before implementing handlers, configuration, or integrations.
| Task | Documentation | | --- | --- | | Decide whether custom processing is needed | Tail Workers | | Export logs and traces to an observability destination | OpenTelemetry export | | Inspect a deployment interactively | Real-time logs | | Implement the consumer | Tail handler |
Before adding a Tail Worker, check whether built-in OpenTelemetry export meets the destination’s needs. Use the Tail Workers guide for the tradeoff, then identify the custom filtering or transformation that remains necessary.
In This Reference
- configuration.md — producer, consumer, destination, and environment setup
- api.md — event fields, execution outcomes, and redaction
- patterns.md — destination and filtering decisions
- gotchas.md — connection, data, and delivery investigation
See observability for broader logging and tracing choices.