debian-mirror-gitlab/doc/operations/incident_management/paging.md

Ignoring revisions in .git-blame-ignore-revs. Click here to bypass and see the normal blame view.

68 lines
3.3 KiB
Markdown
Raw Normal View History

2021-03-11 19:13:27 +05:30
---
stage: Monitor
2022-04-04 11:22:00 +05:30
group: Respond
2022-11-25 23:54:43 +05:30
info: To determine the technical writer assigned to the Stage/Group associated with this page, see https://about.gitlab.com/handbook/product/ux/technical-writing/#assignments
2021-03-11 19:13:27 +05:30
---
# Paging and notifications **(FREE)**
When there is a new alert or incident, it is important for a responder to be notified
immediately so they can triage and respond to the problem. Responders can receive
notifications using the methods described on this page.
## Slack notifications
> [Introduced](https://gitlab.com/gitlab-org/gitlab/-/issues/216326) in GitLab 13.1.
2023-03-04 22:38:38 +05:30
The GitLab for Slack app can be used to receive important incident notifications.
When [the GitLab for Slack app is configured](slack.md), incident responders are notified in Slack
every time a new incident is declared. To ensure you don't miss any important incident notifications
on your mobile device, enable notifications for Slack on your phone.
2021-03-11 19:13:27 +05:30
2022-05-07 20:08:51 +05:30
## Email notifications for alerts
2021-03-11 19:13:27 +05:30
2021-04-17 20:07:23 +05:30
Email notifications are available in projects for triggered alerts. Project
members with the **Owner** or **Maintainer** roles have the option to receive
a single email notification for new alerts.
2021-03-11 19:13:27 +05:30
2022-10-11 01:57:18 +05:30
1. On the top bar, select **Main menu > Projects** and find your project.
2021-10-27 15:23:28 +05:30
1. On the left sidebar, select **Settings > Monitor**.
1. Expand **Alerts**.
1. On the **Alert settings** tab, select the
**Send a single email notification to Owners and Maintainers for new alerts** checkbox.
2021-03-11 19:13:27 +05:30
1. Select **Save changes**.
2021-04-29 21:17:54 +05:30
2023-01-13 00:05:48 +05:30
[Update the alert's status](alerts.md#change-an-alerts-status) to manage email notifications for an alert.
2022-05-07 20:08:51 +05:30
2021-04-29 21:17:54 +05:30
## Paging **(PREMIUM)**
2022-07-16 23:28:13 +05:30
In projects that have an [escalation policy](escalation_policies.md) configured, on-call responders
2022-05-07 20:08:51 +05:30
can be automatically paged about critical problems through email.
### Escalating an alert
When an alert is triggered, it begins escalating to the on-call responders immediately.
For each escalation rule in the project's escalation policy, the designated on-call
responders receive one email when the rule fires. You can respond to a page
2023-01-13 00:05:48 +05:30
or stop alert escalations by [updating the alert's status](alerts.md#change-an-alerts-status).
2022-05-07 20:08:51 +05:30
### Escalating an incident
2022-06-21 17:19:12 +05:30
> - [Introduced](https://gitlab.com/groups/gitlab-org/-/epics/5716) in GitLab 14.9 [with a flag](../../administration/feature_flags.md) named `incident_escalations`. Disabled by default.
> - [Enabled on GitLab.com and self-managed](https://gitlab.com/gitlab-org/gitlab/-/issues/345769) in GitLab 14.10.
2022-07-23 23:45:48 +05:30
> - [Feature flag `incident_escalations`](https://gitlab.com/gitlab-org/gitlab/-/issues/345769) removed in GitLab 15.1.
2022-05-07 20:08:51 +05:30
For incidents, paging on-call responders is optional for each individual incident.
2023-03-04 22:38:38 +05:30
To begin escalating the incident, [set the incident's escalation policy](manage_incidents.md#change-escalation-policy).
2022-05-07 20:08:51 +05:30
For each escalation rule, the designated on-call responders receive one email when
2023-03-04 22:38:38 +05:30
the rule fires. Respond to a page or stop incident escalations by
[changing the incident's status](manage_incidents.md#change-status) or
changing the incident's escalation policy back to **No escalation policy**.
2022-05-07 20:08:51 +05:30
2023-03-04 22:38:38 +05:30
In GitLab 15.1 and earlier, [incidents created from alerts](manage_incidents.md#from-an-alert)
2022-08-13 15:12:31 +05:30
do not support independent escalation. In [GitLab 15.2 and later](https://gitlab.com/gitlab-org/gitlab/-/issues/356057),
all incidents can be escalated independently.