cloudflare-traces

Query Cloudflare Workers trace summaries and span events by traceId.

198|19|Updated Sep 15, 2025

Search Tags:#debugging #mcp #observability #tracing #cloudflare #workers #otel

Ready to run

npx skills add https://github.com/iterate/iterate --skill cloudflare-traces

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: cloudflare-traces
Source: https://github.com/iterate/iterate/tree/main/.agents/skills/cloudflare-traces
Command: npx skills add https://github.com/iterate/iterate --skill cloudflare-traces

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Cloudflare traces help you pinpoint where and why a Workers request is slowed down or failing by showing the span-level execution path across distributed work.

Core Features & Use Cases

Trace lookup and span retrieval: Query trace summaries and then fetch underlying span events for the same trace ID to inspect execution details.
Span event analysis: Aggregate span events by source.name (and optionally $metadata.transactionName) to quickly identify hot spots and dominant components.
Operational debugging reports: Produce evidence needed for incident diagnosis, including timeframe, request URL, span counts, error spans, and whether the failure impacted callers.

Quick Start

Ask the skill to query a specific trace ID for a given timeframe and return a span breakdown grouped by source name.

Frequently Asked Questions about cloudflare-traces

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

FAQPage Schema

How do I diagnose Cloudflare Workers performance issues using trace spans?▼

To debug Cloudflare Workers performance regressions, query the Cloudflare API using the otel dataset to retrieve trace summaries and underlying span events, grouping them by span source and transaction metadata to pinpoint execution hot spots.

How do I retrieve span events for a specific Cloudflare Workers trace ID?▼

Retrieve span events for a specific Cloudflare Workers trace ID by using the Cloudflare API MCP server to call trace query endpoints with the dataset set to otel, filtering specifically by the target traceId within a given timeframe.

What is the best way to analyze distributed tracing spans for Cloudflare subrequest chains?▼

The best way to analyze distributed tracing spans for Cloudflare subrequest chains is aggregating span events by source.name and transaction metadata, which quickly identifies dominant components and execution hot spots across the distributed observability event flow.

Does Cloudflare tracing work with OpenTelemetry for Workers observability?▼

Yes, Cloudflare tracing works with OpenTelemetry for Workers observability by querying the Cloudflare API trace endpoints with the dataset parameter explicitly set to otel to retrieve distributed traces and span events.

Can I generate an operational debugging report from Cloudflare Workers observability traces?▼

Yes, you can generate an operational debugging report from Cloudflare Workers observability traces that summarizes the incident timeframe, request URL, span counts, error spans, and whether the failure impacted callers.