# otel-ruby

Помогает агенту настраивать и проверять OpenTelemetry в Ruby-приложениях. Пригодится для трассировки, метрик, логов и инструментирования Rails и других библиотек.

- скилл · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode · ★ 116
- Автор: ollygarden
- Лицензия: Apache-2.0 · policy=mirror · начало файла — в конце страницы
- Исходник: https://github.com/ollygarden/opentelemetry-agent-skills/tree/HEAD/skills/otel-ruby/SKILL.md
- Обновлён: 2026-10-25
- HTML: https://affpapa.org/nevibecode/skills/otel-ruby

## Что делает

Скилл подбирает инструкции под задачу: установка гемов и настройка `OpenTelemetry::SDK.configure`, ручные трассы, метрики и логи, контекст и propagation. Отдельные справочники посвящены инструментированию Rails, Rack, Sinatra, HTTP-клиентов, баз данных и фоновых задач, а также производительности и обновлениям.

Трассировка опирается на стабильные API и SDK, а метрики и логи в Ruby остаются экспериментальными. Версии гемов нужно разрешать независимо через Bundler и проверять изменения в `Gemfile.lock`; считать их версии совпадающими нельзя. Это особенно важно при обновлении contrib-инструментирования: совместимость зависит от конкретного гема.

## Установка

### Claude Code (родная платформа)

1. **Через Skills CLI (Vercel)**
```bash
npx skills add ollygarden/opentelemetry-agent-skills --skill otel-ruby -a claude-code
```

2. **Вручную: положить файлы**
- Файл: `~/.claude/skills/otel-ruby/SKILL.md` — Папка скилла целиком; для одного проекта — .claude/skills/otel-ruby/

### Codex

1. **Через Skills CLI (Vercel)**
```bash
npx skills add ollygarden/opentelemetry-agent-skills --skill otel-ruby -a codex
```

2. **Вручную: положить файлы**
- Файл: `.agents/skills/otel-ruby/SKILL.md` — Для всех проектов — ~/.agents/skills/

### Cursor

1. **Через Skills CLI (Vercel)**
```bash
npx skills add ollygarden/opentelemetry-agent-skills --skill otel-ruby -a cursor
```

2. **Вручную: положить файлы**
- Файл: `.cursor/skills/otel-ruby/SKILL.md` — Cursor читает и .agents/skills/, и .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install ollygarden/opentelemetry-agent-skills otel-ruby
```

2. **Вручную: положить файлы**
- Файл: `.github/skills/otel-ruby/SKILL.md`

### Gemini CLI

1. **Через Skills CLI (Vercel)**
```bash
npx skills add ollygarden/opentelemetry-agent-skills --skill otel-ruby -a gemini-cli
```

2. **Командой платформы**
```bash
gemini skills install https://github.com/ollygarden/opentelemetry-agent-skills --path skills/otel-ruby
```

### Windsurf (Devin Desktop)

**Вручную: положить файлы**
- Файл: `.devin/skills/otel-ruby/SKILL.md` — Старый путь .windsurf/skills/ тоже читается

### OpenCode

**Через Skills CLI (Vercel)**
```bash
npx skills add ollygarden/opentelemetry-agent-skills --skill otel-ruby -a opencode
```

### Claude.ai

**Claude.ai**
- Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills

Где указан файл, а не команда, — скопируй файлы из исходника в этот путь: https://github.com/ollygarden/opentelemetry-agent-skills/tree/HEAD/skills/otel-ruby/SKILL.md

## Когда брать
- настроить `OpenTelemetry::SDK.configure` в Ruby-приложении
- добавить ручные трассы и propagation
- выбрать contrib-инструментирование для Rails или Sidekiq
- разобраться с метриками и логами OpenTelemetry
- проверить версии гемов и обновления

## Примеры запросов агенту
- Настрой OpenTelemetry SDK для моего Ruby-приложения и проверь `Gemfile.lock`.
- Добавь ручную трассировку и передачу контекста в этом сервисе.
- Подбери и настрой OpenTelemetry-инструментирование для Rails и Sidekiq.

## Похожие
- [migrate-to-shoehorn](https://affpapa.org/nevibecode/skills/migrate-to-shoehorn.md) — скилл · 475388 установок
- [write-swift](https://affpapa.org/nevibecode/skills/write-swift.md) — скилл · 119300 установок
- [megacave](https://affpapa.org/nevibecode/skills/megacave.md) — скилл · 25400 установок
- [find-docs](https://affpapa.org/nevibecode/skills/find-docs.md) — скилл · 9400 установок
- [typescript-advanced-types](https://affpapa.org/nevibecode/skills/typescript-advanced-types.md) — скилл · 92169 установок
- [smart-explore](https://affpapa.org/nevibecode/skills/smart-explore.md) — скилл · 7300 установок

Из того же набора: [ollygarden/opentelemetry-agent-skills](https://affpapa.org/nevibecode/by/ollygarden/opentelemetry-agent-skills.md) — 20 карточек

_Часть страницы не вошла по размеру — она есть в HTML-версии._

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md