Skip to content

Nancy.zhu/update mobile app #29264

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

Open
wants to merge 26 commits into
base: master
Choose a base branch
from
Open
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
26 commits
Select commit Hold shift + click to select a range
f75d87b
Update _index.md
NancyZ278 May 9, 2025
06e791e
Create push_notification
NancyZ278 May 9, 2025
2e789e8
Create ios_accessibility
NancyZ278 May 9, 2025
b1e9e04
Create widgets.md
NancyZ278 May 9, 2025
f28ded3
Rename ios_accessibility to ios_accessibility.md
NancyZ278 May 9, 2025
c86c235
Rename push_notification to push_notification.md
NancyZ278 May 9, 2025
5586576
updating mobile app doc screenshots
NancyZ278 May 9, 2025
43065f3
Update configure-mobile-device-for-on-call.md
NancyZ278 May 9, 2025
f621618
Update and rename ios_accessibility.md to accessibility.md
NancyZ278 May 13, 2025
e96fd8e
Update accessibility.md
NancyZ278 May 13, 2025
1675a6d
Update push_notification.md
NancyZ278 May 13, 2025
f5bb509
Update widgets.md
NancyZ278 May 13, 2025
8403496
Add files via upload
NancyZ278 May 13, 2025
a23f71d
Update _index.md
NancyZ278 May 13, 2025
e8b9dc6
Add files via upload
NancyZ278 May 13, 2025
61de960
Update push_notification.md
NancyZ278 May 13, 2025
87022e6
Update configure-mobile-device-for-on-call.md
NancyZ278 May 13, 2025
b05168b
Update configure-mobile-device-for-on-call.md
NancyZ278 May 13, 2025
fcd4bb5
Merge branch 'master' into nancy.zhu/update-mobile-app
NancyZ278 May 13, 2025
62dffce
Merge branch 'master' into nancy.zhu/update-mobile-app
NancyZ278 May 13, 2025
6e7c1b6
Update widgets.md
NancyZ278 May 14, 2025
74a4657
Update push_notification.md
NancyZ278 May 14, 2025
fa81d16
Update widgets.md
NancyZ278 May 14, 2025
af1b85a
Update configure-mobile-device-for-on-call.md
NancyZ278 May 15, 2025
55de779
Update widgets.md
NancyZ278 May 15, 2025
1b8f141
Merge branch 'master' into nancy.zhu/update-mobile-app
NancyZ278 May 15, 2025
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
472 changes: 54 additions & 418 deletions content/en/mobile/_index.md

Large diffs are not rendered by default.

65 changes: 65 additions & 0 deletions content/en/mobile/accessibility.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,65 @@
---
title: Accessibility
aliases:
- /service_management/mobile/
algolia:
tags: ["Datadog mobile app", "mobile device"]
---

## Quick actions

{{< img src="service_management/mobile/shortcut_shadow.png" style="width:100%; background:none; border:none; box-shadow:none;" alt="Quick Actions">}}

Long-press the app icon to display a quick-action sheet of your top five [Frequently Viewed By Me][1] dashboards for iOS (measured by view count and recency), or your five most opened dashboards on mobile for Android. Tap a result to open the dashboard in-app.

## Search from home screen

{{< img src="service_management/mobile/iphone_search_doc.png" alt="Home Screen Search" style="width:40%;">}}

**iOS only**: Within iPhone Search, filter and search for the name of any desired dashboard. Press on a result to open the dashboard view directly on the mobile app, or press the "Search in App" button to open the search query in the in-app Dashboard List page.

## Shortcuts and Siri suggestions

**Android**: Create shortcut icons for your dashboards by long pressing the Datadog app icon, then lift your finger. If the app has shortcuts, it displays a list. Touch and hold the desired shortcut, then drag and drop it to another location on your screen to create a unique shortcut icon.

**iOS**: Create Siri Shortcuts for Datadog dashboards and monitors through the Shortcuts App. For a shortcut to be available for creation, you must execute the desired action at least once in the app. For example, to create an "Open AWS Overview Dashboard" shortcut, open the AWS Overview Dashboard in your mobile app at least once.

With the shortcut, you can access your dashboards and monitors through three key actions:

- Pin the shortcut as an icon in your home screen. To do so, access the Shortcuts app, and open the edit menu for your dashboard shortcut.
- Siri Voice: say your shortcut name, such as "Open AWS Overview", and Siri opens your dashboard in-app.
- Siri suggestions: Siri learns your routine, and suggests dashboard shortcuts when you most need them, through a home or lock-screen banner, iPhone search, or iOS 14 Siri Suggestions widgets.

{{< img src="service_management/mobile/siri_shadow.png" style="width:100%; background:none; border:none; box-shadow:none;" alt="Shortcuts">}}

For more information about Siri shortcuts and suggestions, read the [Apple Siri documentation][2].

## Handoff

**iOS Only**: Use Apple Handoff to continue your task across Apple devices. While in use, the icon of the Datadog mobile app appears on your Mac at the left end of the Dock. Click on the icon to open your current dashboard or monitor on your Mac.

For Handoff to work, each device must:

- Be signed in to iCloud with the same Apple ID
- Have Bluetooth enabled
- Have Wi-Fi enabled
- Have Handoff enabled

For more information about Handoff, read the [Apple Handoff documentation][3].

## Apple Watch
To enable notifications for the Apple Watch when paired with your iPhone:
1. Open the Watch app on your mobile device.
2. Tap on **Notifications**.
3. Toggle on **Notifications Indicator**.

**Note:** Apple does not support notifications to both iPhone and Apple Watch. If your iPhone is locked or asleep, you'll receive notifications on your Apple Watch. If you could like to always receive notifications on your phone, head to the Watch App and disable Notifications.
Read the [Notifications on your Apple Watch documentation][4] for more information.

**Note:** In order to receive notifications, you must be paired with your iPhone and remain within the bluetooth vicinity of your paired phone.


[1]: https://app.datadoghq.com/dashboard/lists/preset/5
[2]: https://support.apple.com/en-us/HT209055
[3]: https://support.apple.com/en-us/HT209455
[4]: https://support.apple.com/en-au/108369
131 changes: 131 additions & 0 deletions content/en/mobile/push_notification.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,131 @@
---
title: Set Up Push Notifications on Mobile App
further_reading:
- link: "https://docs.datadoghq.com/service_management/on-call/"
tag: "Documentation"
text: "On-Call Documentation"
- link: "https://docs.datadoghq.com/service_management/incident_management/notification/"
tag: "Documentation"
text: "Incident Notification Rules Documentation"
- link: "https://docs.datadoghq.com/getting_started/workflow_automation/"
tag: "Documentation"
text: "Workflow Automation Documentation"
---

Receive mobile push notifications for [on-call alerts](#circumvent-mute-and-Do-Not-Disturb-mode-for-On-Call), [incidents](#incident-notifications), and [workflow automation updates](#workflow-automation-notifications), so you can stay informed in real time from the Datadog mobile app.

## 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:
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
However, by default, the mobile app is not allowed to send you notifications. To receive push notifications:
By default, the mobile app is not allowed to send you notifications. To receive push notifications:

Or remove the alert styling on the sentence before this one


{{< 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).

For more information, here is a full guide on [how to set up your mobile device for On-Call][]
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
For more information, here is a full guide on [how to set up your mobile device for On-Call][]
For more information, see the [guide on setting up your mobile device for On-Call][].

This link seems to be missing, did you mean to link to /service_management/on-call/guides/configure-mobile-device-for-on-call?


### 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. 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.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
2. If notification permissiongs are missing, tap **Bypass Do Not Disturb** and enable **Allow notifications** in System Settings.
2. If notification permissions 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.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
3. Then tap **Bypass Do Not Disturb** and enable **Override Do Not Disturb** in System Settings for High urgency On-Call.
3. Then tap **Bypass Do Not Disturb** and enable **Override Do Not Disturb** in System Settings for High urgency On-Call.

If you modified "High urgency On-Call" elsewhere, update it here as well


{{< 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. 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.

## Incident notifications
Receive status updates on your active incidents by setting up [Notification Rules for incidents on the Web][2].

1. In Incidents, navigate to **Settings** > [**Notification Rules**][1].
2. Click **+ New Rule** button on the top right.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
2. Click **+ New Rule** button on the top right.
2. Click the **+ New Rule** button on the top right.

3. Enter your desired condition fields for **When an incident is...** and **And meets the following conditions...**. By default, these filters are empty, and a notification rule triggers for any incident.
4. Under **Nofity...** select your notification recipient.If you want to notify a recipient’s mobile device, select the option for their name that includes **(Mobile Push Notification)**. The recipient must have enabled notifications in the Datadog mobile app for this option to appear.
5. **With Template:** Select the desired message template you want the notification rule to use.
6. **Renotify on updates to:** Select the incident properties that trigger notifications. A new notification is sent whenever one or more of the selected properties change.
7. Click **Save**.

By default if you have push notifications enabled and are assigned as a commander to an incident, you automatically receive push notification for the incident.

## Workflow automation notifications
Create [workflow automations][3] that send mobile push notifications.

1. On the workflow canvas, click the **+icon**.
2. Search for **Send mobile push notification**.
3. Under **To** select your notification recipient. The recipient must have enabled notifications in the Datadog mobile app for this option to appear.
4. Enter the message **Body**.

### Further Reading

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

[1]:https://app.datadoghq.com/incidents/settings?_gl=1*334tvl*_gcl_aw*R0NMLjE3NDUwMDYwODQuQ2p3S0NBand0ZGlfQmhBQ0Vpd0E5N3k4QkxnWmU4cTdmazJtUlJoQ3o1OTZXcTNmRWJIQTk1Rzg4dnAtUmZtUHBQUGx0OVNVSjRlSk9Sb0Nwek1RQXZEX0J3RQ..*_gcl_au*MTAxODMyNDk1My4xNzQwNDk1NzA3LjExNzUxOTU1MTUuMTc0NjQ5NTU3OS4xNzQ2NDk1NTc5*_ga*MjExMzI1MjUyOS4xNzQ1ODU2NjMx*_ga_KN80RDFSQK*czE3NDY0OTQzMzYkbzU4JGcxJHQxNzQ2NDk5MzA0JGowJGwwJGg5NTQ2NTk0Ng..*_fplc*Q2V5WVJmNnRSV2R0RmljTDZyWmg3ZEVZMFZPeDNlTFhLZkxnenFCOXBvTUslMkZTWWk0a3JzVEw1cDU5YlZzTW55TE5YazY5bjdhJTJGOXpySzJ0TFMxTEozZms0WTVlOWVibEN5ZFBNNm1XYmJJQll0R0d4YnlralJ2eU1CS1NoUSUzRCUzRA..#Rules
[2]:https://docs.datadoghq.com/service_management/incident_management/incident_settings/notification_rules/
[3]:https://docs.datadoghq.com/getting_started/workflow_automation/
Loading
Loading