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

Polish docs for mobile push notifications #27745

Open
wants to merge 2 commits into
base: master
Choose a base branch
from

Conversation

Dalje-et
Copy link
Contributor

What does this PR do? What is the motivation?

Docs mentioned solely push notifications for incident management before, ignoring On-Call and Workflows. This PR fixes it

Merge instructions

Merge readiness:

  • Ready for merge

Merge queue is enabled in this repo. To have it automatically merged after it receives the required reviews, create the PR (from a branch that follows the <yourname>/description naming convention) and then add the following PR comment:

/merge

Additional notes

@Dalje-et Dalje-et marked this pull request as ready for review February 21, 2025 09:31
@Dalje-et Dalje-et requested a review from a team as a code owner February 21, 2025 09:31
Copy link
Contributor

Preview links (active after the build_preview check completes)

Modified Files

Copy link
Contributor

@hestonhoffman hestonhoffman left a comment

Choose a reason for hiding this comment

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

Hi! I've left you some style edits and a question

@@ -426,6 +415,29 @@ On the Traces page, you can view and search all of the traces that you have acce

For example, to filter on traces with the tag `#env:prod` or the tag `#test`, use the query `"env:prod" OR test`. Click into individual services to expand associated spans, and select spans to view info, errors, and related logs. You can also open traces from services and logs.

## Notifications

The mobile app is able to send out regular as well as critical notifications. As a reminder, critical notifications can circumvent your Do Not Disturb (DnD) mode. This is however only possible if you **explicitly** grant us permission to do so on your device. Critical notifications are only supported in the context of [Datadog On-Call][24].
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
The mobile app is able to send out regular as well as critical notifications. As a reminder, critical notifications can circumvent your Do Not Disturb (DnD) mode. This is however only possible if you **explicitly** grant us permission to do so on your device. Critical notifications are only supported in the context of [Datadog On-Call][24].
The mobile app is able to send out regular as well as critical notifications. Critical notifications can circumvent your Do Not Disturb (DnD) mode, but you must **explicitly** grant Datadog permission to do so on your device. Critical notifications are only supported in the context of [Datadog On-Call][24].

The mobile app is able to send out regular as well as critical notifications. As a reminder, critical notifications can circumvent your Do Not Disturb (DnD) mode. This is however only possible if you **explicitly** grant us permission to do so on your device. Critical notifications are only supported in the context of [Datadog On-Call][24].

### Push Notifications for On-Call
To properly set up your mobile device for On-Call, please follow [this guide][25]. Once set up, make sure you visit your [On-Call profile][26] and select your mobile device in your notification preferences.
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
To properly set up your mobile device for On-Call, please follow [this guide][25]. Once set up, make sure you visit your [On-Call profile][26] and select your mobile device in your notification preferences.
To set up your mobile device for On-Call, follow [this guide][25]. After you've set up your mobile device, navigate to your [On-Call profile][26] and select the device in your notification preferences.

### Push Notifications for On-Call
To properly set up your mobile device for On-Call, please follow [this guide][25]. Once set up, make sure you visit your [On-Call profile][26] and select your mobile device in your notification preferences.

### Push Notifications for Incidents
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
### Push Notifications for Incidents
### Push Notifications for incidents

To properly set up your mobile device for On-Call, please follow [this guide][25]. Once set up, make sure you visit your [On-Call profile][26] and select your mobile device in your notification preferences.

### Push Notifications for Incidents
To stay up to date on new and ongoing incidents, Incident Management allows you to receive push notifications via [Incident Notification Rules][13]. Here's a step-by-step guide on how to set that up:
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
To stay up to date on new and ongoing incidents, Incident Management allows you to receive push notifications via [Incident Notification Rules][13]. Here's a step-by-step guide on how to set that up:
To stay up to date on new and ongoing incidents, Incident Management allows you to receive push notifications using [Incident Notification Rules][13]. To receive push notifications:

1. Navigate to **Account**.
2. Click **Notifications**.
3. Select the toggle for **Enable Notifications**.
4. Next, in the Datadog web app, navigate to [Incident Notification Rules][13].
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
4. Next, in the Datadog web app, navigate to [Incident Notification Rules][13].
4. In Datadog, navigate to [Incident Notification Rules][13].

Comment on lines +428 to +430
1. Navigate to **Account**.
2. Click **Notifications**.
3. Select the toggle for **Enable Notifications**.
Copy link
Contributor

Choose a reason for hiding this comment

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

Where are the first 3 steps happening? Is this referring to the mobile device settings, the Datadog app, or the Datadog Mobile App? If it's the Datadog app, a link to the page would be good. If it's a mobile device, are the instructions the same for Android and iOS?


For more information on configuring Incident Notification Rules, see the [Incidents settings docs][14].

### Push Notifications from Workflows
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
### Push Notifications from Workflows
### Push notifications from Workflow Automation

For more information on configuring Incident Notification Rules, see the [Incidents settings docs][14].

### Push Notifications from Workflows
It is also possible to trigger push notifications directly from Workflows via the [Send mobile push notification message action][27]. All you need to provide is the target user and the body of the push notification and you're good to go. Note, the target user must have already logged into the Datadog Mobile application and allowed the Datadog mobile application 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
It is also possible to trigger push notifications directly from Workflows via the [Send mobile push notification message action][27]. All you need to provide is the target user and the body of the push notification and you're good to go. Note, the target user must have already logged into the Datadog Mobile application and allowed the Datadog mobile application to receive push notifications.
It is also possible to trigger push notifications directly from Workflows using the [Send mobile push notification message action][27]. Provide the target user and the body of the push notification. Before the user can receive push notifications, they must log into the Datadog Mobile application and allow the Datadog mobile application to receive push notifications.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

3 participants