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

MonitoringHubTriggeredAlertsPollResponse

Successful request. The response contains one or more alert events.

Headers

  • Location: string
  • Retry-After: string
202 Accepted

Accepted. No alert events are returned; there is no body and no flow run.

Headers

  • Location: string
  • Retry-After: string
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
MonitoringHubAffectedResource

The IDs of an affected resource and its environment, with the observed metric value when available.

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.

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.

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

MonitoringHubAffectedResource[]

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:
  • AgentSuccessRate
  • CanvasAppAvailability
  • CanvasAppDataRequest
  • CanvasAppDataRequestLatency
  • CanvasAppRecentAppLaunches
  • CanvasAppTimeToFullLoad
  • CanvasAppTimeToInteract
  • CloudFlowDuration
  • CloudFlowRunCount
  • CloudFlowSuccessRate
  • CodeAppAvailability
  • CodeAppDataRequest
  • CodeAppDataRequestLatency
  • CodeAppRecentAppLaunches
  • CodeAppTimeToInteract
  • DesktopFlowDuration
  • DesktopFlowRunCount
  • DesktopFlowSuccessRate
  • DesktopFlowTimeInQueue
  • ModelAppAvailability
  • ModelDrivenAppRecentAppLaunches
  • PowerPagesAvailability
  • PowerPagesErrorRate
  • PowerPagesPageLoadTime
  • PowerPagesSessionTime
  • PowerPagesSessions
  • Unknown
  • WorkQueueBusinessException
  • WorkQueueGenericException
  • WorkQueueItException
  • WorkQueueOutOfSla

The metric monitored by the alert rule, or Unknown when the metric isn't recognized.

metricUnit enum:
  • Count
  • Percent
  • Seconds
  • Unknown

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:
  • Fired
  • Resolved
  • Unknown

Whether the alert has fired or resolved. Daily alert rules currently report Fired only. Unknown indicates an unrecognized condition.

operator enum:
  • Equals
  • IsOver
  • IsOverOrEqual
  • IsUnder
  • IsUnderOrEqual
  • Unknown

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:
  • CopilotStudio
  • PowerApps
  • PowerAutomate
  • PowerPages
  • Unknown

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:
  • Environment
  • Resource
  • Tenant
  • Unknown

Whether the rule monitors a tenant, environment, or resource, or Unknown when unrecognized.

severity enum:
  • High
  • Low
  • Medium
  • Unknown

The alert severity, or Unknown when the severity isn't recognized.

subProductType enum:
  • Agent
  • CanvasApp
  • CloudFlow
  • CodeApp
  • DesktopFlow
  • ModelDrivenApp
  • PowerPages
  • Unknown
  • WorkQueue

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

MonitoringHubTriggeredAlert[]

The alerts returned by this poll.