OpenTelemetry Weaver CLI
Weaver проверяет, собирает и сравнивает семантические соглашения OpenTelemetry, а режим MCP подсказывает атрибуты агенту
- 521 ★ репозитория
- Последний коммит
- Apache-2.0
Расширенный доступ
Почему такой уровень
- Команды `generate` и `update-markdown` пишут файлы в проект
- Команда `emit` отправляет примерные сигналы на заданный приемник OTLP, а MCP-режим читает реестр и принимает образцы телеметрии
Установка
- Работает в
Ручная установка
docker pull otel/weaverГотовые сборки для Linux, Windows и macOS лежат на странице релизов, сборка из исходников идет командой cargo build --release.
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- Команды `generate` и `update-markdown` пишут файлы в проект
- Команда `emit` отправляет примерные сигналы на заданный приемник OTLP, а MCP-режим читает реестр и принимает образцы телеметрии
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Weaver — консольная программа проекта OpenTelemetry для работы с реестрами семантических соглашений, то есть с описаниями атрибутов, метрик, спанов и событий. Команда `weaver registry check` проверяет реестр, `resolve` разворачивает его, `diff` сравнивает две версии. Команда `generate` выпускает по шаблонам код и документацию, например на Go или в Markdown, а `update-markdown` обновляет разделы Markdown-файлов по меткам. С живой телеметрией Weaver работает двумя командами. Команда `registry live-check` сверяет поток OTLP с реестром, `registry emit` отправляет примерные сигналы на ваш приемник OTLP. Команда `weaver registry mcp` запускает MCP-сервер с восемью инструментами. Инструмент `search` ищет по атрибутам, метрикам, спанам, событиям и сущностям, `get_attribute`, `get_metric`, `get_span`, `get_event` и `get_entity` возвращают подробности, `browse_namespace` показывает иерархию по префиксу, а `live_check` проверяет образцы телеметрии. Встроенные советники отмечают устаревшие и экспериментальные элементы, ошибки типов и недопустимые значения перечислений.
Для кого. Платформенным инженерам и авторам сервисов на OpenTelemetry, которые описывают свою телеметрию как публичный API и пишут инструментирование вместе с агентом.
Подходит, если
- Метрики переименовали в коде, а алерты остались прежними: такие расхождения хочется ловить в CI до релиза
- Агент пишет инструментирование HTTP-сервера и должен брать точные имена атрибутов из реестра
- Две версии реестра требуется сравнить и увидеть, что в них изменилось
- Приложение уже шлет OTLP, и нужно проверить, соответствуют ли сигналы схеме
- Таблицы атрибутов в документации должны обновляться из реестра автоматически
Не подходит, если
- Вам нужна пошаговая инструкция по подключению SDK OpenTelemetry к вашему языку: Weaver работает с реестрами и схемами
- Задача — запросы к данным в бэкенде метрик или трассировок: среди команд Weaver такого нет
- На машине нельзя запускать бинарные файлы и Docker, а собирать Weaver из исходников на Rust нет возможности
Пример запроса к агенту
Найди в реестре Weaver атрибуты для HTTP-сервера и проверь, что мои спаны используют эти именаОграничения
- Для режима MCP агенту указывают путь к бинарнику `weaver`, а свой реестр подключают аргументом `--registry`.
- Подробные шаги подключения даны только для Claude Code, для других клиентов их берут из документации клиента.
- Инструмент `live_check` сообщает о проблемах, а код инструментирования не правит.
- Готовые установщики для Linux, Windows и macOS лежат на странице релизов, образ Docker называется `otel/weaver`. Сборка из исходников требует Rust и `cargo`.
Как отключить. Уберите сервер командой `claude mcp remove weaver`. Образ Docker удаляется командой `docker rmi otel/weaver`, установленный бинарник — удалением файла.
Частые вопросы
Как подключить Weaver к Claude Code?
Выполните `claude mcp add --transport stdio weaver /path/to/weaver -- registry mcp`, подставив путь к бинарнику. Затем спросите агента про атрибуты HTTP-сервера, и он вызовет инструмент `search`.
Какие инструменты есть у MCP-сервера Weaver?
Восемь: `search`, `get_attribute`, `get_metric`, `get_span`, `get_event`, `get_entity`, `live_check` и `browse_namespace`. Основной из них `search`, он принимает запрос, тип, стабильность и лимит результатов, по умолчанию 20.
Можно ли проверить телеметрию приложения на соответствие реестру?
Да. Команда `registry live-check` принимает поток OTLP, а MCP-инструмент `live_check` проверяет переданные образцы и в режиме `findings_only` возвращает только замечания.
Как поставить Weaver?
Скачайте установщик для Linux, Windows или macOS со страницы релизов, выполните `docker pull otel/weaver` или соберите программу из исходников командой `cargo build --release`.
Что делает команда `weaver registry generate`?
Она выпускает артефакты из реестра по шаблонам: код, например на Go, и документацию в Markdown. Разделы в готовых Markdown-файлах обновляет `update-markdown`.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
CLI-инструментыЛокальная панель для Claude Code, Codex CLI, Gemini CLI, Copilot и OpenCode: токены, стоимость, задержки и ошибки
MCP Gateway Registry
mcp-gateway-registry
Единый реестр и шлюз для серверов MCP, агентов и скиллов: общий вход, OAuth, аудит и OpenTelemetry. Проект сообщества, развертывание в Docker и облаке
Маркетплейс плагинов OpenTelemetry для Claude Code, Codex, Copilot и других агентов: репозиторий сам проверяет и ведет релизы.
OpenTelemetry Agent Skills помогает подключать телеметрию, настраивать Collector и проверять версии по первичным источникам.
Драйвер слияния Git и MCP-сервер: сравнивает функции и классы и снимает ложные конфликты от параллельных правок агентов
CLI-трассировка сессий Claude Code, Cursor и Codex через OpenTelemetry: что агент реально делал и сколько это стоило
Коротко о README
README излагает идею observability by design: сигналы наблюдаемости рассматриваются как публичный API с теми же требованиями к качеству, что у кода. Затем идут установка из готовых сборок, Docker и исходников, список основных команд, примеры и ссылки на доклады проекта. Для CI есть действие setup-weaver.