ollygarden/opentelemetry-agent-skills/otel-ruby

Claude Code and agent skill by ollygarden/opentelemetry-agent-skills

Trust tier 3
  • community
Source check pending

Checking that the SKILL.md file is still in the repository.

OpenTelemetry in Ruby — SDK setup, manual tracing, experimental metrics and logs, Bundler integration, contrib instrumentation for Rails/Rack/Sinatra/Sidekiq and other gems, propagation, performance, and upgrades. Use when adding, reviewing, configuring, or troubleshooting OpenTelemetry in a Ruby or Rails service. Triggers on "setup otel in ruby", "ruby telemetry", "Rails OpenTelemetry", "OpenTelemetry::SDK.configure", "opentelemetry-instrumentation-all", "Ruby tracing", "Rack otel", "Sidekiq otel", or any Ruby-related OTel question.

Install

npx vskill@latest install ollygarden/opentelemetry-agent-skills/otel-ruby

SKILL.md

OpenTelemetry in Ruby

Entry point for OpenTelemetry mechanics in Ruby applications. Load only the reference that matches the task; each reference is self-contained.

References

FileUse when
`references/setup.md`Installing gems, configuring OpenTelemetry::SDK.configure, selecting OTLP exporters, setting resources and environment variables, and handling process shutdown.
`references/api.md`Writing manual traces, metrics, or logs; managing context and propagation; testing emitted telemetry.
`references/instrumentation-libraries.md`Selecting and configuring contrib instrumentation for Rails, Rack, Sinatra, HTTP clients, databases, jobs, messaging, and other gems.
`references/performance.md`Tuning sampling, batching, cardinality, forked-process behavior, exporters, and lifecycle handling.
`references/breaking-changes.md`Reviewing Ruby/runtime compatibility, independently versioned gems, experimental signal changes, and core/contrib upgrades.

Signal stability matters

Tracing uses the stable opentelemetry-api and opentelemetry-sdk gems. Ruby metrics and logs are separate 0.x API, SDK, and exporter gems and remain experimental. Do not assume a tracing gem's version exists for metrics, logs, semantic conventions, exporters, or contrib instrumentation. Resolve each gem independently with Bundler, inspect its changelog, and keep the resulting Gemfile.lock change under review.

Released snapshot verified 2026-10-25: tracing API 1.11.1, tracing SDK 1.13.1, trace OTLP exporter 0.37.0; metrics API 0.10.0, SDK 0.22.0, OTLP exporter 0.15.0; logs API 0.7.0, SDK 0.8.1, OTLP exporter 0.7.0; experimental declarative-config gem opentelemetry-config 0.2.0 (targets schema v1.0.0-rc.3; owner: the otel-declarative-config parsers table). Treat this as an audit anchor, not a version-alignment rule; use the lookups below for newer releases.

Sources of truth

FactFetch
Latest core releases and per-gem tagsgh api repos/open-telemetry/opentelemetry-ruby/releases --paginate
Latest contrib instrumentation releasesgh api repos/open-telemetry/opentelemetry-ruby-contrib/releases --paginate
Released and locked gem dependenciesgem specification <gem> dependencies --remote --yaml; inspect Gemfile.lock for the locked dependency set
Core implementation and changelogsopen-telemetry/opentelemetry-ruby
Contrib catalog, compatibility, and per-gem optionsopen-telemetry/opentelemetry-ruby-contrib
Ruby language docsOpenTelemetry Ruby documentation

Cross-references

  • SDK version selection across languages: otel-sdk-versions skill.
  • Semantic convention names and stability: otel-semantic-conventions skill.
  • OTLP receiver/export validation: otel-collector and otel-telemetrygen skills.

Security

  • Security scanPassed, 95 of 100Pattern checks on the skill's files.
  • Model reviewPassed

See the full security report

Quality evaluation

  • Task evaluationNot runNo evaluation yet. Run one in Skill Studio.

See evaluation results

Source

Popularity

7-day trend score
5

Not refreshed yet.

Works with

Any agent vskill installs to: 56 targets in all. These 39 have a page on this site.

  • Claude Code
  • Cursor
  • GitHub Copilot
  • Windsurf
  • Codex
  • Gemini CLI
  • Cline
  • Amp
  • Roo Code
  • Goose
  • Continue
  • Kilo Code
  • Junie
  • Trae
  • OpenHands
  • Qwen Code
  • AI Agent
  • Tabnine Chat
  • Sourcegraph Cody
  • Amazon Q
  • Firebase Genkit
  • Sweep
  • Devin
  • Phind
  • Mentat
  • Claude Desktop
  • Aider
  • GPT Pilot
  • Plandex
  • bolt.new
  • v0
  • Replit Agent
  • Anse
  • TypingMind
  • BetterChatGPT
  • LibreChat
  • Warp AI
  • Pieces
  • Fig AI
Embed badge
vskill VERIFIED badge
[![vskill VERIFIED](https://verified-skill.com/api/v1/skills/ollygarden/opentelemetry-agent-skills/otel-ruby/badge)](https://verified-skill.com/skills/ollygarden/opentelemetry-agent-skills/otel-ruby)

Something wrong with this skill or its page? Tell us.