# dt-obs-tracing

Скилл для анализа распределённых трейсов Dynatrace: медленные запросы, упавшие спаны, зависимости между сервисами. Пригодится, когда копаешь вглубь одного запроса.

- скилл · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode · 2600 установок · ★ 167
- Автор: Dynatrace
- Лицензия: Apache-2.0 · policy=mirror · начало файла — в конце страницы
- Исходник: https://github.com/Dynatrace/dynatrace-for-ai/tree/HEAD/skills/dt-obs-tracing/SKILL.md
- Обновлён: 2026-10-23
- HTML: https://affpapa.org/nevibecode/skills/dt-obs-tracing

## Что делает

Скилл учит агента работать со спанами в Grail через DQL. Спаны — единицы работы: HTTP-запросы, вызовы gRPC, обращения к базе, работа с очередями, внутренние функции. У каждого есть `span.kind` — `server`, `client`, `consumer`, `producer` или `internal`, а корневой спан помечен `request.is_root_span == true`. Именно по нему считают сквозную производительность запроса.

Внутри — готовые шаблоны запросов: сводка по сервисам с долей ошибок, перцентили p95 и p99 по эндпоинтам, поиск всех спанов по `trace.id`, отбор запросов дольше порога. Автор советует смотреть на перцентили, а не на среднее. Есть отдельный раздел про сэмплирование: один спан может представлять несколько реальных операций из-за агрегации и адаптивного сэмплинга, поэтому при подсчёте операций нужен множитель — иначе цифры разъедутся с реальностью.

Скилл не для всего подряд. Метрики уровня сервиса (RED) он отдаёт скиллу `dt-obs-services`, поиск по логам — `dt-obs-logs`, разбор проблем — `dt-obs-problems`. Вопросы по документации и конфигурации тоже не его. Если спросишь у агента про ошибки сервиса в целом, а не про конкретный спан, он, скорее всего, полезет не туда.

## Требования
- Работает с: Dynatrace

## Установка

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

1. **Через Skills CLI (Vercel)**
```bash
npx skills add Dynatrace/dynatrace-for-ai --skill dt-obs-tracing -a claude-code
```

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

### Codex

1. **Через Skills CLI (Vercel)**
```bash
npx skills add Dynatrace/dynatrace-for-ai --skill dt-obs-tracing -a codex
```

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

### Cursor

1. **Через Skills CLI (Vercel)**
```bash
npx skills add Dynatrace/dynatrace-for-ai --skill dt-obs-tracing -a cursor
```

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

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install Dynatrace/dynatrace-for-ai dt-obs-tracing
```

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

### Gemini CLI

1. **Через Skills CLI (Vercel)**
```bash
npx skills add Dynatrace/dynatrace-for-ai --skill dt-obs-tracing -a gemini-cli
```

2. **Командой платформы**
```bash
gemini skills install https://github.com/Dynatrace/dynatrace-for-ai --path skills/dt-obs-tracing
```

### Windsurf (Devin Desktop)

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

### OpenCode

**Через Skills CLI (Vercel)**
```bash
npx skills add Dynatrace/dynatrace-for-ai --skill dt-obs-tracing -a opencode
```

### Claude.ai

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

Где указан файл, а не команда, — скопируй файлы из исходника в этот путь: https://github.com/Dynatrace/dynatrace-for-ai/tree/HEAD/skills/dt-obs-tracing/SKILL.md

## Когда брать
- найти запросы дольше заданного порога и вытащить их trace ID
- разложить падения по причинам: HTTP-код, исключение, статус gRPC
- построить карту вызовов между сервисами с числом обращений и ошибок
- посмотреть все спаны одного трейса по его идентификатору
- посчитать перцентили p95 и p99 по эндпоинтам вместо среднего

## Примеры запросов агенту
- Найди трейсы дольше 5 секунд за последние 2 часа и покажи эндпоинт и сервис
- Покажи все спаны трейса `abc123def456` с длительностью и именем сервиса
- Какие сервисы вызывает `checkout` и сколько там ошибок?

## Похожие
- [dtctl](https://affpapa.org/nevibecode/skills/dtctl.md) — скилл · 1300 установок
- [Dynatrace Expert](https://affpapa.org/nevibecode/agents/dynatrace-expert.md) — субагент · ★ 40418
- [braintrust-tracing](https://affpapa.org/nevibecode/skills/braintrust-tracing.md) — скилл · 495 установок
- [groundcover-cli](https://affpapa.org/nevibecode/skills/groundcover-cli.md) — скилл · 8900 установок
- [agent-skills](https://affpapa.org/nevibecode/skills/agent-skills.md) — скилл · 2600 установок
- [sentry-go-sdk](https://affpapa.org/nevibecode/skills/sentry-go-sdk.md) — скилл · 2200 установок

Из того же набора: [dynatrace/dynatrace-for-ai](https://affpapa.org/nevibecode/by/dynatrace/dynatrace-for-ai.md) — 29 карточек

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

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