Sentry

Навык Sentry предназначен для read-only наблюдения за production-ошибками через Sentry API. Он подходит для запроса списка issues и events, разбора одной issue или отдельного события, а также для краткой сводки состояния Sentry за выбранный период. Источник описывает его как инструмент для случаев, когда нужно посмотреть проблемы, события, недавние production-ошибки или базовые health-данные, не выполняя изменений в Sentry. Основной способ работы — bundled-скрипт scripts/sentry_api.py; он выполняет детерминированные API-вызовы, обрабатывает пагинацию и один раз повторяет запрос при временной ошибке. Такой порядок полезен для повторяемой диагностики: сначала можно получить issues с сортировкой по последней активности, затем разрешить короткий идентификатор вроде ABC-123 в полный id, запросить детали issue и только после этого получить связанные events. Для списка issues задаются организация, проект, окружение, период, лимит и необязательный поисковый запрос. Для issue detail достаточно организации и id, для issue events нужны организация, id, окружение, период и лимит, а для event detail — организация, проект и id события. В API используются только GET-эндпоинты: список проектов и issues проекта, детали issue организации, события issue и детали события проекта. В результате списка рекомендуется показывать title, short_id, status, first_seen, last_seen, count, environments и top_tags. Детали события должны включать culprit, timestamp, environment, release и url. Если результатов нет, это нужно сообщить явно, а не выдавать пустой или предположительный диагноз. Для доступа требуется SENTRY_AUTH_TOKEN; источник рекомендует read-only scopes project:read и event:read, а также допускает org:read. Токен задаётся в переменной окружения, его нельзя выводить или передавать в чат. Необязательные переменные SENTRY_ORG, SENTRY_PROJECT и SENTRY_BASE_URL позволяют задать организацию, проект и базовый URL; значения по умолчанию для организации и проекта являются заполнителями и требуют настройки. Период по умолчанию — 24 часа, окружение — prod, лимит — 20 результатов, максимальный лимит — 50. Навык прямо требует обращаться к Sentry API, а не заменять запрос эвристикой, кэшем или догадкой. При выводе нужно редактировать персональные данные, включая email и IP-адреса, и не печатать сырые stack traces. Поэтому его назначение — безопасное чтение и компактное представление наблюдаемости, а не исправление, закрытие или изменение issues.