mirror of
https://github.com/prdlk/dotfiles.git
synced 2026-11-02 11:32:42 +00:00
Prad Nukala
6406208b35
- 16 cross-shell utilities converted to sh/bash chezmoi executables: ai c2p cp-appid extract_agents fab gdc gh-sonr-org-migrate ghg-clone ghn gho git-summary launch_omp_livediff_overlay lc-elir mdcp mdp pj (ghg-clone not named ghg: unrelated cargo binary owns that name) - cwd/history helpers stay per-shell: yy c cd clip-last + ghg/ghn/gho cd-wrappers in bash/functions/ and zsh/functions/, loaded by rc files - fish keeps only shell-state functions; converted ones now hit PATH - cp-appid ignore gating moved to .local/bin path - dot_agents/skills: 82 skills materialized from dotstate storage so dot_claude skill symlinks resolve on fresh bootstrap; dotstate profile/symlinks.json released .agents/skills .bashrc .zshrc
Cloudflare Observability Skill Reference
Purpose: Comprehensive guidance for implementing observability in Cloudflare Workers, covering traces, logs, metrics, and analytics.
Scope: Cloudflare Observability features ONLY - Workers Logs, Traces, Analytics Engine, Logpush, Metrics & Analytics, and OpenTelemetry exports.
Decision Tree: Which File to Load?
Use this to route to the correct file without loading all content:
├─ "How do I enable/configure X?" → configuration.md
├─ "What's the API/method/binding for X?" → api.md
├─ "How do I implement X pattern?" → patterns.md
│ ├─ Usage tracking/billing → patterns.md
│ ├─ Error tracking → patterns.md
│ ├─ Performance monitoring → patterns.md
│ ├─ Multi-tenant tracking → patterns.md
│ ├─ Tail Worker filtering → patterns.md
│ └─ OpenTelemetry export → patterns.md
└─ "Why isn't X working?" / "Limits?" → gotchas.md
Reading Order
Load files in this order based on task:
| Task Type | Load Order | Reason |
|---|---|---|
| Initial setup | configuration.md → gotchas.md | Setup first, avoid pitfalls |
| Implement feature | patterns.md → api.md → gotchas.md | Pattern → API details → edge cases |
| Debug issue | gotchas.md → configuration.md | Common issues first |
| Query data | api.md → patterns.md | API syntax → query examples |
Product Overview
Workers Logs
- What: Console output from Workers (console.log/warn/error)
- Access: Dashboard (Real-time Logs), Logpush, Tail Workers
- Cost: Free (included with all Workers)
- Retention: Real-time only (no historical storage in dashboard)
Workers Traces
- What: Execution traces with timing, CPU usage, outcome
- Access: Dashboard (Workers Analytics → Traces), Logpush
- Cost: $0.10/1M spans (GA pricing starts March 1, 2026), 10M free/month
- Retention: 14 days included
Analytics Engine
- What: High-cardinality event storage and SQL queries
- Access: SQL API, Dashboard (Analytics → Analytics Engine)
- Cost: $0.25/1M writes beyond 10M free/month
- Retention: 90 days (configurable up to 1 year)
Tail Workers
- What: Workers that receive logs/traces from other Workers
- Use Cases: Log filtering, transformation, external export
- Cost: Standard Workers pricing
Logpush
- What: Stream logs to external storage (S3, R2, Datadog, etc.)
- Access: Dashboard, API
- Cost: Requires Business/Enterprise plan
Pricing Summary (2026)
| Feature | Free Tier | Cost Beyond Free Tier | Plan Requirement |
|---|---|---|---|
| Workers Logs | Unlimited | Free | Any |
| Workers Traces | 10M spans/month | $0.10/1M spans | Paid Workers (GA: March 1, 2026) |
| Analytics Engine | 10M writes/month | $0.25/1M writes | Paid Workers |
| Logpush | N/A | Included in plan | Business/Enterprise |
In This Reference
- configuration.md - Setup, deployment, configuration (Logs, Traces, Analytics Engine, Tail Workers, Logpush)
- api.md - API endpoints, methods, interfaces (GraphQL, SQL, bindings, types)
- patterns.md - Common patterns, use cases, examples (billing, monitoring, error tracking, exports)
- gotchas.md - Troubleshooting, best practices, limitations (common errors, performance gotchas, pricing)
See Also
- Cloudflare Workers Docs
- Analytics Engine Docs
- Workers Traces Docs
- GraphQL Analytics API Reference - Query Workers metrics, HTTP analytics, and 70+ other datasets via GraphQL