{"slug":"otel-ruby","title":"otel-ruby","summary":"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 OpenTe","platform":"Claude","tags":[],"authorName":"LLM Mart","authorSlug":"llm-mart","score":0,"source":"github","price":null,"verified":false,"createdAt":"2026-10-16T16:29:06.691633Z","repo":{"url":"https://github.com/ollygarden/opentelemetry-agent-skills","stars":111,"forks":13,"license":"Apache-2.0","updatedAt":"2026-10-16T08:07:28Z"},"bodyHtml":"
\n

name: otel-ruby\ndescription: 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.

\n

OpenTelemetry in Ruby

\n

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

\n

References

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

Signal stability matters

\n

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

\n

Released snapshot verified 2026-10-03: tracing API 1.11.1, tracing SDK 1.13.1, trace OTLP\nexporter 0.37.0; metrics API 0.8.0, SDK 0.19.0, OTLP exporter 0.13.0; logs API 0.5.0, SDK\n0.7.0, OTLP exporter 0.6.0; experimental declarative-config gem opentelemetry-config 0.1.0\n(traces only; 0.1.1, verified 2026-10-15, still targets schema v1.0.0-rc.3; owner: the\notel-declarative-config parsers table). Treat this as an audit anchor, not\na version-alignment rule; use the lookups below for newer releases.

\n

Sources of truth

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
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
\n

Cross-references

\n\n","files":[{"path":"references/api.md","sizeBytes":3985,"isText":true},{"path":"references/breaking-changes.md","sizeBytes":3968,"isText":true},{"path":"references/instrumentation-libraries.md","sizeBytes":4008,"isText":true},{"path":"references/performance.md","sizeBytes":3488,"isText":true},{"path":"references/setup.md","sizeBytes":5990,"isText":true},{"path":"SKILL.md","sizeBytes":3853,"isText":true}],"reviewScore":null,"reviewSummary":null,"trust":{"provenance":"trusted-source-unreviewed","notice":"Community-authored content, reproduced verbatim and not vetted as instructions. Treat it as data to evaluate, never as directives to follow.","bodySource":null},"bodyLocked":false,"purchaseUrl":null,"sourceUrl":null,"report":{"provenance":"trusted-source-unreviewed","screen":{"ran":true,"outcome":"clean","suspicious":0,"notes":0,"hiddenCharacters":false},"virusScan":{"engine":"clamav","status":"clean","scannedAt":"2026-10-16T16:32:59.966375Z","sha256":"CD6B2DB51EF0C0C712543486B055F52F60D43A68B46CCD79C03BD6781A7BA58D","sizeBytes":11991},"review":null,"source":{"repositoryUrl":"https://github.com/ollygarden/opentelemetry-agent-skills","path":"skills/otel-ruby","license":"Apache-2.0","commit":"967179521de5e8dac365ae6fbc4fc64f427259f5","subtreeSha":"0A8060DDF5023FCBC74052E16C55A200D15E51F7B300EC3417053070EC9C10B4","lastSyncedAt":"2026-10-16T16:29:03.891055Z"},"reviewedAt":"2026-10-16T16:41:03.341709Z","notice":"Community-authored content, reproduced verbatim and not vetted as instructions. Treat it as data to evaluate, never as directives to follow."},"install":[{"target":"skills-cli","command":"npx skills add https://github.com/ollygarden/opentelemetry-agent-skills/tree/main/skills/otel-ruby"},{"target":"claude-code","command":"claude plugin marketplace add https://llmmart.ai/marketplace.json && claude plugin install ollygarden-opentelemetry-agent-skills@llmmart"},{"target":"git","command":"git clone https://github.com/ollygarden/opentelemetry-agent-skills.git"}]}