Skip to main content
skill CX Codex

otel-telemetry-emissions — Claude Code skill: how to install

Version-pinned registry of telemetry emitted by OpenTelemetry components and SDKs. Inspect spans, metrics, and logs before updating collector pipelines.

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add ollygarden/opentelemetry-agent-skills --skill otel-telemetry-emissions -a claude-code
Open on GitHub

What otel-telemetry-emissions does

The skill equips coding agents with a structured inventory of OpenTelemetry signals across specific releases. It catalogs components from collector repositories and instrumentation packages, storing each version in a separate markdown file like opentelemetry-collector-contrib/receiver/kafkareceiver/v0.158.0.md. The agent starts at index.md to locate exact versions or pick the closest prior release.

Data files outline trace spans, metric instruments with units, and log events alongside required attributes. The scope_name field records the instrumentation scope so runtime records match their components. In addition, conditional telemetry gated behind feature flags is documented in notes tables.

Because entries stem from automated LLM analysis of upstream repositories, double-checking against the original source code remains necessary for sensitive production setups.

What it helps with

  • Inspect spans and metrics for an OpenTelemetry receiver at an exact version
  • Audit attribute changes before upgrading collector components or SDKs
  • Identify the correct instrumentation scope name for incoming logs
  • Check which metrics require opt-in flags or experimental semantic conventions

Example prompts for the agent

  • Show all metrics and spans emitted by kafkareceiver in version v0.158.0
  • Check if the telemetry changed between the current and target SDK versions
  • Look up the instrumentation scope name for this collector component

How to install otel-telemetry-emissions

1Skills CLI (Vercel)

npx skills add ollygarden/opentelemetry-agent-skills --skill otel-telemetry-emissions -a claude-code

2Manually: put the files in place

~/.claude/skills/otel-telemetry-emissions/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/otel-telemetry-emissions/

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about otel-telemetry-emissions

How to install otel-telemetry-emissions in Claude Code?

Run npx skills add ollygarden/opentelemetry-agent-skills --skill otel-telemetry-emissions -a claude-code in your terminal.

What does otel-telemetry-emissions do?

It provides a versioned catalog of traces, metrics, and logs emitted by OpenTelemetry components. Agents query it to verify telemetry changes before upgrades.

How accurate is the inventory data?

Tables are generated through LLM evaluation of upstream repositories. You should verify details against upstream source files or documentation before making architectural decisions.

Source text

SKILL.md · Apache-2.0
---
name: otel-telemetry-emissions
description: Version-pinned inventory of the telemetry (spans, metrics, logs, attributes) emitted by OpenTelemetry collector components and SDK instrumentation packages. Use when working with a covered component — what it emits at a given version, or how emission changed across versions — and when upgrading a component or SDK version, to see the telemetry after the change.
---

# Telemetry Emissions

A registry of what telemetry OpenTelemetry components actually emit, pinned to
upstream versions.

> **Note:** The telemetry emissions in these files were detected by LLM
> analysis of the upstream source and may contain errors. Verify against the
> component's source or docs before relying on a row for critical decisions.

## Layout

```
<repo basename>/<path in repo>/v<version>.md
```

Example: `opentelemetry-collector-contrib/receiver/kafkareceiver/v0.158.0.md`

One file per scanned version. The files in a component directory are its
telemetry history; `index.md` lists every file — start there to see what is
covered.

## Looking up a component at a version

1. Find the component's directory (or its row in `index.md`).
2. Pick the file matching the target version exactly.
3. If there is no exact match, use the file with the highest version below the
   target and say the exact version is unverified.
4. If the component or version is not covered at all, say so — do not infer
   telemetry from semantic conventions.

## What a data file contains

Frontmatter (`repo`, `path`, `version`, `scope_name`, `commit_sha`,
`last_verified`), then per-signal tables:

- **Traces** — span name, kind, attributes, notes
- **Metrics** — metric name, instrument type, unit, attributes, notes
- **Logs** — log/event name, attributes, notes

`scope_name` is the component's instrumentation scope — the anchor for
matching runtime telemetry back to the component. When helper or pipeline
telemetry uses another scope, its rows name that scope in `Notes`.
`last_verified: null` means the historical verification date could not be
substantiated; recheck the pinned source before presenting its rows as verified.
Absent signals are omitted
entirely. `Notes` marks conditional emission (feature gates, opt-in config,
experimental semconv). `Sources` lists the upstream files the data came from.

© ollygarden · Apache-2.0 · ollygarden/opentelemetry-agent-skills

Similar skills

All skills for DevOps and infrastructure →

From the same set20

otel-component-telemetry Scans one OpenTelemetry component at pinned versions and records the spans, metrics and logs it emits as change-point files. CX Codex +1 ★ 116repo stars otel-weaver Guides OpenTelemetry Weaver registry authoring, codegen, and CI validation. It replaces manual telemetry constants with schema-driven code. CX Codex +1 ★ 116repo stars otel-upgrade This skill assesses OpenTelemetry upgrades against a repository’s versions and evidence. Use it to plan a move to a new SDK, Collector, or related component. CX Codex +1 ★ 116repo stars otel-telemetrygen Builds version-pinned telemetrygen commands for synthetic OTLP traces, metrics and logs aimed at a collector. CX Codex +1 ★ 116repo stars otel-span-events-to-logs-migration Guides OpenTelemetry instrumentation migrations from Span Events to the Logs API while retaining trace correlation. Use it to plan a migration or review existing calls. CX Codex +1 ★ 116repo stars otel-semantic-conventions A skill that looks up released OpenTelemetry semantic conventions: group names, attributes and span naming rules. Useful when the agent would otherwise invent keys. CX Codex +1 ★ 116repo stars otel-sdk-versions Looks up released OpenTelemetry SDKs, Collector components, config schemas, and semantic conventions. Helps pick compatible versions when adding telemetry. CX Codex +1 ★ 116repo stars otel-ruby Guides an agent through OpenTelemetry setup and troubleshooting in Ruby services. Use it for tracing, experimental metrics and logs, or library instrumentation. CX Codex +1 ★ 116repo stars

Project sponsors

Companies that keep this analytics open
Gold sponsor

Impressions, clicks and code copies — open statistics. We keep the numbers public for the same reason NeBlask itself is public. Become a sponsor