Monitoring Hub - On Alert Triggered
When an alert triggers (preview)
Triggers when a daily Power Platform Monitor alert rule fires in your tenant and its notification type is Connector or Email and connector. This preview supports daily alert rules and returns alert IDs, metadata, affected resources, and a link to the alert in Power Platform admin center. Each alert is one item in the value array. When using this trigger in a flow, turn on Split On for value to run once per alert.
GET https://api.powerplatform.com/monitoringhub/powerplatform/triggeredAlerts/poll
Responses
| Name | Type | Description |
|---|---|---|
| 200 OK |
Successful request. The response contains one or more alert events. Headers
|
|
| 202 Accepted |
Accepted. No alert events are returned; there is no body and no flow run. Headers
|
|
| 400 Bad Request |
Bad request. One or more request parameters are invalid. |
|
| 401 Unauthorized |
Unauthorized. A valid access token is required. |
|
| 403 Forbidden |
Forbidden. You don't have permission to read alerts in this tenant. |
|
| 429 Too Many Requests |
Too many requests. Retry after the indicated delay. Headers Retry-After: string |
|
| 500 Internal Server Error |
Internal server error. |
Security
oauth2
Microsoft Entra ID OAuth2
Type:
oauth2
Flow:
implicit
Authorization URL:
https://login.microsoftonline.com/common/oauth2/authorize?resource=https://api.powerplatform.com
Scopes
| Name | Description |
|---|---|
| .default | .default |
Definitions
| Name | Description |
|---|---|
|
Monitoring |
The IDs of an affected resource and its environment, with the observed metric value when available. |
|
Monitoring |
A Power Platform Monitor alert with its rule, metric, and affected-resource details. Unknown indicates an unrecognized value. Optional details are omitted when unavailable. |
|
Monitoring |
A batch of Power Platform Monitor alerts. Use the value array as the Split On target to start a separate flow run for each alert. |
MonitoringHubAffectedResource
The IDs of an affected resource and its environment, with the observed metric value when available.
| Name | Type | Description |
|---|---|---|
| environmentId |
string |
The environment ID: a GUID, or Default-{tenant GUID} for the default environment. |
| metricValue |
number (double) |
The observed value for this resource, expressed in the alert's Metric Unit. Omitted when unavailable. |
| resourceId |
string (uuid) |
The ID of the affected resource. |
MonitoringHubTriggeredAlert
A Power Platform Monitor alert with its rule, metric, and affected-resource details. Unknown indicates an unrecognized value. Optional details are omitted when unavailable.
| Name | Type | Description |
|---|---|---|
| affectedResourceCount |
integer (int32) minimum: 0 |
The total number of affected resources, including any resources omitted from the Affected Resources list. |
| affectedResources |
A list of affected resource and environment IDs, with observed metric values when available. The list can be limited. Check Affected Resource Count and Affected Resources Truncated to determine whether more resources were affected. |
|
| affectedResourcesTruncated |
boolean |
True when the Affected Resources list omits one or more resources included in Affected Resource Count. |
| alertId |
string (uuid) |
The ID of the alert instance. |
| alertLink |
string (uri) |
A link to view the alert in Power Platform admin center. Sign in with an account that has access to the alert. |
| alertRuleId |
string (uuid) |
The ID of the alert rule in Power Platform admin center. |
| dataReviewPeriod |
string |
The time period evaluated by the rule, as an ISO-8601 duration, such as PT1H for one hour or P1D for one day. |
| firedDateTime |
string (date-time) |
The time the alert fired, in UTC ISO-8601 format. |
| metric |
enum:
|
The metric monitored by the alert rule, or Unknown when the metric isn't recognized. |
| metricUnit |
enum:
|
The unit for the threshold and observed metric values. Percent uses percentage points (95 means 95 percent), Seconds uses seconds, and Count uses item or event counts. Unknown indicates an unrecognized unit. |
| monitorCondition |
enum:
|
Whether the alert has fired or resolved. Daily alert rules currently report Fired only. Unknown indicates an unrecognized condition. |
| operator |
enum:
|
How the metric is compared with the threshold. IsUnder and IsOver exclude equality; IsUnderOrEqual and IsOverOrEqual include equality. Unknown indicates an unrecognized comparison. |
| productType |
enum:
|
The Power Platform product associated with the alert, or Unknown when unrecognized. |
| resolvedDateTime |
string (date-time) |
The time the alert resolved, in UTC ISO-8601 format. Omitted when no resolution time is available. |
| scope |
enum:
|
Whether the rule monitors a tenant, environment, or resource, or Unknown when unrecognized. |
| severity |
enum:
|
The alert severity, or Unknown when the severity isn't recognized. |
| subProductType |
enum:
|
The type of app, flow, or other resource associated with the alert, or Unknown when unrecognized. |
| tenantId |
string (uuid) |
The ID of your Power Platform tenant. |
| threshold |
number (double) |
The threshold configured for the rule, expressed in Metric Unit. For example, 95 with Percent means 95 percent. |
MonitoringHubTriggeredAlertsPollResponse
A batch of Power Platform Monitor alerts. Use the value array as the Split On target to start a separate flow run for each alert.
| Name | Type | Description |
|---|---|---|
| totalCount |
integer (int32) minimum: 0 |
The number of alerts in this response. |
| value |
The alerts returned by this poll. |