Note
Access to this page requires authorization. You can try signing in or changing directories.
Access to this page requires authorization. You can try changing directories.
Bicep resource definition
The alertrules resource type can be deployed with operations that target:
- Resource groups - See resource group deployment commands
For a list of changed properties in each API version, see change log.
Resource format
To create a Microsoft.Insights/alertrules resource, add the following Bicep to your template.
resource symbolicname 'Microsoft.Insights/alertrules@2016-03-01' = {
location: 'string'
name: 'string'
properties: {
action: {
odata.type: 'string'
// For remaining properties, see RuleAction objects
}
actions: [
{
odata.type: 'string'
// For remaining properties, see RuleAction objects
}
]
condition: {
dataSource: {
legacyResourceId: 'string'
metricNamespace: 'string'
resourceLocation: 'string'
resourceUri: 'string'
odata.type: 'string'
// For remaining properties, see RuleDataSource objects
}
odata.type: 'string'
// For remaining properties, see RuleCondition objects
}
description: 'string'
isEnabled: bool
name: 'string'
provisioningState: 'string'
}
tags: {
{customized property}: 'string'
}
}
RuleAction objects
Set the odata.type property to specify the type of object.
For Microsoft.Azure.Management.Insights.Models.RuleEmailAction, use:
{
customEmails: [
'string'
]
odata.type: 'Microsoft.Azure.Management.Insights.Models.RuleEmailAction'
sendToServiceOwners: bool
}
For Microsoft.Azure.Management.Insights.Models.RuleWebhookAction, use:
{
odata.type: 'Microsoft.Azure.Management.Insights.Models.RuleWebhookAction'
properties: {
{customized property}: 'string'
}
serviceUri: 'string'
}
RuleDataSource objects
Set the odata.type property to specify the type of object.
For Microsoft.Azure.Management.Insights.Models.RuleManagementEventDataSource, use:
{
claims: {
emailAddress: 'string'
}
eventName: 'string'
eventSource: 'string'
level: 'string'
odata.type: 'Microsoft.Azure.Management.Insights.Models.RuleManagementEventDataSource'
operationName: 'string'
resourceGroupName: 'string'
resourceProviderName: 'string'
status: 'string'
subStatus: 'string'
}
For Microsoft.Azure.Management.Insights.Models.RuleMetricDataSource, use:
{
metricName: 'string'
odata.type: 'Microsoft.Azure.Management.Insights.Models.RuleMetricDataSource'
}
RuleCondition objects
Set the odata.type property to specify the type of object.
For Microsoft.Azure.Management.Insights.Models.LocationThresholdRuleCondition, use:
{
failedLocationCount: int
odata.type: 'Microsoft.Azure.Management.Insights.Models.LocationThresholdRuleCondition'
windowSize: 'string'
}
For Microsoft.Azure.Management.Insights.Models.ManagementEventRuleCondition, use:
{
aggregation: {
operator: 'string'
threshold: int
windowSize: 'string'
}
odata.type: 'Microsoft.Azure.Management.Insights.Models.ManagementEventRuleCondition'
}
For Microsoft.Azure.Management.Insights.Models.ThresholdRuleCondition, use:
{
odata.type: 'Microsoft.Azure.Management.Insights.Models.ThresholdRuleCondition'
operator: 'string'
threshold: int
timeAggregation: 'string'
windowSize: 'string'
}
Property values
AlertRule
Name | Description | Value |
---|---|---|
action | action that is performed when the alert rule becomes active, and when an alert condition is resolved. | RuleAction |
actions | the array of actions that are performed when the alert rule becomes active, and when an alert condition is resolved. | RuleAction[] |
condition | the condition that results in the alert rule being activated. | RuleCondition (required) |
description | the description of the alert rule that will be included in the alert email. | string |
isEnabled | the flag that indicates whether the alert rule is enabled. | bool (required) |
name | the name of the alert rule. | string (required) |
provisioningState | the provisioning state. | string |
LocationThresholdRuleCondition
Name | Description | Value |
---|---|---|
failedLocationCount | the number of locations that must fail to activate the alert. | int Constraints: Min value = 0 (required) |
odata.type | specifies the type of condition. This can be one of three types: ManagementEventRuleCondition (occurrences of management events), LocationThresholdRuleCondition (based on the number of failures of a web test), and ThresholdRuleCondition (based on the threshold of a metric). | 'Microsoft.Azure.Management.Insights.Models.LocationThresholdRuleCondition' (required) |
windowSize | the period of time (in ISO 8601 duration format) that is used to monitor alert activity based on the threshold. If specified then it must be between 5 minutes and 1 day. | string |
ManagementEventAggregationCondition
Name | Description | Value |
---|---|---|
operator | the condition operator. | 'GreaterThan' 'GreaterThanOrEqual' 'LessThan' 'LessThanOrEqual' |
threshold | The threshold value that activates the alert. | int |
windowSize | the period of time (in ISO 8601 duration format) that is used to monitor alert activity based on the threshold. If specified then it must be between 5 minutes and 1 day. | string |
ManagementEventRuleCondition
Name | Description | Value |
---|---|---|
aggregation | How the data that is collected should be combined over time and when the alert is activated. Note that for management event alerts aggregation is optional – if it is not provided then any event will cause the alert to activate. | ManagementEventAggregationCondition |
odata.type | specifies the type of condition. This can be one of three types: ManagementEventRuleCondition (occurrences of management events), LocationThresholdRuleCondition (based on the number of failures of a web test), and ThresholdRuleCondition (based on the threshold of a metric). | 'Microsoft.Azure.Management.Insights.Models.ManagementEventRuleCondition' (required) |
Microsoft.Insights/alertrules
Name | Description | Value |
---|---|---|
location | Resource location | string (required) |
name | The resource name | string (required) |
properties | The alert rule properties of the resource. | AlertRule (required) |
tags | Resource tags | Dictionary of tag names and values. See Tags in templates |
ResourceTags
Name | Description | Value |
---|
RuleAction
Name | Description | Value |
---|---|---|
odata.type | Set to 'Microsoft.Azure.Management.Insights.Models.RuleEmailAction' for type RuleEmailAction. Set to 'Microsoft.Azure.Management.Insights.Models.RuleWebhookAction' for type RuleWebhookAction. | 'Microsoft.Azure.Management.Insights.Models.RuleEmailAction' 'Microsoft.Azure.Management.Insights.Models.RuleWebhookAction' (required) |
RuleCondition
Name | Description | Value |
---|---|---|
dataSource | the resource from which the rule collects its data. For this type dataSource will always be of type RuleMetricDataSource. | RuleDataSource |
odata.type | Set to 'Microsoft.Azure.Management.Insights.Models.LocationThresholdRuleCondition' for type LocationThresholdRuleCondition. Set to 'Microsoft.Azure.Management.Insights.Models.ManagementEventRuleCondition' for type ManagementEventRuleCondition. Set to 'Microsoft.Azure.Management.Insights.Models.ThresholdRuleCondition' for type ThresholdRuleCondition. | 'Microsoft.Azure.Management.Insights.Models.LocationThresholdRuleCondition' 'Microsoft.Azure.Management.Insights.Models.ManagementEventRuleCondition' 'Microsoft.Azure.Management.Insights.Models.ThresholdRuleCondition' (required) |
RuleDataSource
Name | Description | Value |
---|---|---|
legacyResourceId | the legacy resource identifier of the resource the rule monitors. NOTE: this property cannot be updated for an existing rule. | string |
metricNamespace | the namespace of the metric. | string |
odata.type | Set to 'Microsoft.Azure.Management.Insights.Models.RuleManagementEventDataSource' for type RuleManagementEventDataSource. Set to 'Microsoft.Azure.Management.Insights.Models.RuleMetricDataSource' for type RuleMetricDataSource. | 'Microsoft.Azure.Management.Insights.Models.RuleManagementEventDataSource' 'Microsoft.Azure.Management.Insights.Models.RuleMetricDataSource' (required) |
resourceLocation | the location of the resource. | string |
resourceUri | the resource identifier of the resource the rule monitors. NOTE: this property cannot be updated for an existing rule. | string |
RuleEmailAction
Name | Description | Value |
---|---|---|
customEmails | the list of administrator's custom email addresses to notify of the activation of the alert. | string[] |
odata.type | specifies the type of the action. There are two types of actions: RuleEmailAction and RuleWebhookAction. | 'Microsoft.Azure.Management.Insights.Models.RuleEmailAction' (required) |
sendToServiceOwners | Whether the administrators (service and co-administrators) of the service should be notified when the alert is activated. | bool |
RuleManagementEventClaimsDataSource
Name | Description | Value |
---|---|---|
emailAddress | the email address. | string |
RuleManagementEventDataSource
Name | Description | Value |
---|---|---|
claims | the claims. | RuleManagementEventClaimsDataSource |
eventName | the event name. | string |
eventSource | the event source. | string |
level | the level. | string |
odata.type | specifies the type of data source. There are two types of rule data sources: RuleMetricDataSource and RuleManagementEventDataSource | 'Microsoft.Azure.Management.Insights.Models.RuleManagementEventDataSource' (required) |
operationName | The name of the operation that should be checked for. If no name is provided, any operation will match. | string |
resourceGroupName | the resource group name. | string |
resourceProviderName | the resource provider name. | string |
status | The status of the operation that should be checked for. If no status is provided, any status will match. | string |
subStatus | the substatus. | string |
RuleMetricDataSource
Name | Description | Value |
---|---|---|
metricName | the name of the metric that defines what the rule monitors. | string |
odata.type | specifies the type of data source. There are two types of rule data sources: RuleMetricDataSource and RuleManagementEventDataSource | 'Microsoft.Azure.Management.Insights.Models.RuleMetricDataSource' (required) |
RuleWebhookAction
Name | Description | Value |
---|---|---|
odata.type | specifies the type of the action. There are two types of actions: RuleEmailAction and RuleWebhookAction. | 'Microsoft.Azure.Management.Insights.Models.RuleWebhookAction' (required) |
properties | the dictionary of custom properties to include with the post operation. These data are appended to the webhook payload. | RuleWebhookActionProperties |
serviceUri | the service uri to Post the notification when the alert activates or resolves. | string |
RuleWebhookActionProperties
Name | Description | Value |
---|
ThresholdRuleCondition
Name | Description | Value |
---|---|---|
odata.type | specifies the type of condition. This can be one of three types: ManagementEventRuleCondition (occurrences of management events), LocationThresholdRuleCondition (based on the number of failures of a web test), and ThresholdRuleCondition (based on the threshold of a metric). | 'Microsoft.Azure.Management.Insights.Models.ThresholdRuleCondition' (required) |
operator | the operator used to compare the data and the threshold. | 'GreaterThan' 'GreaterThanOrEqual' 'LessThan' 'LessThanOrEqual' (required) |
threshold | the threshold value that activates the alert. | int (required) |
timeAggregation | the time aggregation operator. How the data that are collected should be combined over time. The default value is the PrimaryAggregationType of the Metric. | 'Average' 'Last' 'Maximum' 'Minimum' 'Total' |
windowSize | the period of time (in ISO 8601 duration format) that is used to monitor alert activity based on the threshold. If specified then it must be between 5 minutes and 1 day. | string |
ARM template resource definition
The alertrules resource type can be deployed with operations that target:
- Resource groups - See resource group deployment commands
For a list of changed properties in each API version, see change log.
Resource format
To create a Microsoft.Insights/alertrules resource, add the following JSON to your template.
{
"type": "Microsoft.Insights/alertrules",
"apiVersion": "2016-03-01",
"name": "string",
"location": "string",
"properties": {
"action": {
"odata.type": "string"
// For remaining properties, see RuleAction objects
},
"actions": [ {
"odata.type": "string"
// For remaining properties, see RuleAction objects
} ],
"condition": {
"dataSource": {
"legacyResourceId": "string",
"metricNamespace": "string",
"resourceLocation": "string",
"resourceUri": "string",
"odata.type": "string"
// For remaining properties, see RuleDataSource objects
},
"odata.type": "string"
// For remaining properties, see RuleCondition objects
},
"description": "string",
"isEnabled": "bool",
"name": "string",
"provisioningState": "string"
},
"tags": {
"{customized property}": "string"
}
}
RuleAction objects
Set the odata.type property to specify the type of object.
For Microsoft.Azure.Management.Insights.Models.RuleEmailAction, use:
{
"customEmails": [ "string" ],
"odata.type": "Microsoft.Azure.Management.Insights.Models.RuleEmailAction",
"sendToServiceOwners": "bool"
}
For Microsoft.Azure.Management.Insights.Models.RuleWebhookAction, use:
{
"odata.type": "Microsoft.Azure.Management.Insights.Models.RuleWebhookAction",
"properties": {
"{customized property}": "string"
},
"serviceUri": "string"
}
RuleDataSource objects
Set the odata.type property to specify the type of object.
For Microsoft.Azure.Management.Insights.Models.RuleManagementEventDataSource, use:
{
"claims": {
"emailAddress": "string"
},
"eventName": "string",
"eventSource": "string",
"level": "string",
"odata.type": "Microsoft.Azure.Management.Insights.Models.RuleManagementEventDataSource",
"operationName": "string",
"resourceGroupName": "string",
"resourceProviderName": "string",
"status": "string",
"subStatus": "string"
}
For Microsoft.Azure.Management.Insights.Models.RuleMetricDataSource, use:
{
"metricName": "string",
"odata.type": "Microsoft.Azure.Management.Insights.Models.RuleMetricDataSource"
}
RuleCondition objects
Set the odata.type property to specify the type of object.
For Microsoft.Azure.Management.Insights.Models.LocationThresholdRuleCondition, use:
{
"failedLocationCount": "int",
"odata.type": "Microsoft.Azure.Management.Insights.Models.LocationThresholdRuleCondition",
"windowSize": "string"
}
For Microsoft.Azure.Management.Insights.Models.ManagementEventRuleCondition, use:
{
"aggregation": {
"operator": "string",
"threshold": "int",
"windowSize": "string"
},
"odata.type": "Microsoft.Azure.Management.Insights.Models.ManagementEventRuleCondition"
}
For Microsoft.Azure.Management.Insights.Models.ThresholdRuleCondition, use:
{
"odata.type": "Microsoft.Azure.Management.Insights.Models.ThresholdRuleCondition",
"operator": "string",
"threshold": "int",
"timeAggregation": "string",
"windowSize": "string"
}
Property values
AlertRule
Name | Description | Value |
---|---|---|
action | action that is performed when the alert rule becomes active, and when an alert condition is resolved. | RuleAction |
actions | the array of actions that are performed when the alert rule becomes active, and when an alert condition is resolved. | RuleAction[] |
condition | the condition that results in the alert rule being activated. | RuleCondition (required) |
description | the description of the alert rule that will be included in the alert email. | string |
isEnabled | the flag that indicates whether the alert rule is enabled. | bool (required) |
name | the name of the alert rule. | string (required) |
provisioningState | the provisioning state. | string |
LocationThresholdRuleCondition
Name | Description | Value |
---|---|---|
failedLocationCount | the number of locations that must fail to activate the alert. | int Constraints: Min value = 0 (required) |
odata.type | specifies the type of condition. This can be one of three types: ManagementEventRuleCondition (occurrences of management events), LocationThresholdRuleCondition (based on the number of failures of a web test), and ThresholdRuleCondition (based on the threshold of a metric). | 'Microsoft.Azure.Management.Insights.Models.LocationThresholdRuleCondition' (required) |
windowSize | the period of time (in ISO 8601 duration format) that is used to monitor alert activity based on the threshold. If specified then it must be between 5 minutes and 1 day. | string |
ManagementEventAggregationCondition
Name | Description | Value |
---|---|---|
operator | the condition operator. | 'GreaterThan' 'GreaterThanOrEqual' 'LessThan' 'LessThanOrEqual' |
threshold | The threshold value that activates the alert. | int |
windowSize | the period of time (in ISO 8601 duration format) that is used to monitor alert activity based on the threshold. If specified then it must be between 5 minutes and 1 day. | string |
ManagementEventRuleCondition
Name | Description | Value |
---|---|---|
aggregation | How the data that is collected should be combined over time and when the alert is activated. Note that for management event alerts aggregation is optional – if it is not provided then any event will cause the alert to activate. | ManagementEventAggregationCondition |
odata.type | specifies the type of condition. This can be one of three types: ManagementEventRuleCondition (occurrences of management events), LocationThresholdRuleCondition (based on the number of failures of a web test), and ThresholdRuleCondition (based on the threshold of a metric). | 'Microsoft.Azure.Management.Insights.Models.ManagementEventRuleCondition' (required) |
Microsoft.Insights/alertrules
Name | Description | Value |
---|---|---|
apiVersion | The api version | '2016-03-01' |
location | Resource location | string (required) |
name | The resource name | string (required) |
properties | The alert rule properties of the resource. | AlertRule (required) |
tags | Resource tags | Dictionary of tag names and values. See Tags in templates |
type | The resource type | 'Microsoft.Insights/alertrules' |
ResourceTags
Name | Description | Value |
---|
RuleAction
Name | Description | Value |
---|---|---|
odata.type | Set to 'Microsoft.Azure.Management.Insights.Models.RuleEmailAction' for type RuleEmailAction. Set to 'Microsoft.Azure.Management.Insights.Models.RuleWebhookAction' for type RuleWebhookAction. | 'Microsoft.Azure.Management.Insights.Models.RuleEmailAction' 'Microsoft.Azure.Management.Insights.Models.RuleWebhookAction' (required) |
RuleCondition
Name | Description | Value |
---|---|---|
dataSource | the resource from which the rule collects its data. For this type dataSource will always be of type RuleMetricDataSource. | RuleDataSource |
odata.type | Set to 'Microsoft.Azure.Management.Insights.Models.LocationThresholdRuleCondition' for type LocationThresholdRuleCondition. Set to 'Microsoft.Azure.Management.Insights.Models.ManagementEventRuleCondition' for type ManagementEventRuleCondition. Set to 'Microsoft.Azure.Management.Insights.Models.ThresholdRuleCondition' for type ThresholdRuleCondition. | 'Microsoft.Azure.Management.Insights.Models.LocationThresholdRuleCondition' 'Microsoft.Azure.Management.Insights.Models.ManagementEventRuleCondition' 'Microsoft.Azure.Management.Insights.Models.ThresholdRuleCondition' (required) |
RuleDataSource
Name | Description | Value |
---|---|---|
legacyResourceId | the legacy resource identifier of the resource the rule monitors. NOTE: this property cannot be updated for an existing rule. | string |
metricNamespace | the namespace of the metric. | string |
odata.type | Set to 'Microsoft.Azure.Management.Insights.Models.RuleManagementEventDataSource' for type RuleManagementEventDataSource. Set to 'Microsoft.Azure.Management.Insights.Models.RuleMetricDataSource' for type RuleMetricDataSource. | 'Microsoft.Azure.Management.Insights.Models.RuleManagementEventDataSource' 'Microsoft.Azure.Management.Insights.Models.RuleMetricDataSource' (required) |
resourceLocation | the location of the resource. | string |
resourceUri | the resource identifier of the resource the rule monitors. NOTE: this property cannot be updated for an existing rule. | string |
RuleEmailAction
Name | Description | Value |
---|---|---|
customEmails | the list of administrator's custom email addresses to notify of the activation of the alert. | string[] |
odata.type | specifies the type of the action. There are two types of actions: RuleEmailAction and RuleWebhookAction. | 'Microsoft.Azure.Management.Insights.Models.RuleEmailAction' (required) |
sendToServiceOwners | Whether the administrators (service and co-administrators) of the service should be notified when the alert is activated. | bool |
RuleManagementEventClaimsDataSource
Name | Description | Value |
---|---|---|
emailAddress | the email address. | string |
RuleManagementEventDataSource
Name | Description | Value |
---|---|---|
claims | the claims. | RuleManagementEventClaimsDataSource |
eventName | the event name. | string |
eventSource | the event source. | string |
level | the level. | string |
odata.type | specifies the type of data source. There are two types of rule data sources: RuleMetricDataSource and RuleManagementEventDataSource | 'Microsoft.Azure.Management.Insights.Models.RuleManagementEventDataSource' (required) |
operationName | The name of the operation that should be checked for. If no name is provided, any operation will match. | string |
resourceGroupName | the resource group name. | string |
resourceProviderName | the resource provider name. | string |
status | The status of the operation that should be checked for. If no status is provided, any status will match. | string |
subStatus | the substatus. | string |
RuleMetricDataSource
Name | Description | Value |
---|---|---|
metricName | the name of the metric that defines what the rule monitors. | string |
odata.type | specifies the type of data source. There are two types of rule data sources: RuleMetricDataSource and RuleManagementEventDataSource | 'Microsoft.Azure.Management.Insights.Models.RuleMetricDataSource' (required) |
RuleWebhookAction
Name | Description | Value |
---|---|---|
odata.type | specifies the type of the action. There are two types of actions: RuleEmailAction and RuleWebhookAction. | 'Microsoft.Azure.Management.Insights.Models.RuleWebhookAction' (required) |
properties | the dictionary of custom properties to include with the post operation. These data are appended to the webhook payload. | RuleWebhookActionProperties |
serviceUri | the service uri to Post the notification when the alert activates or resolves. | string |
RuleWebhookActionProperties
Name | Description | Value |
---|
ThresholdRuleCondition
Name | Description | Value |
---|---|---|
odata.type | specifies the type of condition. This can be one of three types: ManagementEventRuleCondition (occurrences of management events), LocationThresholdRuleCondition (based on the number of failures of a web test), and ThresholdRuleCondition (based on the threshold of a metric). | 'Microsoft.Azure.Management.Insights.Models.ThresholdRuleCondition' (required) |
operator | the operator used to compare the data and the threshold. | 'GreaterThan' 'GreaterThanOrEqual' 'LessThan' 'LessThanOrEqual' (required) |
threshold | the threshold value that activates the alert. | int (required) |
timeAggregation | the time aggregation operator. How the data that are collected should be combined over time. The default value is the PrimaryAggregationType of the Metric. | 'Average' 'Last' 'Maximum' 'Minimum' 'Total' |
windowSize | the period of time (in ISO 8601 duration format) that is used to monitor alert activity based on the threshold. If specified then it must be between 5 minutes and 1 day. | string |
Quickstart templates
The following quickstart templates deploy this resource type.
Template | Description |
---|---|
DDoS attack on a virtual machine |
This will deploy a virtual machine, OMS and other network resources. Perform the DDoS attack by following the guidleines and execute the scenario for detection of a DDoS attack. |
Terraform (AzAPI provider) resource definition
The alertrules resource type can be deployed with operations that target:
- Resource groups
For a list of changed properties in each API version, see change log.
Resource format
To create a Microsoft.Insights/alertrules resource, add the following Terraform to your template.
resource "azapi_resource" "symbolicname" {
type = "Microsoft.Insights/alertrules@2016-03-01"
name = "string"
location = "string"
tags = {
{customized property} = "string"
}
body = jsonencode({
properties = {
action = {
odata.type = "string"
// For remaining properties, see RuleAction objects
}
actions = [
{
odata.type = "string"
// For remaining properties, see RuleAction objects
}
]
condition = {
dataSource = {
legacyResourceId = "string"
metricNamespace = "string"
resourceLocation = "string"
resourceUri = "string"
odata.type = "string"
// For remaining properties, see RuleDataSource objects
}
odata.type = "string"
// For remaining properties, see RuleCondition objects
}
description = "string"
isEnabled = bool
name = "string"
provisioningState = "string"
}
})
}
RuleAction objects
Set the odata.type property to specify the type of object.
For Microsoft.Azure.Management.Insights.Models.RuleEmailAction, use:
{
customEmails = [
"string"
]
odata.type = "Microsoft.Azure.Management.Insights.Models.RuleEmailAction"
sendToServiceOwners = bool
}
For Microsoft.Azure.Management.Insights.Models.RuleWebhookAction, use:
{
odata.type = "Microsoft.Azure.Management.Insights.Models.RuleWebhookAction"
properties = {
{customized property} = "string"
}
serviceUri = "string"
}
RuleDataSource objects
Set the odata.type property to specify the type of object.
For Microsoft.Azure.Management.Insights.Models.RuleManagementEventDataSource, use:
{
claims = {
emailAddress = "string"
}
eventName = "string"
eventSource = "string"
level = "string"
odata.type = "Microsoft.Azure.Management.Insights.Models.RuleManagementEventDataSource"
operationName = "string"
resourceGroupName = "string"
resourceProviderName = "string"
status = "string"
subStatus = "string"
}
For Microsoft.Azure.Management.Insights.Models.RuleMetricDataSource, use:
{
metricName = "string"
odata.type = "Microsoft.Azure.Management.Insights.Models.RuleMetricDataSource"
}
RuleCondition objects
Set the odata.type property to specify the type of object.
For Microsoft.Azure.Management.Insights.Models.LocationThresholdRuleCondition, use:
{
failedLocationCount = int
odata.type = "Microsoft.Azure.Management.Insights.Models.LocationThresholdRuleCondition"
windowSize = "string"
}
For Microsoft.Azure.Management.Insights.Models.ManagementEventRuleCondition, use:
{
aggregation = {
operator = "string"
threshold = int
windowSize = "string"
}
odata.type = "Microsoft.Azure.Management.Insights.Models.ManagementEventRuleCondition"
}
For Microsoft.Azure.Management.Insights.Models.ThresholdRuleCondition, use:
{
odata.type = "Microsoft.Azure.Management.Insights.Models.ThresholdRuleCondition"
operator = "string"
threshold = int
timeAggregation = "string"
windowSize = "string"
}
Property values
AlertRule
Name | Description | Value |
---|---|---|
action | action that is performed when the alert rule becomes active, and when an alert condition is resolved. | RuleAction |
actions | the array of actions that are performed when the alert rule becomes active, and when an alert condition is resolved. | RuleAction[] |
condition | the condition that results in the alert rule being activated. | RuleCondition (required) |
description | the description of the alert rule that will be included in the alert email. | string |
isEnabled | the flag that indicates whether the alert rule is enabled. | bool (required) |
name | the name of the alert rule. | string (required) |
provisioningState | the provisioning state. | string |
LocationThresholdRuleCondition
Name | Description | Value |
---|---|---|
failedLocationCount | the number of locations that must fail to activate the alert. | int Constraints: Min value = 0 (required) |
odata.type | specifies the type of condition. This can be one of three types: ManagementEventRuleCondition (occurrences of management events), LocationThresholdRuleCondition (based on the number of failures of a web test), and ThresholdRuleCondition (based on the threshold of a metric). | 'Microsoft.Azure.Management.Insights.Models.LocationThresholdRuleCondition' (required) |
windowSize | the period of time (in ISO 8601 duration format) that is used to monitor alert activity based on the threshold. If specified then it must be between 5 minutes and 1 day. | string |
ManagementEventAggregationCondition
Name | Description | Value |
---|---|---|
operator | the condition operator. | 'GreaterThan' 'GreaterThanOrEqual' 'LessThan' 'LessThanOrEqual' |
threshold | The threshold value that activates the alert. | int |
windowSize | the period of time (in ISO 8601 duration format) that is used to monitor alert activity based on the threshold. If specified then it must be between 5 minutes and 1 day. | string |
ManagementEventRuleCondition
Name | Description | Value |
---|---|---|
aggregation | How the data that is collected should be combined over time and when the alert is activated. Note that for management event alerts aggregation is optional – if it is not provided then any event will cause the alert to activate. | ManagementEventAggregationCondition |
odata.type | specifies the type of condition. This can be one of three types: ManagementEventRuleCondition (occurrences of management events), LocationThresholdRuleCondition (based on the number of failures of a web test), and ThresholdRuleCondition (based on the threshold of a metric). | 'Microsoft.Azure.Management.Insights.Models.ManagementEventRuleCondition' (required) |
Microsoft.Insights/alertrules
Name | Description | Value |
---|---|---|
location | Resource location | string (required) |
name | The resource name | string (required) |
properties | The alert rule properties of the resource. | AlertRule (required) |
tags | Resource tags | Dictionary of tag names and values. |
type | The resource type | "Microsoft.Insights/alertrules@2016-03-01" |
ResourceTags
Name | Description | Value |
---|
RuleAction
Name | Description | Value |
---|---|---|
odata.type | Set to 'Microsoft.Azure.Management.Insights.Models.RuleEmailAction' for type RuleEmailAction. Set to 'Microsoft.Azure.Management.Insights.Models.RuleWebhookAction' for type RuleWebhookAction. | 'Microsoft.Azure.Management.Insights.Models.RuleEmailAction' 'Microsoft.Azure.Management.Insights.Models.RuleWebhookAction' (required) |
RuleCondition
Name | Description | Value |
---|---|---|
dataSource | the resource from which the rule collects its data. For this type dataSource will always be of type RuleMetricDataSource. | RuleDataSource |
odata.type | Set to 'Microsoft.Azure.Management.Insights.Models.LocationThresholdRuleCondition' for type LocationThresholdRuleCondition. Set to 'Microsoft.Azure.Management.Insights.Models.ManagementEventRuleCondition' for type ManagementEventRuleCondition. Set to 'Microsoft.Azure.Management.Insights.Models.ThresholdRuleCondition' for type ThresholdRuleCondition. | 'Microsoft.Azure.Management.Insights.Models.LocationThresholdRuleCondition' 'Microsoft.Azure.Management.Insights.Models.ManagementEventRuleCondition' 'Microsoft.Azure.Management.Insights.Models.ThresholdRuleCondition' (required) |
RuleDataSource
Name | Description | Value |
---|---|---|
legacyResourceId | the legacy resource identifier of the resource the rule monitors. NOTE: this property cannot be updated for an existing rule. | string |
metricNamespace | the namespace of the metric. | string |
odata.type | Set to 'Microsoft.Azure.Management.Insights.Models.RuleManagementEventDataSource' for type RuleManagementEventDataSource. Set to 'Microsoft.Azure.Management.Insights.Models.RuleMetricDataSource' for type RuleMetricDataSource. | 'Microsoft.Azure.Management.Insights.Models.RuleManagementEventDataSource' 'Microsoft.Azure.Management.Insights.Models.RuleMetricDataSource' (required) |
resourceLocation | the location of the resource. | string |
resourceUri | the resource identifier of the resource the rule monitors. NOTE: this property cannot be updated for an existing rule. | string |
RuleEmailAction
Name | Description | Value |
---|---|---|
customEmails | the list of administrator's custom email addresses to notify of the activation of the alert. | string[] |
odata.type | specifies the type of the action. There are two types of actions: RuleEmailAction and RuleWebhookAction. | 'Microsoft.Azure.Management.Insights.Models.RuleEmailAction' (required) |
sendToServiceOwners | Whether the administrators (service and co-administrators) of the service should be notified when the alert is activated. | bool |
RuleManagementEventClaimsDataSource
Name | Description | Value |
---|---|---|
emailAddress | the email address. | string |
RuleManagementEventDataSource
Name | Description | Value |
---|---|---|
claims | the claims. | RuleManagementEventClaimsDataSource |
eventName | the event name. | string |
eventSource | the event source. | string |
level | the level. | string |
odata.type | specifies the type of data source. There are two types of rule data sources: RuleMetricDataSource and RuleManagementEventDataSource | 'Microsoft.Azure.Management.Insights.Models.RuleManagementEventDataSource' (required) |
operationName | The name of the operation that should be checked for. If no name is provided, any operation will match. | string |
resourceGroupName | the resource group name. | string |
resourceProviderName | the resource provider name. | string |
status | The status of the operation that should be checked for. If no status is provided, any status will match. | string |
subStatus | the substatus. | string |
RuleMetricDataSource
Name | Description | Value |
---|---|---|
metricName | the name of the metric that defines what the rule monitors. | string |
odata.type | specifies the type of data source. There are two types of rule data sources: RuleMetricDataSource and RuleManagementEventDataSource | 'Microsoft.Azure.Management.Insights.Models.RuleMetricDataSource' (required) |
RuleWebhookAction
Name | Description | Value |
---|---|---|
odata.type | specifies the type of the action. There are two types of actions: RuleEmailAction and RuleWebhookAction. | 'Microsoft.Azure.Management.Insights.Models.RuleWebhookAction' (required) |
properties | the dictionary of custom properties to include with the post operation. These data are appended to the webhook payload. | RuleWebhookActionProperties |
serviceUri | the service uri to Post the notification when the alert activates or resolves. | string |
RuleWebhookActionProperties
Name | Description | Value |
---|
ThresholdRuleCondition
Name | Description | Value |
---|---|---|
odata.type | specifies the type of condition. This can be one of three types: ManagementEventRuleCondition (occurrences of management events), LocationThresholdRuleCondition (based on the number of failures of a web test), and ThresholdRuleCondition (based on the threshold of a metric). | 'Microsoft.Azure.Management.Insights.Models.ThresholdRuleCondition' (required) |
operator | the operator used to compare the data and the threshold. | 'GreaterThan' 'GreaterThanOrEqual' 'LessThan' 'LessThanOrEqual' (required) |
threshold | the threshold value that activates the alert. | int (required) |
timeAggregation | the time aggregation operator. How the data that are collected should be combined over time. The default value is the PrimaryAggregationType of the Metric. | 'Average' 'Last' 'Maximum' 'Minimum' 'Total' |
windowSize | the period of time (in ISO 8601 duration format) that is used to monitor alert activity based on the threshold. If specified then it must be between 5 minutes and 1 day. | string |