diff --git a/config/_default/menus/main.en.yaml b/config/_default/menus/main.en.yaml index 562f9c1c464..2377c3d912d 100644 --- a/config/_default/menus/main.en.yaml +++ b/config/_default/menus/main.en.yaml @@ -2806,11 +2806,16 @@ menu: parent: oncall identifier: oncall_automations weight: 6 - - name: Profile Settings - url: incident_response/on-call/profile_settings/ + - name: Notification Preferences + url: incident_response/on-call/notification_preferences/ parent: oncall - identifier: oncall_profile_settings + identifier: oncall_notification_preferences weight: 7 + - name: Supported Countries + url: incident_response/on-call/notification_preferences/supported_countries/ + identifier: oncall_notification_preferences_countries + parent: oncall_notification_preferences + weight: 1 - name: Guides url: incident_response/on-call/guides/ parent: oncall diff --git a/content/en/account_management/billing/incident_response.md b/content/en/account_management/billing/incident_response.md index 92a1256da1a..4fd59142bb2 100644 --- a/content/en/account_management/billing/incident_response.md +++ b/content/en/account_management/billing/incident_response.md @@ -149,6 +149,6 @@ Your monthly bill contains the following: [4]: https://app.datadoghq.com/billing/seats [5]: /incident_response/on-call/schedules/ [6]: /incident_response/on-call/escalation_policies/ -[7]: /incident_response/on-call/profile_settings/#notification-preferences +[7]: /incident_response/on-call/notification_preferences/#notification-preferences [8]: /incident_response/incident_management/investigate/timeline [9]: https://app.datadoghq.com/on-call/settings/notifications-preferences-admin diff --git a/content/en/incident_response/on-call/_index.md b/content/en/incident_response/on-call/_index.md index eccccc97a14..7d5391c5a9c 100644 --- a/content/en/incident_response/on-call/_index.md +++ b/content/en/incident_response/on-call/_index.md @@ -85,14 +85,14 @@ To restrict access to an On-Call resource:
To preserve incident history, Datadog On-Call does not support deletion of resources like Pages, escalation policies, or schedules. To test On-Call without affecting your production environment, create a trial organization as a sandbox.
-To get started with On-Call, [onboard an On-Call Team][1] and ensure that all Team members configure their [On-Call profile settings][2] to receive notifications. +To get started with On-Call, [onboard an On-Call Team][1] and ensure that all Team members configure their [On-Call notification preferences][2] to receive notifications. {{< whatsnext desc="This section includes the following topics:">}} {{< nextlink href="/incident_response/on-call/teams">}}Onboard a Team: Create a new On-Call Team, add an existing Datadog Team to On-Call, or import a team from PagerDuty.{{< /nextlink >}} {{< nextlink href="/incident_response/on-call/pages">}}Pages: Trigger Pages from monitors, incidents, security signals, and other sources. Acknowledge, reassign, or resolve Pages, or promote them to incidents.{{< /nextlink >}} {{< nextlink href="/incident_response/on-call/escalation_policies">}}Escalation Policies: Define steps for how a Page is sent to different schedules. {{< /nextlink >}} {{< nextlink href="/incident_response/on-call/schedules">}}Schedules: Define timetables for Team members' on-call rotations.{{< /nextlink >}} - {{< nextlink href="/incident_response/on-call/profile_settings">}}Profile Settings: Configure your contact methods and notification preferences to ensure you receive timely and effective Pages.{{< /nextlink >}} + {{< nextlink href="/incident_response/on-call/notification_preferences">}}Notification Preferences: Configure your contact methods and notification preferences to ensure you receive timely and effective Pages.{{< /nextlink >}} {{< /whatsnext >}} ## Billing @@ -104,7 +104,7 @@ On-Call is a seat-based SKU. To learn more about how On-Call is billed and how t {{< partial name="whats-next/whats-next.html" >}} [1]: /incident_response/on-call/teams -[2]: /incident_response/on-call/profile_settings +[2]: /incident_response/on-call/notification_preferences [3]: /account_management/rbac/granular_access/ [4]: /account_management/rbac/#role-based-access-control [5]: https://www.datadoghq.com/pricing/?product=incident-response#products diff --git a/content/en/incident_response/on-call/profile_settings.md b/content/en/incident_response/on-call/notification_preferences/_index.md similarity index 73% rename from content/en/incident_response/on-call/profile_settings.md rename to content/en/incident_response/on-call/notification_preferences/_index.md index 0d3ed05bd6b..0b82abd8e78 100644 --- a/content/en/incident_response/on-call/profile_settings.md +++ b/content/en/incident_response/on-call/notification_preferences/_index.md @@ -1,7 +1,8 @@ --- -title: Profile Settings +title: Notification Preferences aliases: - /service_management/on-call/profile_settings/ +- /incident_response/on-call/profile_settings/ further_reading: - link: '/incident_response/on-call/' tag: 'Documentation' @@ -12,28 +13,28 @@ further_reading: To use Datadog On-Call on your mobile device, install the Datadog mobile app. -You must [configure your profile settings][1] before you can receive On-Call Pages. Your profile includes settings for contact methods, testing those methods, and notification preferences. These ensure that you receive timely and effective Pages. +You must [configure your notification preferences][1] before you can receive On-Call Pages. Your profile includes settings for contact methods, testing those methods, and notification preferences. These ensure that you receive timely and effective Pages. ## Configure your On-Call profile Go to [My On-Call Profile][1] to configure your settings. ### Contact methods -{{< img src="incident_response/on-call/profile_settings/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%;" >}} +{{< img src="incident_response/on-call/profile_settings/contact_methods.png" alt="Adding contact methods in On-Call notification preferences. 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 asks you for consent to reach you through SMS. If you consent, a green badge appears next to your phone number, indicating 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. -
-Phone number support varies by country. To see the supported list, open the phone number Prefix menu when adding a phone contact method in your On-Call profile. If your country does not appear, phone calls and SMS are not available for that location. -
- #### Supported contact methods - Push notifications through the [Datadog mobile app][3] - Emails (HTML or text format) - SMS (Note, landlines, Voice Over Internet Protocol (VoIP) or virtual numbers are not supported.) - Phone calls +
+Phone number support varies by country. See Supported Countries for the full list of supported countries, or open the phone number Prefix menu when adding a phone contact method in your On-Call profile. If your country does not appear, phone calls and SMS are not available for that location. +
+ To set up your mobile device, including how to **circumvent Do Not Disturb mode**, see [Set Up Your Mobile Device for Datadog On-Call][4]. ### Notification preferences @@ -42,7 +43,7 @@ Notification preferences allow you to tailor how and when **you** are alerted fo The system cycles 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="incident_response/on-call/profile_settings/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%;" >}} +{{< img src="incident_response/on-call/profile_settings/high_urgency_notification_preferences.png" alt="Configuring high urgency notification preferences in On-Call: '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%;" >}} Configure your high-urgency Pages (P1 monitor alerts, SEV-1 security threats, SEV-1 incidents, etc.), to demand immediate attention and escalation. @@ -58,12 +59,12 @@ For example, you can configure On-Call to start with a push notification, call a - Plan escalation policies carefully to avoid missed responses during emergencies. #### Low urgency notifications -{{< img src="incident_response/on-call/profile_settings/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%;" >}} +{{< img src="incident_response/on-call/profile_settings/low_urgency_notification_preferences.png" alt="Configuring low urgency notification preferences in On-Call: 'When a low urgency Page is triggered' set to notify an email immediately but don't escalate it further." style="width:100%;" >}} Configure your low-urgency Pages (non-blocking issues, informational signals, etc.), to minimize disruptions while ensuring you stay informed. For example, you can opt to only yourself through email. ### Other notifications -{{< img src="incident_response/on-call/profile_settings/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%;" >}} +{{< img src="incident_response/on-call/profile_settings/settings_shift_reminder.png" alt="Configuring a shift reminder in On-Call notification preferences. 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. diff --git a/content/en/incident_response/on-call/notification_preferences/supported_countries.md b/content/en/incident_response/on-call/notification_preferences/supported_countries.md new file mode 100644 index 00000000000..c8e516fe07a --- /dev/null +++ b/content/en/incident_response/on-call/notification_preferences/supported_countries.md @@ -0,0 +1,130 @@ +--- +title: Supported Countries +further_reading: +- link: '/incident_response/on-call/notification_preferences/' + tag: 'Documentation' + text: 'Notification Preferences' +- link: '/incident_response/on-call/' + tag: 'Documentation' + text: 'Datadog On-Call' +--- + +Datadog On-Call supports multiple notification channels for your contact methods: push notifications, email, SMS, and phone calls. See [Supported contact methods][1] to learn more. + +Support for SMS and phone call notifications varies by country because of local regulations and restrictions in that country. Use the following table to check whether your country is supported before adding a phone contact method to your On-Call profile. + +
+If your country isn't listed in the following table, contact Datadog Support to request phone number support for that country. +
+ +| Country | Country code | +|---|---| +| Albania | +355 | +| Andorra | +376 | +| Argentina | +54 | +| Armenia | +374 | +| Australia | +61 | +| Austria | +43 | +| Azerbaijan | +994 | +| Bahrain | +973 | +| Belgium | +32 | +| Bosnia and Herzegovina | +387 | +| Brazil | +55 | +| Bulgaria | +359 | +| Canada | +1 | +| Chile* | +56 | +| China* | +86 | +| Christmas Island | +61 | +| Cocos (Keeling) Islands | +61 | +| Colombia | +57 | +| Costa Rica | +506 | +| Croatia | +385 | +| Cyprus | +357 | +| Czech Republic | +420 | +| Denmark | +45 | +| Egypt | +20 | +| Estonia | +372 | +| Faroe Islands | +298 | +| Finland | +358 | +| France | +33 | +| Georgia | +995 | +| Germany | +49 | +| Gibraltar | +350 | +| Greece | +30 | +| Guam | +1 | +| Guernsey | +44 | +| Hong Kong | +852 | +| Hungary | +36 | +| Iceland | +354 | +| India | +91 | +| Indonesia | +62 | +| Ireland | +353 | +| Israel | +972 | +| Italy | +39 | +| Japan | +81 | +| Jersey | +44 | +| Jordan | +962 | +| Kazakhstan | +7 | +| Kenya | +254 | +| Kosovo | +383 | +| Latvia | +371 | +| Lebanon | +961 | +| Liechtenstein | +423 | +| Lithuania | +370 | +| Luxembourg | +352 | +| Malaysia | +60 | +| Malta | +356 | +| Mexico | +52 | +| Moldova | +373 | +| Monaco | +377 | +| Montenegro | +382 | +| Morocco | +212 | +| Netherlands | +31 | +| New Zealand | +64 | +| Nigeria* | +234 | +| North Macedonia | +389 | +| Norway | +47 | +| Pakistan | +92 | +| Palestine | +970 | +| Peru | +51 | +| Philippines | +63 | +| Poland | +48 | +| Portugal | +351 | +| Puerto Rico | +1 | +| Qatar | +974 | +| Romania | +40 | +| San Marino | +378 | +| Saudi Arabia | +966 | +| Serbia | +381 | +| Singapore | +65 | +| Slovakia | +421 | +| Slovenia | +386 | +| South Africa | +27 | +| South Korea | +82 | +| Spain | +34 | +| Sri Lanka | +94 | +| Svalbard and Jan Mayen | +47 | +| Sweden | +46 | +| Switzerland | +41 | +| Thailand | +66 | +| Tunisia | +216 | +| Turkey | +90 | +| U.S. Virgin Islands | +1 | +| Ukraine | +380 | +| United Arab Emirates | +971 | +| United Kingdom | +44 | +| United States | +1 | +| Uruguay* | +598 | +| Åland Islands | +358 | + +\* Partial support: Your ability to receive or respond to notifications in these countries might be limited. Datadog sends notification requests to its provider partners in these countries, but local SMS carrier restrictions or government regulations can limit delivery. For these regions, set up push notifications as your primary notification method. + +## Availability during trial + +During a free trial of On-Call, SMS and phone call notifications are not available for every country listed above. + +
+If you need to test On-Call in a country that isn't available during your trial, contact Datadog Support. +
+ +[1]: /incident_response/on-call/notification_preferences/#supported-contact-methods diff --git a/content/en/incident_response/on-call/schedules.md b/content/en/incident_response/on-call/schedules.md index b312bc23970..4217188c8c6 100644 --- a/content/en/incident_response/on-call/schedules.md +++ b/content/en/incident_response/on-call/schedules.md @@ -96,7 +96,7 @@ Your calendar is automatically updated if your on-call shifts change. To revoke ##### 🔔 Get Notified -Enable reminders for upcoming shifts in your calendar app. You can also configure custom shift notifications through SMS, push, or email in your [Datadog On-Call profile settings][6]. +Enable reminders for upcoming shifts in your calendar app. You can also configure custom shift notifications through SMS, push, or email in your [Datadog On-Call notification preferences][6]. #### Troubleshooting schedule exports @@ -121,4 +121,4 @@ When team members leave your organisation, they are not automatically removed fr [3]: https://support.google.com/calendar/answer/37100?hl=en&co=GENIE.Platform%3DDesktop [4]: https://support.microsoft.com/en-us/office/import-or-subscribe-to-a-calendar-in-outlook-com-or-outlook-on-the-web-cff1429c-5af6-41ec-a5b4-74f2c278e98c [5]: https://support.apple.com/en-us/102301 -[6]: /incident_response/on-call/profile_settings/ +[6]: /incident_response/on-call/notification_preferences/ diff --git a/content/en/incident_response/on-call/teams.md b/content/en/incident_response/on-call/teams.md index 58bd25aa736..da3b0617178 100644 --- a/content/en/incident_response/on-call/teams.md +++ b/content/en/incident_response/on-call/teams.md @@ -43,7 +43,7 @@ On-Call Teams are an extension of [Datadog Teams][1]. On-Call Teams are listed o Configure your monitors, incidents, or other resources to send Pages to your On-Call Team. See [Send a Page][7]. -Ensure that your On-Call Team members have set up their [Profile Settings][8]. +Ensure that your On-Call Team members have set up their [Notification Preferences][8]. ## Further Reading @@ -56,4 +56,4 @@ Ensure that your On-Call Team members have set up their [Profile Settings][8]. [5]: /incident_response/on-call/escalation_policies [6]: /incident_response/on-call/schedules [7]: /incident_response/on-call/pages/ -[8]: /incident_response/on-call/profile_settings \ No newline at end of file +[8]: /incident_response/on-call/notification_preferences \ No newline at end of file