Инструкция · Release Watchdog

Release Watchdog сравнивает логи сервиса до и после каждого релиза и сообщает о новых ошибках.

Быстрый старт

Регистрация и проектВход выполняется по почте и паролю. Логи, релизы и задания хранятся внутри проекта, поэтому сначала создаётся проект.
ЛогиВ разделе «Настройки → Логи» выбирается хранилище: VictoriaLogs, Grafana → Loki, CloudWatch или Datadog. Кнопка «Проверить» показывает первые строки, по которым видно, что логи читаются.
Источник релизовРелизы приходят из канала Slack или из CI/CD через вебхук. Канал выбирается в разделе «Настройки → Slack», вебхук — в разделе «Настройки → Релизы».
РазборКаждый релиз появляется на странице «Обзор и релизы». Через 30 минут после выката сервис разбирает логи и показывает итог. Этот интервал меняется в настройках релизов.

Возможности

Разбор релизаПоказывает новые ошибки и пропавшие события после выката. Кнопка «Разобрать сейчас» запускает разбор, не дожидаясь конца интервала.

ЗаданияУсловие записывается обычным текстом, например «письма уходят без ошибок». Сервис проверяет его по расписанию и пишет в Slack, только когда состояние меняется.

Команды в SlackЗадания можно создавать, проверять и выключать прямо из Slack: в канале или в личных сообщениях боту.

Агент через MCPClaude или другой агент получает доступ к логам и заданиям проекта по токену.

Статусы заданий

в порядке: Условие выполняется.
проблема: Условие нарушено. Подробности — в карточке задания.
событий не было: Сервисы за это время ничего не записали в логи, поэтому проверять нечего.
не проверить: Нужных логов нет. В карточке задания указано, каких именно.

Подробнее

Подключение Slack

В разделе «Настройки → Slack» кнопка «Открыть Slack» создаёт приложение с нужными правами. В Slack остаётся нажать Create, а затем Install to Workspace.
Токен бота (Bot User OAuth Token, начинается с xoxb-) вставляется в поле и подтверждается кнопкой «Подключить».
Затем выбирается канал для релизов. Приватный канал появляется в списке после того, как в нём выполнена команда /invite @Release Watchdog.

Номер версии бот находит в тексте сообщения в любой записи: «v0.1», «версия 1.2», «1.2.3».

Команды бота

В канале команда пишется с упоминанием бота, например @Release Watchdog задания. В личных сообщениях боту упоминание не нужно.

<условие текстом> — создать задание;
задания — показать список заданий;
проверь <название> — проверить задание сейчас;
выключи, включи или удали <название> — выключить, включить или удалить задание;
проект <название> — переключиться на другой проект (только в личных сообщениях).

Вебхук релизов из CI/CD

Токен вебхука выдаётся в разделе «Настройки → Релизы». После выката CI/CD отправляет запрос:

curl -X POST https://release-watchdog.r-d.12devs.net/api/hooks/release \
  -H "Authorization: Bearer <токен>" -H "Content-Type: application/json" \
  -d '{"version": "1.4.0", "text": "Что вошло в релиз"}'

Вместо такого запроса можно передавать стандартное событие релиза GitHub.

MCP и API

Токен выдаётся в разделе «Настройки → API и MCP». Команда для подключения к Claude Code:

claude mcp add --transport http watchdog https://release-watchdog.r-d.12devs.net/mcp \
  --header "Authorization: Bearer <токен>"

С тем же токеном доступен API по адресу https://release-watchdog.r-d.12devs.net/api/v1/tasks: список заданий, создание, проверка и история проверок.

Jira

В разделе «Настройки → Jira» указываются адрес Jira, почта, API-токен и ключ проекта. После этого тикет можно завести из карточки задания вручную или настроить автоматическое создание, когда задание переходит в статус «проблема».