iii-observability — скилл для Claude Code
Скилл iii-observability даёт движку iii трейсинг, структурированные логи, метрики с агрегацией, алерты и сэмплинг через OpenTelemetry. Вызовы engine::* пишут и читают телеметрию, триггер log реагирует на каждую запись.
лицензия не указана 195 установок ★ 18 938 обновлён 2026-11-09
npx skills add iii-hq/iii --skill iii-observability -a claude-codeЧто делает iii-observability
Внутри девять пространств имён: engine::log::* пишет записи по уровню (info, warn, error), engine::logs::list читает сохранённые логи с фильтром по времени и трейсу, engine::traces::* отдаёт спаны списком, деревом или группирует по атрибуту, engine::metrics::list и engine::rollups::list показывают метрики и агрегаты за минуту, пять минут или час. engine::baggage::* управляет OpenTelemetry baggage, engine::health::check и engine::alerts::* проверяют состояние движка и правила алертов.
Данные уходят в коллектор по OTLP/gRPC (endpoint, по умолчанию http://localhost:4317) или хранятся в памяти (exporter: memory или both). Функции чтения работают только с memory или both. TLS включается автоматически для https://, для HTTP/protobuf задай OTEL_EXPORTER_OTLP_PROTOCOL=http/protobuf. Заголовки коллектора — через OTEL_EXPORTER_OTLP_HEADERS или отдельно для трейсов, метрик и логов.
Триггер log запускает функцию на каждую запись в конвейере логов. Укажи level: error, чтобы ловить только ошибки, или убери, чтобы получать всё. Возвращаемое значение игнорируется, вызов идёт асинхронно.
Какие задачи решает
- писать структурированные логи из функции без вызова внешнего коллектора
- запускать обработчик на каждую запись лога в реальном времени
- читать сохранённые спаны и метрики с фильтром по атрибутам и времени
- передавать OpenTelemetry baggage между вызовами
- проверять состояние движка и правила алертов операционно
Примеры запросов агенту
- Запиши ошибку уровня
errorс атрибутомuser_idчерезengine::log::error - Покажи все логи за последний час с уровнем
warnили выше - Сгруппируй спаны по атрибуту
http.status_codeи выведи количество на группу
Как установить iii-observability
1Через Skills CLI (Vercel)
npx skills add iii-hq/iii --skill iii-observability -a claude-code2Вручную: положить файлы
~/.claude/skills/skills/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/skills/
1Через Skills CLI (Vercel)
npx skills add iii-hq/iii --skill iii-observability -a codex2Вручную: положить файлы
.agents/skills/skills/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add iii-hq/iii --skill iii-observability -a cursor2Вручную: положить файлы
.cursor/skills/skills/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install iii-hq/iii engine/src/workers/observability/skills2Вручную: положить файлы
.github/skills/skills/SKILL.md1Через Skills CLI (Vercel)
npx skills add iii-hq/iii --skill iii-observability -a gemini-cli2Командой платформы
gemini skills install https://github.com/iii-hq/iii --path engine/src/workers/observability/skillsВручную: положить файлы
.devin/skills/skills/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add iii-hq/iii --skill iii-observability -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы об iii-observability
Как установить iii-observability в Claude Code?
Выполни npx skills add iii-hq/iii --skill iii-observability -a claude-code, затем npx skills add iii-hq/iii --skill skills -a claude-code и открой ~/.claude/skills/skills/SKILL.md.
Что делает iii-observability?
Скилл добавляет движку iii трейсинг, логи, метрики и алерты через OpenTelemetry. Функции engine::* пишут и читают телеметрию, триггер log реагирует на каждую запись.
Почему функции чтения возвращают пустой результат?
Функции engine::logs::list и engine::traces::* работают только если exporter установлен в memory или both. С otlp данные хранятся в коллекторе, и читать их напрямую нельзя.