菜单
OpenTelemetry for edge runtimes (Cloudflare Workers, Vercel Edge, Deno). trace(), span(), instrument(); sampling, events, logger. Bundle-size optimized; no Node.js APIs.
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
Use this skill when instrumenting AI/LLM/agent code with OpenTelemetry GenAI semantic conventions — traceGenAI() spans, token usage and cost, gen_ai.* attributes, GenAI metric views, content/evaluation events, the Vercel AI SDK bridge, or the agent identity/delegation/policy/audit governance layer. This is the canonical home for everything GenAI in autotel (the core `autotel` package is AI-free).
Review TypeScript/JavaScript code for OpenTelemetry instrumentation patterns and guide adoption of autotel. Covers Next.js, Nuxt, Nitro, TanStack Start, SvelteKit, NestJS, Express, Hono, Fastify, Elysia, Cloudflare Workers, AWS Lambda, edge runtimes, and standalone Node. Detects unstructured tracing, missing span attributes, manual exporter setup, broken context propagation, exposed PII, and ad-hoc error handling. Covers spans, metrics, logs, structured errors, the autotel processor pipeline (tail-sampling, attribute redaction, span-name normalisation, filtering, baggage), built-in enrichers (user agent, geo, request size) and custom `defineEnricher`, `defineWorkerFetch` for Cloudflare async drains, multi-vendor OTLP backends (Honeycomb, Datadog, Grafana Cloud, Sentry, Axiom, HyperDX), `composeSpanProcessors` / `composeSubscribers` / `composePostProcessors` for pipelines, AI SDK observability with gen-ai semantic conventions, and end-to-end OTLP testing.
Query OpenTelemetry telemetry (traces, metrics, logs, LLM analytics) via the autotel CLI. Use when the user asks about a production issue, slow request, error spike, expensive LLM call, or any "what is happening in my service" question. Each command returns one JSON document on stdout — parse it and answer from the data.
OpenTelemetry instrumentation for MCP (Model Context Protocol). instrumentMCPServer, instrumentMCPClient; W3C trace context via _meta; tools, resources, prompts. Security observability: annotation hints, payload-size & char-budget signals, pluggable prompt-injection classifier, spotlighting.
When to use trace vs span vs request logger vs events in Autotel. Init once at startup, package exports (autotel, autotel/event, autotel/testing). Use for setup and choosing the right API.
trace(), span(), instrument(), init(). Factory vs direct pattern, name inference. Sync init; use node-require for optional deps. Load when wrapping handlers or functions with spans.
| name | autotel-edge |
| description | OpenTelemetry for edge runtimes (Cloudflare Workers, Vercel Edge, Deno). trace(), span(), instrument(); sampling, events, logger. Bundle-size optimized; no Node.js APIs. |
Vendor-agnostic OpenTelemetry for edge runtimes: Cloudflare Workers, Vercel Edge, Netlify Edge, Deno Deploy. Same functional API as autotel (trace, span, instrument) with a small bundle (~20KB). No Node.js APIs; use where autotel (Node) cannot run.
import { init, trace } from 'autotel-edge';
init({ service: 'edge-api' });
const handler = trace(async (request: Request) => {
return new Response('ok');
});
autotel-edge — core (trace, span, instrument, init)autotel-edge/sampling — sampling strategiesautotel-edge/events — events with trace correlationautotel-edge/logger — trace-aware loggerautotel-edge/testing — test utilitiesUse trace(), span(), instrument() the same way as in autotel. Init once at the top of your worker/module. For Cloudflare-specific bindings and handler wrappers, use autotel-cloudflare on top of autotel-edge.
Edge runtimes do not provide Node.js APIs. Keep code path that runs on the edge free of Node modules. autotel-cloudflare and other edge packages use only fetch, AsyncLocalStorage (or polyfill), and standard APIs.
Source: packages/autotel-edge/CLAUDE.md
In edge workers use autotel-edge (and optionally autotel-cloudflare), not autotel. The Node package is not bundleable for edge.
Source: packages/autotel-edge/CLAUDE.md
Targets autotel-edge. See also: autotel-cloudflare for Cloudflare Workers instrumentation and bindings.