cloudflare-observability-review

Investigate production Cloudflare Workers logs, traces, and Ray IDs for MCP request forensics.

8|6|Updated Jul 31, 2026
One-click install
npx skills add https://github.com/stellar-experimental/stellar-raven --skill cloudflare-observability-review-stellar-experimental
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: cloudflare-observability-review
Source: https://github.com/stellar-experimental/stellar-raven/tree/main/.agents/skills/cloudflare-observability-review
Command: npx skills add https://github.com/stellar-experimental/stellar-raven --skill cloudflare-observability-review-stellar-experimental

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? It answers "what happened in production?" for the stellar-raven-codemode Cloudflare Worker by providing a structured runbook for querying Workers Logs, platform invocation events, and OTel spans without needing app-level correlation IDs. ## Core Features & Use Cases - Request Joining: Join single invocations via cf-ray headers, $metadata.requestId, and cloudflare.ray_id across app logs, platform events, and spans. - Failure Diagnosis: Investigate demo playground failures, skill retrieval errors, and auth rejections using documented event fields like demo-execute, skill_read, and auth_reject. - Measurement Trap Warnings: Avoid documented pitfalls such as ABR sampling bias, wide-window query undercounting, and misreading truncated flags. - Use Case: A user reports a failed playground chat; you query demo-chat events in a 10-hour window, join failing requests by requestId, and determine whether the failure was model-authored JavaScript or a sandbox timeout. ## Quick Start Ask the agent to investigate a production issue by providing a Ray ID or time window, for example: "Use the cloudflare observability runbook to find what happened to request with Ray ID a15a1ed37fa5b049 in the last 6 hours."

Frequently Asked Questions about cloudflare-observability-review

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I investigate a failed Cloudflare Worker request using logs?▼

Start with the response cf-ray header, strip the colo suffix, then query Workers Logs filtering by $metadata.service and $metadata.requestId equal to that Ray ID. Join app JSON logs, platform invocation events, and OTel spans through the same identifier.

How to query Cloudflare Workers observability telemetry by Ray ID?▼

Use the Cloudflare API MCP telemetry query with filters on $metadata.requestId for worker events or cloudflare.ray_id for OTel spans. Wait 30-90 seconds after the request for log ingestion before querying.

Can I correlate MCP requests across multiple invocations without correlation IDs?▼

Yes, for successful OAuth requests you can group by the privacy-safe subjectHash or clientHash fields in the mcp_request summary events. Child events join through $metadata.requestId, and null clientHash indicates a pre-attribution grant.

Why does my Cloudflare telemetry query return zero events for something that exists?▼

New field values are not filterable for roughly 20 minutes after first emission due to filter index lag. Query broadly with only the service filter and filter client-side, or join by $metadata.requestId from an event you can find.

What are the limitations of wide-window Cloudflare log queries?▼

A single flat query over a wide window returns a tiny unrepresentative slice, not all matching events under the limit. Slice windows wider than about 6 hours into consecutive chunks and sum the results to get accurate counts.