Debugging Workers with wrangler tail and real-time logs

# Debugging with tail and real-time logs

`wrangler tail` displays a live feed of console and exception logs for every request served by your Worker code, including Durable Object requests handled by that Worker. Run it in the Worker project root, reproduce the problem, and watch the actual behavior instead of guessing.

## The options

- **`wrangler tail`**: terminal live feed. Best during active debugging; filterable.
- **Real-time logs** (dashboard): near real-time log events in the Cloudflare dashboard. Best when you cannot or do not want a terminal session, or for showing someone else.
- **Tail Workers** (beta): programmatic tail with custom filtering, sampling, and transformation of telemetry. Best for persistent pipelines (forward errors to your own systems).

## The discipline

1. Reproduce under tail: the log line you need only exists while the bug happens.
2. Log the discriminating values: request path, binding call arguments, branch taken. `console.log` is cheap; a second deploy to add the missing log line is expensive.
3. For Durable Objects, tail the Worker that owns the DO binding: DO request logs flow through it.
4. Exceptions in tail include stacks: copy the full stack into the incident record, not just the message.

## Checklist

- Keep a tail running during every production deploy verification.
- Strip or redact sensitive values from logs before they become a permanent stream: logs are stored and visible to the team.
- If tail shows nothing, confirm you are tailing the right environment (production vs preview).