2020-09-30 20:10:16 -04:00
---
stage: Monitor
2022-01-27 13:14:37 -05:00
group: Respond
2020-11-26 01:09:20 -05:00
info: To determine the technical writer assigned to the Stage/Group associated with this page, see https://about.gitlab.com/handbook/engineering/ux/technical-writing/#assignments
2020-09-30 20:10:16 -04:00
---
2021-01-28 01:08:59 -05:00
# Paging and notifications **(FREE)**
2020-09-30 20:10:16 -04:00
2020-10-14 14:08:47 -04:00
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.
2020-09-30 20:10:16 -04:00
## Slack notifications
> [Introduced](https://gitlab.com/gitlab-org/gitlab/-/issues/216326) in GitLab 13.1.
2020-10-14 14:08:47 -04:00
Responders can be paged via Slack using the
[Slack Notifications Service ](../../user/project/integrations/slack.md ), which you
can configure for new alerts and new incidents. After configuring, responders
receive a **single** page via Slack. To set up Slack notifications on your mobile
device, make sure to enable notifications for the Slack app on your phone so
you never miss a page.
2020-09-30 20:10:16 -04:00
2022-03-16 14:08:16 -04:00
## Email notifications for alerts
2020-09-30 20:10:16 -04:00
2021-03-04 16:08:59 -05:00
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.
2020-09-30 20:10:16 -04:00
2021-08-16 14:10:51 -04:00
1. On the top bar, select **Menu > Projects** and find your project.
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.
2020-09-30 20:10:16 -04:00
1. Select **Save changes** .
2021-03-16 14:11:53 -04:00
2022-03-16 14:08:16 -04:00
[Update the alert's status ](alerts.md#update-an-alerts-status ) to manage email notifications for an alert.
2021-03-16 14:11:53 -04:00
## Paging **(PREMIUM)**
2022-03-16 14:08:16 -04:00
In projects that have an [escalation policy ](escalation_policies.md ) configured, on-call responder(s)
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
or stop alert escalations by [updating the alert's status ](alerts.md#update-an-alerts-status ).
### Escalating an incident
> [Introduced](https://gitlab.com/groups/gitlab-org/-/epics/5716) in GitLab 14.9.
For incidents, paging on-call responders is optional for each individual incident.
To begin escalating the incident, [set the incident's escalation policy ](incidents.md#change-escalation-policy ).
For each escalation rule, the designated on-call responders receive one email when
the rule fires. You can respond to a page or stop incident escalations by
[updating the incident's status ](incidents.md#change-incident-status ) or, if applicable,
[unsetting the incident's escalation policy ](incidents.md#change-escalation-policy ).
To avoid duplicate pages, [incidents created from alerts ](alerts.md#create-an-incident-from-an-alert ) do not support independent escalation.
Instead, the status and escalation policy fields are synced between the alert and the incident.