1# Cloudflare Observability Skill Reference
2 
3**Purpose**: Comprehensive guidance for implementing observability in Cloudflare Workers, covering traces, logs, metrics, and analytics.
4 
5**Scope**: Cloudflare Observability features ONLY - Workers Logs, Traces, Analytics Engine, Logpush, Metrics & Analytics, and OpenTelemetry exports.
6 
7---
8 
9## Decision Tree: Which File to Load?
10 
11Use this to route to the correct file without loading all content:
12 
13```
14├─ "How do I enable/configure X?"           → configuration.md
15├─ "What's the API/method/binding for X?"   → api.md
16├─ "How do I implement X pattern?"          → patterns.md
17│   ├─ Usage tracking/billing               → patterns.md
18│   ├─ Error tracking                       → patterns.md
19│   ├─ Performance monitoring               → patterns.md
20│   ├─ Multi-tenant tracking                → patterns.md
21│   ├─ Tail Worker filtering                → patterns.md
22│   └─ OpenTelemetry export                 → patterns.md
23└─ "Why isn't X working?" / "Limits?"       → gotchas.md
24```
25 
26## Reading Order
27 
28Load files in this order based on task:
29 
30| Task Type | Load Order | Reason |
31|-----------|------------|--------|
32| **Initial setup** | configuration.md → gotchas.md | Setup first, avoid pitfalls |
33| **Implement feature** | patterns.md → api.md → gotchas.md | Pattern → API details → edge cases |
34| **Debug issue** | gotchas.md → configuration.md | Common issues first |
35| **Query data** | api.md → patterns.md | API syntax → query examples |
36 
37## Product Overview
38 
39### Workers Logs
40- **What:** Console output from Workers (console.log/warn/error)
41- **Access:** Dashboard (Real-time Logs), Logpush, Tail Workers
42- **Cost:** Free (included with all Workers)
43- **Retention:** Real-time only (no historical storage in dashboard)
44 
45### Workers Traces
46- **What:** Execution traces with timing, CPU usage, outcome
47- **Access:** Dashboard (Workers Analytics → Traces), Logpush
48- **Cost:** $0.10/1M spans (GA pricing starts March 1, 2026), 10M free/month
49- **Retention:** 14 days included
50 
51### Analytics Engine
52- **What:** High-cardinality event storage and SQL queries
53- **Access:** SQL API, Dashboard (Analytics → Analytics Engine)
54- **Cost:** $0.25/1M writes beyond 10M free/month
55- **Retention:** 90 days (configurable up to 1 year)
56 
57### Tail Workers
58- **What:** Workers that receive logs/traces from other Workers
59- **Use Cases:** Log filtering, transformation, external export
60- **Cost:** Standard Workers pricing
61 
62### Logpush
63- **What:** Stream logs to external storage (S3, R2, Datadog, etc.)
64- **Access:** Dashboard, API
65- **Cost:** Requires Business/Enterprise plan
66 
67## Pricing Summary (2026)
68 
69| Feature | Free Tier | Cost Beyond Free Tier | Plan Requirement |
70|---------|-----------|----------------------|------------------|
71| Workers Logs | Unlimited | Free | Any |
72| Workers Traces | 10M spans/month | $0.10/1M spans | Paid Workers (GA: March 1, 2026) |
73| Analytics Engine | 10M writes/month | $0.25/1M writes | Paid Workers |
74| Logpush | N/A | Included in plan | Business/Enterprise |
75 
76## In This Reference
77 
78- **[configuration.md](configuration.md)** - Setup, deployment, configuration (Logs, Traces, Analytics Engine, Tail Workers, Logpush)
79- **[api.md](api.md)** - API endpoints, methods, interfaces (GraphQL, SQL, bindings, types)
80- **[patterns.md](patterns.md)** - Common patterns, use cases, examples (billing, monitoring, error tracking, exports)
81- **[gotchas.md](gotchas.md)** - Troubleshooting, best practices, limitations (common errors, performance gotchas, pricing)
82 
83## See Also
84 
85- [Cloudflare Workers Docs](https://developers.cloudflare.com/workers/)
86- [Analytics Engine Docs](https://developers.cloudflare.com/analytics/analytics-engine/)
87- [Workers Traces Docs](https://developers.cloudflare.com/workers/observability/traces/)
88- [GraphQL Analytics API Reference](../graphql-api/) - Query Workers metrics, HTTP analytics, and 70+ other datasets via GraphQL
89