skills.rest
iterate
iterateOFFICIAL
Explore all skills by this author →
Website𝕏@iterateGitHub

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
One-click install
npx skills add https://github.com/iterate/iterate --skill cloudflare-traces
Or copy as Structured Prompt for Agent▼
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.

Related Skills

Explore More Software Engineering Skills→
thurstonsandthurstonsand

cloudflare-worker-logs

Query Cloudflare Workers logs and metrics via the Workers Observability API.

Community
Intermediate
ethan-rioethan-rio

arize-trace

Export and inspect Arize trace and span data using the ax CLI.

Community
Advanced
greyhaven-aigreyhaven-ai
29

observability-monitoring

Implement Cloudflare Workers observability with wrangler tail and health checks.

Community
Intermediate
AgentiveCityAgentiveCity
2

cloudflare-observability-logging-monitoring

Configure structured logging, tracing, and Sentry integration for Cloudflare Workers.

Official
Advanced