Настройте базовую интеграцию оповещений со Slack, Jira и PagerDuty.

Firebase предлагает базовые интеграции для отправки оповещений Crashlytics в Slack, Jira и PagerDuty.

В общих чертах, вот как настроить и сконфигурировать эти интеграции в консоли Firebase :

  1. Следуйте пошаговой инструкции для каждой службы на вкладке «Интеграции» в вашем приложении. проекта .

  2. Выберите конфигурацию, которая будет использоваться для отдельных приложений, и настройте место назначения других оповещений на карточке Crashlytics на вкладке « Оповещения» в вашем приложении. проекта .


Остальная часть этой страницы подробно описывает, как настроить каждую базовую интеграцию системы оповещений.

Slack Jira PagerDuty



Настройте базовую интеграцию со Slack.

Пример оповещения Crashlytics в канал Slack

После настройки интеграции Firebase со Slack ваш проект сможет отправлять сообщения в ваше рабочее пространство Slack в ответ на события, сообщаемые Crashlytics , такие как новые, регрессировавшие или ускоряющие реагирование проблемы.

Шаг 1 : Настройте веб-перехватчик Slack.

Прежде чем настраивать интеграцию в Firebase, необходимо добавить входящий веб-хук в Slack для обработки сообщений от Firebase.

Чтобы узнать, как это сделать, ознакомьтесь с документацией Slack по отправке сообщений с помощью входящих веб-хуков .

Шаг 2 : Настройте интеграцию со Slack в консоли Firebase

После настройки соответствующего веб-хука вы готовы к настройке интеграции с Crashlytics :

  1. Войдите в консоль Firebase , затем выберите свой проект.

  2. Нажмите , затем выберите «Настройки проекта» .

  3. Выберите вкладку «Интеграции» .

  4. На карточке интеграции со Slack нажмите «Установить» .

  5. Настройте интеграцию, задав значения в следующих полях:

    • URL веб-перехватчика : Вставьте URL веб-перехватчика со страницы настроек Slack.

    • Канал по умолчанию : Введите название канала. Вы можете изменить это значение по умолчанию позже для каждого приложения или для каждого оповещения отдельно.

    • Имя пользователя, отправляющего сообщения : Введите имя, под которым будут отправляться сообщения.

  6. Нажмите «Проверить и сохранить» .

После проверки и сохранения интеграции со Slack вы должны увидеть подтверждающее сообщение в выбранном вами канале по умолчанию.

Шаг 3 : Настройка параметров оповещений для Slack

Вы можете настроить оповещения по типу приложения и события. Например, вы можете отключить оповещения в тестовом приложении или перенаправлять приоритетные оповещения в рабочем приложении в канал #urgent .

Типы событий

Интеграция Firebase со Slack позволяет отправлять оповещения в ответ на следующие типы событий:

  • Новые критические проблемы : возникают, когда ваше приложение аварийно завершает работу или происходит ANR-реагирование, которое Crashlytics ранее не обнаруживал.

  • Новые некритические проблемы : срабатывают, когда в вашем приложении возникает некритическая проблема, которую Crashlytics ранее не встречал.

  • Проблемы, возникшие в процессе работы приложения : они появляются, когда приложение аварийно завершает работу, хотя вы ранее отметили эти проблемы как закрытые.

  • Актуальные проблемы : активируются, когда возникает новая или набирающая популярность проблема.

  • Проблемы, связанные с увеличением скорости работы : возникают, когда единичный сбой или тип ANR затрагивает определенный процент пользователей в течение 30-минутного периода для данной версии приложения.

Настройте параметры для каждого приложения.

Вот как настроить оповещения для каждого приложения в вашем проекте Firebase:

  1. Войдите в консоль Firebase , затем выберите свой проект.

  2. Нажмите , затем выберите «Настройки проекта» .

  3. Выберите вкладку «Оповещения» .

  4. Перейдите к карточке оповещений Crashlytics . Выберите приложение, которое хотите настроить, из выпадающего меню.

  5. Выберите канал Slack, куда вы хотите отправлять оповещения для этого приложения.

  6. Для каждого типа оповещения выберите в раскрывающемся списке, хотите ли вы отправлять этот тип оповещения в Slack.

  7. Повторите эти шаги для каждого приложения, которое вы хотите настроить.

Вот и всё! Firebase будет отправлять оповещения в указанные вами каналы Slack, если в ваших приложениях появятся новые проблемы, проблемы, которые ухудшились, или проблемы, скорость разработки которых возрастет.



Настройте базовую интеграцию с Jira.

После настройки интеграции Firebase с Jira ваш проект Firebase сможет отправлять сообщения в проект Jira в ответ на события, сообщаемые Crashlytics , такие как новые, регрессировавшие или ускоряющие выполнение задачи. Вы также можете связать отдельные задачи Crashlytics с задачами Jira.

Шаг 1 : Подготовка Jira к интеграции с Firebase

Создайте API-токен (только для Jira Cloud)

Прежде чем настраивать интеграцию в Firebase, необходимо сгенерировать API-токен в Jira Cloud.

  1. В консоли Jira откройте настройки API-токенов .

  2. Нажмите «Создать API-токен» .

  3. Сохраните этот API-токен в надежном месте, он понадобится вам позже.

Создайте тип проблемы «Ошибка».

Интеграция Firebase с Jira создает задачи типа Bug . Вам необходимо создать этот тип задачи в вашем проекте Jira (если он еще не существует).

  1. В консоли Jira перейдите в раздел «Настройки проекта» .

  2. Нажмите «Типы проблем» .

  3. Нажмите «Добавить тип проблемы» .

  4. Выберите «Ошибка» или введите её вручную.

Шаг 2 : Настройте интеграцию с Jira в консоли Firebase

Настройте интеграцию Jira для Jira Cloud или для Jira Server .

Jira Cloud

  1. Войдите в консоль Firebase , затем выберите свой проект.

  2. Нажмите , затем выберите «Настройки проекта» .

  3. Выберите вкладку «Интеграции» .

  4. На карточке интеграции с Jira нажмите «Установить» .

  5. Нажмите «Настроить интеграцию с Jira» .

  6. Введите URL-адрес вашего проекта Jira в следующем формате: https:// WORKSPACE_NAME .atlassian.net/projects/ PROJECT_KEY

  7. Введите адрес электронной почты, с которого вы авторизуетесь в Jira, и ваш API-токен.

  8. Нажмите «Проверить и сохранить» .

Сервер Jira

  1. Войдите в консоль Firebase , затем выберите свой проект.

  2. Нажмите , затем выберите «Настройки проекта» .

  3. Выберите вкладку «Интеграции» .

  4. На карточке интеграции с Jira нажмите «Установить» .

  5. Нажмите «Настроить интеграцию с Jira» .

  6. Введите URL-адрес вашего проекта Jira в следующем формате: https:// SERVER_NAME.com /projects/ PROJECT_KEY

  7. Введите адрес электронной почты, с которого вы авторизуетесь в Jira, и ваш API-токен.

  8. Нажмите «Проверить и сохранить» .

Шаг 3 : Настройка параметров оповещений для Jira

Вы можете настроить оповещения по типу приложения и события. Например, вы можете отключить оповещения в тестовом приложении или перенаправлять оповещения о разных приложениях в разные проекты Jira.

Типы событий

Интеграция Firebase с Jira позволяет отправлять оповещения в ответ на следующие типы событий:

  • Новые критические проблемы : возникают, когда ваше приложение аварийно завершает работу или происходит ANR-реагирование, которое Crashlytics ранее не обнаруживал.

  • Новые некритические проблемы : срабатывают, когда в вашем приложении возникает некритическая проблема, которую Crashlytics ранее не встречал.

  • Проблемы, возникшие в процессе работы приложения : они появляются, когда приложение аварийно завершает работу, хотя вы ранее отметили эти проблемы как закрытые.

  • Актуальные проблемы : активируются, когда возникает новая или набирающая популярность проблема.

  • Проблемы, связанные с увеличением скорости работы : возникают, когда единичный сбой или тип ANR затрагивает определенный процент пользователей в течение 30-минутного периода для данной версии приложения.

Настройте параметры для каждого приложения.

Вот как настроить оповещения для каждого приложения в вашем проекте Firebase:

  1. Войдите в консоль Firebase , затем выберите свой проект.

  2. Нажмите , затем выберите «Настройки проекта» .

  3. Выберите вкладку «Оповещения» .

  4. Перейдите к карточке оповещений Crashlytics . Выберите приложение, которое хотите настроить, из выпадающего меню.

  5. Выберите проект Jira, в который вы хотите отправлять оповещения для этого приложения.

  6. Для каждого типа оповещения выберите в раскрывающемся списке, хотите ли вы отправлять этот тип оповещения в Jira.

  7. Повторите эти шаги для каждого приложения, которое вы хотите настроить.

Вот и всё! Firebase будет отправлять оповещения в указанные вами проекты Jira, если в ваших приложениях появятся новые, регрессировавшие или быстро развивающиеся задачи.

Помимо автоматически создаваемых задач Jira, которые генерирует Firebase, можно связать ваши задачи Crashlytics с существующими задачами Jira. Вы также можете создать новую задачу Jira из консоли Firebase . Перед использованием этой функции необходимо включить интеграцию с Jira.

  1. Перейдите к задаче Crashlytics , которую вы хотите связать с задачей Jira.

  2. Нажмите на ссылку Jira .

  3. Либо нажмите кнопку «Создать задачу в проекте» , либо вставьте URL-адрес вашей задачи Jira или ключ задачи в предоставленное поле.

  1. Перейдите к задаче Crashlytics , которую вы хотите отвязать от Jira.

  2. Нажмите на ссылку "Связанный вопрос" .

  3. Нажмите «Подробнее» и выберите «Отключить» .



Настройте базовую интеграцию с PagerDuty.

После настройки интеграции Firebase с PagerDuty ваш проект Firebase позволит PagerDuty отправлять оповещения дежурным специалистам в ответ на события, сообщаемые Crashlytics , такие как новые, регрессировавшие или увеличивающиеся по скорости проблемы.

Шаг 1 : Настройте интеграцию PagerDuty в консоли Firebase

  1. Войдите в консоль Firebase , затем выберите свой проект.

  2. Нажмите , затем выберите «Настройки проекта» .

  3. Выберите вкладку «Интеграции» .

  4. На карточке интеграции PagerDuty нажмите «Установить» .

  5. Следуйте инструкциям на экране, чтобы настроить интеграцию.

  6. Нажмите «Проверить и сохранить» .

Шаг 2 : Настройка параметров оповещений для PagerDuty

Вы можете настроить оповещения по типу приложения и события. Например, вы можете отключить оповещения в тестовом приложении или перенаправлять оповещения о разных приложениях в разные проекты PagerDuty.

Типы событий

Интеграция Firebase с PagerDuty позволяет отправлять оповещения в ответ на следующие типы событий:

  • Новые критические проблемы : возникают, когда ваше приложение аварийно завершает работу или происходит ANR-реагирование, которое Crashlytics ранее не обнаруживал.

  • Новые некритические проблемы : срабатывают, когда в вашем приложении возникает некритическая проблема, которую Crashlytics ранее не встречал.

  • Проблемы, возникшие в процессе работы приложения : они появляются, когда приложение аварийно завершает работу, хотя вы ранее отметили эти проблемы как закрытые.

  • Актуальные проблемы : активируются, когда возникает новая или набирающая популярность проблема.

  • Проблемы, связанные с увеличением скорости работы : возникают, когда единичный сбой или тип ANR затрагивает определенный процент пользователей в течение 30-минутного периода для данной версии приложения.

Настройте параметры для каждого приложения.

Вот как настроить оповещения для каждого приложения в вашем проекте Firebase:

  1. Войдите в консоль Firebase , затем выберите свой проект.

  2. Нажмите , затем выберите «Настройки проекта» .

  3. Выберите вкладку «Оповещения» .

  4. Перейдите к карточке оповещений Crashlytics . Выберите приложение, которое хотите настроить, из выпадающего меню.

  5. Выберите службу PagerDuty, куда вы хотите отправлять оповещения для этого приложения.

  6. Для каждого типа оповещения выберите в раскрывающемся списке, хотите ли вы отправлять этот тип оповещения в PagerDuty.

  7. Повторите эти шаги для каждого приложения, которое вы хотите настроить.

Вот и всё! Firebase будет отправлять сообщения об ошибках в указанный вами сервис PagerDuty, если в ваших приложениях появятся новые, ухудшившиеся или быстро развивающиеся проблемы.