-
Notifications
You must be signed in to change notification settings - Fork 1.2k
Mobile app faq notes #31182
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
Merged
Merged
Mobile app faq notes #31182
Changes from all commits
Commits
Show all changes
10 commits
Select commit
Hold shift + click to select a range
5d1cbee
Mobile app faq notes
NancyZ278 09e907f
Update _index.md
NancyZ278 6c9fcb2
Update configure-mobile-device-for-on-call.md
NancyZ278 2367f51
Create configure-mobile-device-for-on-call.md
NancyZ278 edd9caf
Update content/en/mobile/_index.md
NancyZ278 5a33380
Update content/en/mobile/guide/configure-mobile-device-for-on-call.md
NancyZ278 59c824e
Update content/en/mobile/guide/configure-mobile-device-for-on-call.md
NancyZ278 c48e8e8
Update content/en/mobile/widgets.md
NancyZ278 536812d
Merge branch 'master' into nancy.zhu/faq_mobile
NancyZ278 c2252f7
Update _index.md
NancyZ278 File filter
Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
There are no files selected for viewing
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
153 changes: 153 additions & 0 deletions
153
content/en/mobile/guide/configure-mobile-device-for-on-call.md
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,153 @@ | ||
--- | ||
title: Set Up Your Mobile Device for Datadog On-Call | ||
further_reading: | ||
- link: "https://docs.datadoghq.com/service_management/on-call/" | ||
tag: "Documentation" | ||
text: "On-Call Documentation" | ||
- link: "https://docs.datadoghq.com/service_management/mobile/" | ||
tag: "Documentation" | ||
text: "Mobile App Documentation" | ||
--- | ||
|
||
Being on-call requires reliable and timely notifications to ensure you can respond to incidents effectively. This guide walks you through the steps to configure your mobile device for optimal performance with [Datadog On-Call][5]. | ||
|
||
1. Install the [Datadog mobile app][1]. | ||
2. [Set up push notifications](#set-up-push-notifications): Enable your device to receive notifications from the Datadog mobile app. | ||
3. [Circumvent mute and Do Not Disturb mode](#circumvent-mute-and-do-not-disturb-mode-for-on-call): Receive push notifications, voice calls, and SMS while your device is in Do Not Disturb mode. | ||
|
||
## Set up push notifications | ||
<div class="alert alert-info"> | ||
When you log into the Datadog mobile app for the first time, an onboarding flow takes care of notification settings and permissions. | ||
</div> | ||
|
||
However, by default, the mobile app is not allowed to send you notifications. To receive push notifications: | ||
|
||
{{< tabs >}} | ||
{{% tab "iOS" %}} | ||
|
||
1. In the Datadog mobile app, navigate to **Settings** > **Notifications**. | ||
|
||
{{< img src="service_management/mobile/ios_settings_may_2025.png" alt="Find the notification settings in the iOS version of Datadog's mobile app." style="width:35%;" >}} | ||
|
||
2. Enable the **Allow Notifications** toggle. If this is your first time enabling notifications, this opens up a permissions prompt. Grant permission, then touch **Enable Notifications** again to go to the iOS system settings. | ||
|
||
{{< img src="service_management/mobile/ios_notification_may_2025.png" alt="Configure the system notification settings of your iOS device." style="width:100%;" >}} | ||
|
||
3. Within the iOS system settings, make sure you enable the **Allow Notifications** toggle. Datadog highly recommends you also enable the **Sound** and **Badges** toggles. | ||
|
||
Make sure you grant the mobile app the necessary permissions. | ||
{{% /tab %}} | ||
|
||
{{% tab "Android" %}} | ||
1. In the Datadog mobile app, navigate to **Settings** > **Notifications**. | ||
|
||
{{< img src="service_management/mobile/android_settings_may_2025.png" alt="Find the notification settings in the Android version of Datadog's mobile app." style="width:35%;" >}} | ||
|
||
2. Enable the **Allow notifications** toggle. Datadog highly recommends you also enable **Sound and vibration** and **Show content on Lock screen**. | ||
|
||
{{< img src="service_management/mobile/android_notification_may_2025.png" alt="Configure the system notification settings of your Android device." style="width:100%;" >}} | ||
|
||
{{% /tab %}} | ||
{{< /tabs >}} | ||
|
||
### Custom sounds | ||
On both iOS and Android, you have the option to override the default system notification sounds. The Datadog app comes preloaded with a selection of custom sounds. | ||
|
||
## Circumvent mute and Do Not Disturb mode for On-Call | ||
You can override your device's system volume and Do Not Disturb mode for both push notifications (from the Datadog mobile app) and telephony notifications (such as voice call and SMS). | ||
|
||
### Critical push notifications | ||
{{< tabs >}} | ||
{{% tab "iOS" %}} | ||
|
||
{{< img src="service_management/mobile/ios_critical_may_2025.png" alt="Override your iOS device's system volume and do-not-disturb mode." style="width:100%;" >}} | ||
|
||
1. In the Datadog mobile app, navigate to **Settings** > **On-Call**. | ||
|
||
2. Enable the **Critical Alerts** toggle. Critical alerts ignore the mute switch and Do Not Disturb. If you enable critical alerts, the system plays a critical alert’s sound regardless of the device’s mute or Do Not Disturb settings. | ||
|
||
3. Within the iOS system settings, make sure you enable the **Critical Alerts** toggle. Make sure you grant the mobile app the necessary permissions. | ||
|
||
4. Select your device for **High Urgency Notifications** and/or **Low Urgency Notifications** under the Notification Preferences section. | ||
|
||
5. Test the setup of your critical push notification by tapping **Test push notifications**. | ||
|
||
{{% /tab %}} | ||
{{% tab "Android" %}} | ||
|
||
{{< img src="service_management/mobile/android_critical_may_2025.png" alt="Override your Android device's system volume and Do Not Disturb mode." style="width:100%;" >}} | ||
|
||
1. In the Datadog mobile app, navigate to **Settings** > **On-Call**. | ||
|
||
{{< img src="service_management/mobile/android_allow_notification_may_2025.png" alt="Override your Android device's system volume and Do Not Disturb mode." style="width:100%;" >}} | ||
|
||
2. If notification permissiongs are missing, tap **Bypass Do Not Disturb** and enable **Allow notifications** in System Settings. | ||
|
||
{{< img src="service_management/mobile/android_override_system_may_2025.png" alt="Override your Android device's system volume and Do Not Disturb mode." style="width:100%;" >}} | ||
|
||
3. Then tap **Bypass Do Not Disturb** and enable **Override Do Not Disturb** in System Settings for High Urgency On-Call. | ||
|
||
{{< img src="service_management/mobile/android_override_system_volume_may_2025.png" alt="Override your Android device's system volume and Do Not Disturb mode." style="width:100%;" >}} | ||
|
||
5. In order to override system volume, tap the **Override system volume** and allow **Mode access** in System Settings to toggle on **Override system volume**. | ||
|
||
6. On web, set up notifciation preferences for **High Urgency Notifications** and/or **Low Urgency Notifications**. | ||
|
||
7. Test the setup of your critical push notification by tapping **Test push notifications**. | ||
|
||
<div class="alert alert-danger"> | ||
On Android, the Datadog mobile app cannot bypass system volume or Do Not Disturb settings when used within a Work Profile. As a workaround, install the Datadog mobile app on your personal profile. | ||
</div> | ||
|
||
{{% /tab %}} | ||
{{< /tabs >}} | ||
### Custom sounds for critical push | ||
For high-urgency notifications, Datadog strongly recommends customizing your system sounds and volume settings. This ensures that alerts are not only more distinct and recognizable, but also more effective in capturing attention. | ||
|
||
### Telephony channels (voice calls and SMS) | ||
|
||
For reliability, Datadog uses a rotating set of phone numbers to contact you. To help your phone recognize calls and messages from Datadog On-Call, you can create a digital contact card. This card automatically updates with Datadog's latest phone numbers. You can assign special permissions to this contact in your system settings for enhanced functionality, such as circumventing Do Not Disturb mode. | ||
|
||
{{< tabs >}} | ||
{{% tab "iOS" %}} | ||
|
||
{{< img src="service_management/mobile/ios_sync_card_may_2025.png" alt="Override your iOS device's Do Not Disturb mode for SMS and voice calls" style="width:100%;" >}} | ||
|
||
1. In the Datadog mobile app, navigate to **Account** > **Settings** > **Notifications**. | ||
|
||
2. Toggle on **Enable Automatic Contact Card Sync**. This creates a contact named "Datadog On-Call", which updates regularly with Datadog's latest phone numbers. | ||
|
||
3. After this contact is created, open your iOS system settings and navigate to **Focus** > **Do Not Disturb**. | ||
|
||
4. Under **People**, allow notifications from the Datadog On-Call contact. If you enabled critical alerts for Datadog push applications, then the Datadog mobile app also appears under **Apps**. | ||
|
||
5. To bypass silent mode, navigate to the Datadog On-Call contact >> tap **Ringstone** >> activate **Emergency Bypass**. | ||
{{% /tab %}} | ||
|
||
{{% tab "Android" %}} | ||
|
||
{{< img src="service_management/mobile/android_sync_card_may_2025.png" alt="Override your Android device's do-not-disturb mode for SMS and voice calls" style="width:100%;" >}} | ||
|
||
1. In the Datadog mobile app, navigate to **Settings** > **On-Call**. | ||
|
||
2. Under **Phone & SMS**, enable **Automatic Contact Card Sync**. This creates a contact named "Datadog On-Call", which updates regularly with Datadog's latest phone numbers. | ||
|
||
3. After this contact is created, mark it as a favorite. | ||
|
||
4. Open your Android system settings and navigate to **Sound & vibration** > **Do Not Disturb**. Create an exception for the Datadog On-Call contact. | ||
|
||
{{% /tab %}} | ||
{{< /tabs >}} | ||
|
||
<div class="alert alert-info"> | ||
<a href="https://datadog-on-call.s3.amazonaws.com/datadog-on-call.vcf">Download the current version of the Datadog On-Call contact card</a>. <strong>Note</strong>: The contact card is subject to change at any time. | ||
</div> | ||
|
||
## Troubleshooting | ||
For help with troubleshooting, [contact Datadog support][2]. You can also send a message in the [Datadog public Slack][3] [#mobile-app][4] channel. | ||
|
||
[1]: /service_management/mobile/?tab=ios | ||
[2]: /help/ | ||
[3]: https://chat.datadoghq.com/ | ||
[4]: https://datadoghq.slack.com/archives/C0114D5EHNG | ||
[5]: /service_management/on-call/ |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Oops, something went wrong.
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
Uh oh!
There was an error while loading. Please reload this page.