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.