Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

[Draft] Better documentation for notification preferences for On-Call #26907

Draft
wants to merge 4 commits into
base: master
Choose a base branch
from
Draft
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
9 changes: 9 additions & 0 deletions content/en/service_management/on-call/guides/_index.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,9 @@
---
title: On-Call Guides
private: false
disable_toc: true
---

{{< whatsnext desc="General guides:">}}
{{< nextlink href="/service_management/on-call/guides/circumvent-dnd" >}}Circumvent Do Not Disturb Mode on your mobile device{{< /nextlink >}}
{{< /whatsnext >}}
11 changes: 11 additions & 0 deletions content/en/service_management/on-call/guides/circumvent-dnd.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,11 @@
---
title: Circumvent Do Not Disturb Mode on your mobile device
description: "Still need to figure this one out."
further_reading:
- link: "https://docs.datadoghq.com/service_management/on-call/"
tag: "Documentation"
text: "On-Call Documentation"
---

## Overview
Init blog
52 changes: 40 additions & 12 deletions content/en/service_management/on-call/profile_settings.md
Original file line number Diff line number Diff line change
Expand Up @@ -16,34 +16,62 @@ You must [configure your profile settings][1] before you can receive On-Call Pag

Go to [My On-Call Profile][1] to configure your settings.

<div class="alert alert-info">
Make sure you download the Datadog <a href="/mobile#installing">mobile app</a> to acknowledge Pages on the go, review the impact of the alert alongside relevant observability data, and effectively triage the alert
</div>

### Contact methods
{{< img src="service_management/oncall/settings_contact.png" alt="Adding contact methods in On-Call profile settings. A phone number and an email are configured. The phone number is in a hover state, displaying 'Test Call' and 'Test SMS' options." style="width:100%;" >}}
- You must manually add your email or phone number.
{{< img src="service_management/oncall/contact_methods.png" alt="Adding contact methods in On-Call profile settings. A phone number, an email, and a mobile device are configured. The phone number is in a hover state, displaying 'Test Call' and 'Test SMS' options." style="width:100%;" >}}
- You must manually add your email or phone number. Afterwards, the screen will ask you for consent to reach you through SMS. If you consent, a green badge will appear next to your phone numbers, indicated that it can be used for SMS notification preferences below.
- If the Datadog [mobile app][2] is installed on your device, your device appears automatically in this list. Check your settings in the mobile app to ensure that your device can receive notifications.
- Datadog recommends that you test each of your contact methods. Hover over your contact method for test options.

Supported contact methods are:
- Push notifications through the [Datadog mobile app][3]
- Emails (HTML or text format)
- SMS
- Phone calls

To **circumvent Do Not Disturb mode** on your mobile devices, follow this [guide][4].

### Notification preferences
{{< img src="service_management/oncall/settings_preferences.png" alt="Configuring notification preferences in On-Call profile settings. Two configurations: 'When a high urgency Page is triggered' set to notify a phone number immediately, and 'When a low urgency Page is triggered' set to notify an email after one minute." style="width:100%;" >}}
The **Notification Preferences** feature allows you to tailor how and when **you** are alerted for On-Call Pages based on the urgency of the situation. By configuring preferences for low urgency and high urgency, you can ensure that notifications are effective and unobtrusive, depending on the urgency of the Page. Note, the urgency of a Page is determined within your [Routing Rules][5].

The system will continue cycling through your configured notification preferences until you either acknowledge the Page or the Page is escalated to the next on-call person as defined in the [Escalation Policy][6].

#### High urgency notifications
{{< img src="service_management/oncall/high_urgency_notification_preferences.png" alt="Configuring high urgency notification preferences in On-Call profile settings: 'When a high urgency Page is triggered' set to notify a phone number immediately in order to quickly respond to critical Pages." style="width:100%;" >}}

For critical Pages (e.g., P1 monitor alerts, SEV-1 security threats, or SEV-1 incidents), notifications are configured to demand immediate attention and escalation.

Configure **Notification Preferences** to control when and how you receive On-Call related notifications, depending on the urgency of the Page.
Example Preferences:
1. Page Me Immediately: Start with a push notification to ensure you can directly investigate any issue, on the fly, with Datadog's mobile app.
2. Call Me: After one minute, place a phone call to ensure you are alerted in real time.
3. Send a Follow-Up Alert: If unacknowledged after 2 minutes, send a push notification and call again.
4. Repeat.

Best Practices for High Urgency:
• Use immediate push notifications and phone calls as the primary notification method for critical Pages.
• Keep follow-up intervals short to ensure rapid acknowledgment.
• Plan escalation policies carefully to avoid missed responses during emergencies.

#### Low urgency notifications
{{< img src="service_management/oncall/low_urgency_notification_preferences.png" alt="Configuring low urgency notification preferences in On-Call profile settings: 'When a low urgency Page is triggered' set to notify an email immediately but don't escalate it further." style="width:100%;" >}}

For less critical Pages (e.g., non-blocking issues or informational signals), you can configure notification preferences to minimize disruptions while ensuring you stay informed, for instance by notifying yourself solely via emails.

### Other notifications
{{< img src="service_management/oncall/settings_shift_reminder.png" alt="Configuring a shift reminder in On-Call profile settings. A shift reminder is configured to notify a phone number 10 minutes before the shift begins." style="width:100%;" >}}

Under **Other Notifications**, you can opt to receive a **Shift reminder** before your On-Call shift begins.

### Supported notification methods

Datadog supports:
- Push notifications through the [Datadog mobile app][3]
- Emails (HTML or text format)
- SMS
- Phone calls

## Further Reading

{{< partial name="whats-next/whats-next.html" >}}

[1]: https://app.datadoghq.com/on-call/profile
[2]: /service_management/mobile/?tab=ios
[3]: /mobile
[4]: /service_management/on-call/guides/circumvent-dnd
[5]: /service_management/on-call/routing_rules
[6]: /service_management/on-call/escalation_policies
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading