Skip to content

Commit f78df7c

Browse files
Merge pull request #10413 from HuaTang92/patch-1
Update health alert notification configuration details
2 parents 805c8ca + b960feb commit f78df7c

File tree

1 file changed

+8
-2
lines changed

1 file changed

+8
-2
lines changed

docs/identity/monitoring-health/howto-configure-health-alert-notifications.md

Lines changed: 8 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -35,10 +35,13 @@ There are different roles, permissions, and license requirements to view health
3535
- The `Group.Read.All` permission is the least privileged permission required to *view groups*.
3636
- The `HealthMonitoringAlert.Read.All` permission is required to *view the alerts using the Microsoft Graph API*.
3737
- The `HealthMonitoringAlert.ReadWrite.All` permission is required to *view and modify the alerts using the Microsoft Graph API*.
38+
- The `HealthMonitoringAlertConfig.Read.All` permission is required to *view the configured email notification using Microsoft Graph /reports/healthmonitoring/alertConfigurations/{alertType} API* or to *view the configured webhook notification using Microsoft Graph /subscriptions API*.
39+
- The `HealthMonitoringAlertConfig.ReadWrite.All` permission is required to *view and modify email notification using Microsoft Graph /reports/healthmonitoring/alertConfigurations/{alertType} API* or to *view and modify the configured webhook notification using Microsoft Graph /subscriptions API*.
3840
- For a full list of roles, see [Least privileged role by task](../role-based-access-control/delegate-by-task.md#monitoring-and-health---audit-and-sign-in-logs-least-privileged-roles).
3941

4042
> [!NOTE]
41-
> Newly onboarded tenants might not have enough data to generate alerts for about 30 days.
43+
> * Newly onboarded tenants might not have enough data to generate alerts for about 30 days. <br>
44+
> * If you see error due to missing required Microsoft Graph permissions, to get more information about Micorosft Graph permisisons, see [Microsoft graph permissions](/graph/permissions-overview).
4245
4346
## Determine email notification recipients
4447

@@ -145,6 +148,9 @@ Microsoft Graph change notifications allow your application to receive real-time
145148

146149
To start receiving notifications, your application sends a `POST` request to the /`subscriptions` endpoint to subscribe to a specific resource, in this case, health monitoring alerts. Microsoft Graph then validates the request and confirms the subscription. Once the subscription is active, Microsoft Graph sends a notification to your designated endpoint whenever the subscribed resource is created. For more information, see [Microsoft Graph change notifications](/graph/change-notifications-overview).
147150

151+
> [!NOTE]
152+
> If you see error due to missing required Microsoft Graph permissions, to get more information about Micorosft Graph permisisons, see [Microsoft graph permissions](/graph/permissions-overview).
153+
148154
After receiving a notification, you should investigate the alert either through the Microsoft Entra admin center or through the Microsoft Graph API. If you need to assess the alert's impact, we recommend either polling or introducing a short delay before calling the health monitoring alert API for impact assessment data to be available. For more information, see [How to investigate health scenario alerts](howto-investigate-health-scenario-alerts.md).
149155

150156
The following example shows a basic request to subscribe to changes to Health Monitoring alert changes.
@@ -171,4 +177,4 @@ If you want to subscribe to notifications for only one specific alert type, amen
171177
## Related content
172178

173179
- [Set up notifications for changes in resource data](/graph/change-notifications-overview)
174-
- [Configure email notifications for alerts](/graph/api/healthmonitoring-alertconfiguration-update?view=graph-rest-beta&preserve-view=true)
180+
- [Configure email notifications for alerts](/graph/api/healthmonitoring-alertconfiguration-update?view=graph-rest-beta&preserve-view=true)

0 commit comments

Comments
 (0)