Sentry в MonstarX

КраткоСоздайте в Sentry личный токен с правами на чтение и вставьте его в строку Sentry в разделе «Облачные сервисы» → «Облако». После этого конструктор MonstarX сможет показывать ваши организации и проекты, искать ошибки и подробно читать любую из них — достаточно сказать «исправь самую частую ошибку из Sentry». Он только читает.

Читает ошибки и инциденты из ваших проектов в Sentry.

Тип: Рабочий сервис · ключ API
Категория: Аналитика и мониторинг
Как подключить: Ключ API

Sentry записывает ошибки и сбои, которые происходят в программах, и группирует их в issues. Подключите его по токену (коду вроде пароля, через который программа читает ваш аккаунт Sentry), и конструктор MonstarX — ИИ, с которым вы общаетесь в чате, — сможет во время работы читать эти ошибки: посмотреть, что ломается у реальных пользователей, и исправить это, а вам не придётся копировать трассировки стека в чат.

Это рабочий сервис: MonstarX читает Sentry за вас. Само приложение, которое вы создаёте, ваш токен никогда не получает.

Что может MonstarX?

Что может MonstarX	Когда
Показать ваши организации	В любом режиме
Показать проекты организации	В любом режиме
Искать ошибки организации с помощью поисковых слов самого Sentry (например, `is:unresolved`), при желании — в одном проекте	В любом режиме
Подробно прочитать ошибку	В любом режиме

Чего MonstarX никогда не делает: не отмечает ошибки решёнными, не назначает, не игнорирует и не удаляет их, не меняет оповещения и настройки проектов и ничего не отправляет в Sentry.

Что понадобится

Аккаунт Sentry на sentry.io. Sentry на собственных серверах не поддерживается — MonstarX работает только с sentry.io.
Вы — владелец проекта в MonstarX. Подключать и отключать сервисы может только владелец.

Получите токен

В Sentry откройте User settings > Personal Tokens и создайте новый токен.
Дайте ему права на чтение: org:read (его MonstarX проверяет при подключении), project:read и event:read.
Сохраните и скопируйте токен.

Инструкции Sentry: Authentication и Permissions & scopes.

Подключите токен в MonstarX

Откройте проект, нажмите Облачные сервисы на верхней панели, затем Облако.
Прокрутите до раздела Подключения, найдите Sentry и нажмите Подключить.
Вставьте токен в поле Ключ API и нажмите Подключить.
MonstarX проверяет токен, запрашивая список ваших организаций. Если всё в порядке, в строке появится Подключено. Если токен отклонён, вы увидите ошибку, и ничего не сохранится.

Как попросить MonstarX

Вы пишете	Что происходит
«Какие главные нерешённые ошибки в моём проекте Sentry „booking-web“?»	MonstarX ищет ошибки и выводит список в чат.
«Прочитай ошибку 4512 в Sentry и исправь её.»	MonstarX читает подробности ошибки и в режиме Создать меняет код приложения, чтобы устранить причину.
«Какие у меня есть проекты в Sentry?»	MonstarX показывает ваши организации и их проекты.

Безопасность и конфиденциальность

Токен остаётся в MonstarX. Он хранится в зашифрованном виде на серверах MonstarX, никогда не попадает в код приложения и не передаётся самому приложению.
Только чтение. MonstarX только читает. Дайте токену только права на чтение — тогда даже утёкший токен не сможет ничего изменить в Sentry.
Только как информация. Тексты ошибок и данные событий MonstarX воспринимает как информацию, а не как инструкции.
Отключить можно в любой момент. Нажмите Отключить рядом с Sentry в разделе Облачные сервисыОблако и подтвердите вопрос Отключить Sentry от этого проекта?. MonstarX удалит токен. Если токен больше не нужен, отзовите его и в Sentry.

Полезно знать

Личный токен действует от вашего имени, поэтому MonstarX видит те организации и проекты, которые видите вы.
Называйте организацию или проект в просьбе — так MonstarX сэкономит шаг.
Для ошибок в приложении, которое вы создаёте в MonstarX, Sentry может вообще не понадобиться: MonstarX умеет читать собственные журналы приложения.

Вопросы и ответы

Может ли MonstarX отмечать ошибки в Sentry решёнными или назначать их?

Нет. Он может показывать организации и проекты, искать ошибки и читать их. Когда исправление будет опубликовано, отметьте ошибку решённой в Sentry сами.

Работает ли это с Sentry на собственном сервере?

Нет. Подключение работает только с sentry.io.

Может ли приложение отправлять свои ошибки в Sentry?

Это отдельная задача, это подключение для неё не нужно. Попросите MonstarX добавить в приложение отправку ошибок в Sentry: он запросит DSN или ключи вашего проекта, которые хранятся в разделе Облачные сервисы → Секреты. Подробнее — в статье Храните ключи API в разделе «Секреты».