Observability

Add production observability to Cloudflare Workers apps with structured logs, request IDs, metrics, traces, Durable Object/Queue/Workflow visibility, error handling, and incident debugging. Use before deploying or debugging Cloudflare applications.

Install

skills CLI (Claude Code, Cursor, Codex and more)
npx skills add zllovesuki/cloudflare-agent-skills --skill observability
Manual install
git clone --depth 1 https://github.com/zllovesuki/cloudflare-agent-skills.git /tmp/cloudflare-agent-skills
mkdir -p ~/.claude/skills
cp -r /tmp/cloudflare-agent-skills/skills/observability ~/.claude/skills/observability

Personal skills live in ~/.claude/skills. Use .claude/skills in a project folder to share a skill with your team.

From the SKILL.md

# Observability

Use this skill for logging, metrics, traces, and incident debugging in Cloudflare applications.

## Observability stance

- Edge systems are ephemeral; design logs and metrics as the primary debugging evidence.
- Add correlation IDs at the Worker boundary and pass them through bindings, queues, workflows, and external calls.
- Log structured events, not unparseable strings.
- Redact secrets and minimize PII.
- Observe every asynchronous boundary: `waitUntil`, Queues, Workflows, Durable Objects, AI calls, and container calls.

## Request ID middleware pattern

```ts
export function getRequestId(request: Request) {
  return request.headers.get("cf-ray")
    ?? request.headers.get("x-request-id")
    ?? crypto.randomUUID();
}

export function log(event: string, fields: Record<string, unknown>) {
  console.log(JSON.stringify({ event, ...fields }));
}
```

## Worker handler pattern
Read the full skill on GitHub

Details

Skill name
observability
Path
skills/observability/SKILL.md
Repo updated
28 April 2026

FAQ

What does the Observability skill do?

Add production observability to Cloudflare Workers apps with structured logs, request IDs, metrics, traces, Durable Object/Queue/Workflow visibility, error handling, and incident debugging. Use before deploying or debugging Cloudflare applications.

How do I install the Observability skill?

skills CLI (Claude Code, Cursor, Codex and more): npx skills add zllovesuki/cloudflare-agent-skills --skill observability. Skills go in ~/.claude/skills (personal) or .claude/skills (project), and Claude loads them automatically when a task matches the description.

Is Observability popular?

It lives in zllovesuki/cloudflare-agent-skills, which has 9 GitHub stars and 0 forks.

Related skills

Agents

9

zllovesuki/cloudflare-agent-skills

Build Cloudflare Agents SDK applications for autonomous multi-step tool use, AIChatAgent chat agents, Durable Object-backed state, tools, scheduling, callable methods, WebSockets, SQL state, and constrained agent behavior. Use when RAG or Workflows are not enough.

AI, LLMs & Agents

Cloudflare Architecture

9

zllovesuki/cloudflare-agent-skills

Choose Cloudflare Developer Platform primitives and architecture shapes before writing code. Use for Cloudflare Workers, Durable Objects, D1, R2, Queues, Workflows, Containers, Realtime, Workers AI, Vectorize, AI Search, Agents, cost, limits, and migration decisions.

Software Development

Containers

9

zllovesuki/cloudflare-agent-skills

Decide when to use Cloudflare Containers instead of Workers and design container-backed workloads, native binaries, long-running processes, image processing, larger runtime shapes, and Worker frontends. Use as an escape hatch when Workers constraints do not fit.

DevOps & Cloud

Platform Limits

9

zllovesuki/cloudflare-agent-skills

Check Cloudflare Developer Platform hard limits and runtime constraints before implementation: Worker memory/CPU/body/protocol constraints, D1 size/query limits, Durable Object hotspots, KV consistency, Queue message size/order, R2 object flows, and product availability. Use to prevent invalid designs.

DevOps & Cloud

Migration

9

zllovesuki/cloudflare-agent-skills

Plan incremental migrations to Cloudflare from AWS, Azure, GCP, server-based apps, or existing databases using strangler patterns, service boundaries, R2 offload, Workers frontdoors, Hyperdrive, queues, workflows, shadow reads, rollback, and observability.

DevOps & Cloud

Queues

9

zllovesuki/cloudflare-agent-skills

Use Cloudflare Queues for asynchronous background work, producers, consumers, batching, retries, idempotent message handling, delayed processing, fan-out, and decoupling request latency. Use when Worker code should do something later without needing strict ordering.

DevOps & Cloud

Browse the most popular Claude skills, all devops & cloud skills, or write your own with the skills generator.