Skip to content

Add section on monitor bulk editing #28836

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
wants to merge 1 commit into
base: master
Choose a base branch
from
Draft
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
14 changes: 10 additions & 4 deletions content/en/monitors/notify/_index.md
Original file line number Diff line number Diff line change
Expand Up @@ -55,7 +55,7 @@


## Notification recipients
Datadog recommends using [monitor notification rules][22] to manage monitor notifications. With notification rules you can automate which notification recipients are added to a monitor based on predefined sets of conditions. Create different rules to route monitor alerts based on the tags of the monitor notification so you don't have to manually set up recipients nor notification routing logic for each individual monitor.
Datadog recommends using [monitor notification rules][22] to manage monitor notifications. With notification rules you can automate which notification recipients are added to a monitor based on predefined sets of conditions. Create different rules to route monitor alerts based on the tags of the monitor notification so you don't have to manually set up recipients nor notification routing logic for each individual monitor.

Check notice on line 58 in content/en/monitors/notify/_index.md

View workflow job for this annotation

GitHub Actions / vale

Datadog.sentencelength

Suggestion: Try to keep your sentence length to 25 words or fewer.

In both notification rules and individual monitors, you can use an `@notification` to add a team member, integration, workflow, or case to your notification. As you type, Datadog auto-recommends existing options in a drop-down menu. Click an option to add it to your notification. Alternatively, click **@ Add Mention**, **Add Workflow**, or **Add Case**.

Expand All @@ -79,9 +79,15 @@

{{% /collapse-content %}}

### Bulk editing Monitor @-handles

Check warning on line 82 in content/en/monitors/notify/_index.md

View workflow job for this annotation

GitHub Actions / vale

Datadog.headings

'Bulk editing Monitor @-handles' should use sentence-style capitalization.
Datadog supports editing alert message recipients across multiple monitors at once. Use this feature to efficiently add, remove, or replace @-handles in the monitor message body. Use cases include:

- **Swap a handle**: Replace one handle with another across multiple monitors. For example, change `@pagerduty-sre` to `@oncall-sre`. You can also swap a single handle with multiple handles, such as replacing `@pagerduty-sre` with both `@pagerduty-sre` and `@oncall-sre`, to support dual paging or expanded alerting coverage.
- **Add a handle**: Add a new recipient without removing existing ones. For example, add `@slack-infra-leads` to all selected Monitors.
- **Remove a handle**: Remove a specific handle from monitor messages. For example, remove `@webhook-my-legacy-event-intake`.

## Workflows
You can trigger a [workflow automation][8] or create a new workflow from a monitor.
You can trigger a [workflow automation][8] or create a new workflow from a monitor.

Before you add a workflow to a monitor, [add a monitor trigger to the workflow][9].

Expand All @@ -93,7 +99,7 @@

For more information on building a workflow, see [Build workflows][11].

## Incidents
## Incidents
Incidents can be automatically created from a monitor when the monitor transitions to an `alert`, `warn`, or `no data` status. Click on **Add Incident** and select an `@incident-` option. Admins can create `@incident-` options in [Incident Settings][12].

When an incident is created from a monitor, the incident's [field values][13] are automatically populated based on the monitor's tags. For example, if your monitor has a tag `service:payments`, the incident's service field will be set to "payments". To receive notifications for these incidents, make sure the monitor's tags align with your incident notification rules. **Note**: Incident notification rules are configured separately from monitor notification rules and need to be set up independently. For more information, see [Incident Notification][14].
Expand Down Expand Up @@ -177,7 +183,7 @@

## Test notifications

After defining your monitor, test the notifications with the **Test Notifications** button at the bottom right of the monitor page.
After defining your monitor, test the notifications with the **Test Notifications** button at the bottom right of the monitor page.

Test notifications are supported for the [monitor types][19]: host, metric, anomaly, outlier, forecast, logs, rum, apm, integration (check only), process (check only), network (check only), custom check, event, and composite.

Expand Down
Loading