Microsoft. Métrica de Insights Alertas

Observaciones

Para orientación sobre el despliegue de soluciones de monitorización, consulte Crear recursos de monitorización utilizando Bicep.

Definición de recurso Bicep

El tipo de recurso metricAlerts se puede implementar con operaciones que tienen como destino:

grupos de recursos: consulte comandos de implementación de grupos de recursos

Para obtener una lista de las propiedades modificadas en cada versión de API, consulte registro de cambios.

Formato de recurso

Para crear un Microsoft. Recurso Insights/metricAlerts, añade el siguiente Bicep a tu plantilla.

resource symbolicname 'Microsoft.Insights/metricAlerts@2024-03-01-preview' = {
  identity: {
    type: 'string'
    userAssignedIdentities: {
      {customized property}: {}
    }
  }
  location: 'string'
  name: 'string'
  properties: {
    actionProperties: {
      {customized property}: 'string'
    }
    actions: [
      {
        actionGroupId: 'string'
        webHookProperties: {
          {customized property}: 'string'
        }
      }
    ]
    autoMitigate: bool
    criteria: {
      odata.type: 'string'
      // For remaining properties, see MetricAlertCriteria objects
    }
    customProperties: {
      {customized property}: 'string'
    }
    description: 'string'
    enabled: bool
    evaluationFrequency: 'string'
    resolveConfiguration: {
      autoResolved: bool
      timeToResolve: 'string'
    }
    scopes: [
      'string'
    ]
    severity: int
    targetResourceRegion: 'string'
    targetResourceType: 'string'
    windowSize: 'string'
  }
  tags: {
    {customized property}: 'string'
  }
}

Objetos MultiPromQLCriteria

Establezca la propiedad criterionType para especificar el tipo de objeto.

Para DynamicThresholdCriterion, use:

{
  alertSensitivity: 'string'
  criterionType: 'DynamicThresholdCriterion'
  ignoreDataBefore: 'string'
  operator: 'string'
}

Para StaticThresholdCriterion, use:

{
  criterionType: 'StaticThresholdCriterion'
}

Objetos MultiMetricCriteria

Establezca la propiedad criterionType para especificar el tipo de objeto.

Para DynamicThresholdCriterion, use:

{
  alertSensitivity: 'string'
  criterionType: 'DynamicThresholdCriterion'
  failingPeriods: {
    minFailingPeriodsToAlert: int
    numberOfEvaluationPeriods: int
  }
  ignoreDataBefore: 'string'
  operator: 'string'
}

Para StaticThresholdCriterion, use:

{
  criterionType: 'StaticThresholdCriterion'
  operator: 'string'
  threshold: int
}

Objetos MetricAlertCriteria

Establezca la propiedad odata.type para especificar el tipo de objeto.

Para Microsoft.Azure. Monitor.MultipleResourceMultipleMultipleMetricCriteria, utilizar:

{
  allOf: [
    {
      dimensions: [
        {
          name: 'string'
          operator: 'string'
          values: [
            'string'
          ]
        }
      ]
      metricName: 'string'
      metricNamespace: 'string'
      name: 'string'
      skipMetricValidation: bool
      timeAggregation: 'string'
      criterionType: 'string'
      // For remaining properties, see MultiMetricCriteria objects
    }
  ]
  odata.type: 'Microsoft.Azure.Monitor.MultipleResourceMultipleMetricCriteria'
}

Para Microsoft.Azure. Monitor.PromQLCriteria, utilizar:

{
  allOf: [
    {
      name: 'string'
      query: 'string'
      criterionType: 'string'
      // For remaining properties, see MultiPromQLCriteria objects
    }
  ]
  failingPeriods: {
    for: 'string'
  }
  odata.type: 'Microsoft.Azure.Monitor.PromQLCriteria'
}

Para Microsoft.Azure. Monitor.SingleResourceMultipleMetricCriteria, utilizar:

{
  allOf: [
    {
      criterionType: 'string'
      dimensions: [
        {
          name: 'string'
          operator: 'string'
          values: [
            'string'
          ]
        }
      ]
      metricName: 'string'
      metricNamespace: 'string'
      name: 'string'
      operator: 'string'
      skipMetricValidation: bool
      threshold: int
      timeAggregation: 'string'
    }
  ]
  odata.type: 'Microsoft.Azure.Monitor.SingleResourceMultipleMetricCriteria'
}

Para Microsoft.Azure. Monitor.WebtestLocationAvailabilityCriteria, utilizar:

{
  componentId: 'string'
  failedLocationCount: int
  odata.type: 'Microsoft.Azure.Monitor.WebtestLocationAvailabilityCriteria'
  webTestId: 'string'
}

Valores de propiedad

Microsoft. Alertas de Insights/métricas

Nombre	Descripción	Valor
identity	Identidad del recurso.	MicrosoftCommonIdentity
ubicación	Ubicación geográfica donde reside el recurso	string (obligatorio)
nombre	El nombre del recurso	string (obligatorio)
Propiedades	Las propiedades de la regla de alerta del recurso.	MetricAlertProperties (obligatorio)
Etiquetas	Etiquetas de recursos	Diccionario de nombres y valores de etiqueta. Consulte etiquetas de en plantillas

DynamicMetricCriteria

Nombre	Descripción	Valor
alertSensitivity	Extensión de desviación necesaria para desencadenar una alerta. Esto afectará a la limitación del umbral al patrón de serie de métricas. Es posible que se devuelvan valores no documentados anteriormente	"Alto" "Bajo" 'Medium' (obligatorio)
criterionType	Especifica el tipo de criterios de umbral. Es posible que se devuelvan valores no documentados anteriormente	'DynamicThresholdCriterion' (obligatorio)
errorPeriods	Número mínimo de infracciones necesarias en el período de tiempo de búsqueda seleccionado necesario para generar una alerta.	dynamicThresholdFailingPeriods (obligatorio)
ignoreDataBefore	Use esta opción para establecer la fecha desde la que empezar a aprender los datos históricos de métricas y calcular los umbrales dinámicos (en formato ISO8601)	cuerda
operador	Operador que se usa para comparar el valor de la métrica con respecto al umbral. Es posible que se devuelvan valores no documentados anteriormente	'Mayoro Menor que' 'Más grande que' 'LessThan' (obligatorio)

DynamicPromQLCriteria

Nombre	Descripción	Valor
alertSensitivity	Extensión de desviación necesaria para desencadenar una alerta. Esto afectará a la limitación del umbral al patrón de serie de métricas. Es posible que se devuelvan valores no documentados anteriormente	"Alto" "Bajo" 'Medium' (obligatorio)
criterionType	Especifica el tipo de criterios de umbral. Es posible que se devuelvan valores no documentados anteriormente	'DynamicThresholdCriterion' (obligatorio)
ignoreDataBefore	Use esta opción para establecer la fecha desde la que empezar a aprender los datos históricos de métricas y calcular los umbrales dinámicos (en formato ISO8601)	cuerda
operador	Operador que se usa para comparar el valor de la métrica con respecto al umbral. Es posible que se devuelvan valores no documentados anteriormente	'Mayoro Menor que' 'Más grande que' 'LessThan' (obligatorio)

DynamicThresholdFailingPeriods

Nombre	Descripción	Valor
minFailingPeriodsToAlert	Número de infracciones para desencadenar una alerta. Debe ser menor o igual que numberOfEvaluationPeriods.	int (obligatorio)
númeroDePeriodosDeEvaluación	Número de puntos de búsqueda agregados. El período de tiempo de búsqueda se calcula en función de la granularidad de agregación (windowSize) y del número seleccionado de puntos agregados.	int (obligatorio)

MetricAlertAction

Nombre	Descripción	Valor
actionGroupId	Identificador del grupo de acciones que se va a usar.	cuerda
webHookProperties	Este campo permite especificar propiedades personalizadas, que se anexarían a la carga de alerta enviada como entrada al webhook.	MetricAlertActionWebHookProperties

MetricAlertActionWebHookProperties

Nombre	Descripción	Valor

MetricAlertCriteria

Nombre	Descripción	Valor
odata.type	Configura en 'Microsoft.Azure. Monitor.MultipleResourceMultipleMetricCriteria' para el tipo MetricAlertMultipleResourceMultipleMultipleMetricCriteria. Configura en 'Microsoft.Azure. Monitor.PromQLCriteria' para el tipo PromQLCriteria. Configura en 'Microsoft.Azure. Monitor.SingleResourceMultipleMetricCriteria' para el tipo MetricAlertSingleResourceMultipleMetricCriteria. Configura en 'Microsoft.Azure. Monitor.WebtestUbicaciónCriteriosDisponibilidad' para tipo WebtestLocalizaciónCriteriosDisponibilidad.	'Microsoft.Azure. Monitor.MultipleResourceMultipleMetricCriteria' 'Microsoft.Azure. Monitor.PromQLCriteria' 'Microsoft.Azure. Monitor.CriteriosMultipleMétricos 'Microsoft.Azure. Monitor.WebtestLocalizaciónDisponibilidad' (obligatorio)

MetricAlertMultipleResourceMultipleMetricCriteria

Nombre	Descripción	Valor
allOf	La lista de múltiples criterios de métricas para esta operación "toda".	MultiMetricCriteria[]
odata.type	Especifica el tipo de criterios de alerta. Es posible que se devuelvan valores no documentados anteriormente	'Microsoft.Azure. Monitor.MultipleResourceMultipleMultipleMetricCriteria' (obligatorio)

MetricAlertProperties

Nombre	Descripción	Valor
actionProperties	Propiedades de una acción.	MetricAlertPropertiesActionProperties
Acciones	Matriz de acciones que se realizan cuando la regla de alerta se activa y cuando se resuelve una condición de alerta.	MetricAlertAction[]
Mitigación automática	La marca que indica si la alerta debe resolverse automáticamente o no. El valor predeterminado es true.	Bool
criterios	Define la información específica de los criterios de alerta.	MetricAlertCriteria (obligatorio)
customProperties	Propiedades de una carga de alerta.	MetricAlertPropertiesCustomProperties
descripción	La descripción de la alerta de métrica que se incluirá en el correo electrónico de alerta.	cuerda
Habilitado	Marca que indica si la alerta de métrica está habilitada.	bool (obligatorio)
Frecuencia: evaluación	La frecuencia con la que se evalúa la alerta métrica representada en formato de duración ISO 8601.	string (obligatorio)
resolveConfiguration	La configuración de cómo se resuelve la alerta. Aplicable para PromQLCriteria.	ResoluciónConfiguración
Ámbitos	La lista de identificadores de recursos a los que se limita esta alerta de métrica. No se puede cambiar el ámbito de una regla de métricas en función de los registros.	string[] (obligatorio)
severidad	Gravedad de alerta {0, 1, 2, 3, 4}	int (obligatorio)
targetResourceRegion	La región de los recursos de destino en la que se crea o actualiza la alerta. Obligatorio si el ámbito contiene una suscripción, un grupo de recursos o más de un recurso.	cuerda
targetResourceType	Tipo de recurso de los recursos de destino en los que se crea o actualiza la alerta. Obligatorio si el ámbito contiene una suscripción, un grupo de recursos o más de un recurso.	cuerda
tamaño de ventana	El período de tiempo (en formato de duración ISO 8601) que se utiliza para supervisar la actividad de alertas en función del umbral.	cuerda

MetricAlertPropertiesActionProperties

Nombre	Descripción	Valor

MetricAlertPropertiesCustomProperties

Nombre	Descripción	Valor

MetricAlertSingleResourceMultipleMetricCriteria

Nombre	Descripción	Valor
allOf	Lista de criterios de métrica para esta operación "todo".	CriteriosMétricos[]
odata.type	Especifica el tipo de criterios de alerta. Es posible que se devuelvan valores no documentados anteriormente	'Microsoft.Azure. Monitor.SingleResourceMultipleMetricCriteria' (obligatorio)

Criterios métricos

Nombre	Descripción	Valor
criterionType	Especifica el tipo de criterios de umbral. Es posible que se devuelvan valores no documentados anteriormente	'DynamicThresholdCriterion' 'StaticThresholdCriterion' (obligatorio)
Dimensiones	Lista de condiciones de dimensión.	MetricDimension[]
metricName	Nombre de la métrica.	string (obligatorio)
metricNamespace	Namespace de la métrica.	cuerda
nombre	Nombre de los criterios.	string (obligatorio)
operador	Operador criteria. Es posible que se devuelvan valores no documentados anteriormente	'Iguales' 'Más grande que' 'MayorQueIgual' 'Menos que' 'LessThanOrEqual' (obligatorio)
skipMetricValidation	Permite crear una regla de alerta en una métrica personalizada que aún no se ha emitido, lo que provoca que se omita la validación de métricas.	Bool
umbral	El valor de umbral de criterios que activa la alerta.	int (obligatorio)
timeAggregation	Los criterios de agregación de tiempo. Es posible que se devuelvan valores no documentados anteriormente	'Promedio' 'Conteo' 'Máximo' "Mínimo" 'Total' (obligatorio)

Criterios métricos

Nombre	Descripción	Valor
criterionType	Especifica el tipo de criterios de umbral. Es posible que se devuelvan valores no documentados anteriormente	'StaticThresholdCriterion' (obligatorio)
operador	Operador criteria. Es posible que se devuelvan valores no documentados anteriormente	'Iguales' 'Más grande que' 'MayorQueIgual' 'Menos que' 'LessThanOrEqual' (obligatorio)
umbral	El valor de umbral de criterios que activa la alerta.	int (obligatorio)

MetricDimension

Nombre	Descripción	Valor
nombre	Nombre de la dimensión.	string (obligatorio)
operador	El operador de dimensión. Solo se admiten 'Include' y 'Exclude'	string (obligatorio)
valores	Lista de valores de dimensión.	string[] (obligatorio)

MicrosoftCommonIdentity

Nombre	Descripción	Valor
tipo	Tipo de identidad de servicio administrada.	'None' 'SystemAssigned' 'UserAssigned' (obligatorio)
userAssignedIdentities	Lista de identidades de usuario asociadas al recurso. Las referencias de clave de diccionario de identidad de usuario serán identificadores de recursos de ARM con el formato: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}'.	MicrosoftCommonIdentityUserAssignedIdentities

MicrosoftCommonIdentityUserAssignedIdentities

Nombre	Descripción	Valor

MicrosoftCommonUserIdentityProperties

Nombre	Descripción	Valor

MultiMetricCriteria

Nombre	Descripción	Valor
criterionType	Establezca en "DynamicThresholdCriterion" para el tipo DynamicMetricCriteria. Establezca en "StaticThresholdCriterion" para el tipo MetricCriteria.	'DynamicThresholdCriterion' 'StaticThresholdCriterion' (obligatorio)
Dimensiones	Lista de condiciones de dimensión.	MetricDimension[]
metricName	Nombre de la métrica.	string (obligatorio)
metricNamespace	Namespace de la métrica.	cuerda
nombre	Nombre de los criterios.	string (obligatorio)
skipMetricValidation	Permite crear una regla de alerta en una métrica personalizada que aún no se ha emitido, lo que provoca que se omita la validación de métricas.	Bool
timeAggregation	Los criterios de agregación de tiempo. Es posible que se devuelvan valores no documentados anteriormente	'Promedio' 'Conteo' 'Máximo' "Mínimo" 'Total' (obligatorio)

MultiPromQLCriteria

Nombre	Descripción	Valor
criterionType	Establézcalo en 'DynamicThresholdCriterion' para el tipo DynamicPromQLCriteria. Establézcalo en 'StaticThresholdCriterion' para el tipo StaticPromQLCriteria.	'DynamicThresholdCriterion' 'StaticThresholdCriterion' (obligatorio)
nombre	Nombre de los criterios.	string (obligatorio)
query	La consulta utilizada para evaluar la regla de alerta	string (obligatorio)

PromQLCriteria

Nombre	Descripción	Valor
allOf	La lista de criterios de promQL. La alerta se activará cuando se cumplan todas las condiciones.	MultiPromQLCriteria[]
errorPeriods	Configuración de períodos de error en alertas basadas en consultas.	QueryFailingPeriods
odata.type	Especifica el tipo de criterios de alerta. Es posible que se devuelvan valores no documentados anteriormente	'Microsoft.Azure. Monitor.PromQLCriteria' (obligatorio)

QueryFailingPeriods

Nombre	Descripción	Valor
for	La cantidad de tiempo (en formato de duración ISO 8601) de alerta debe estar activa antes de disparar.	string (obligatorio)

ResoluciónConfiguración

Nombre	Descripción	Valor
Resuelto automáticamente	Indica si la alerta debe resolverse automáticamente	bool (obligatorio)
timeToResolve	La hora (en formato de duración ISO 8601) después de la cual la alerta debe resolverse automáticamente	cuerda

StaticPromQLCriteria

Nombre	Descripción	Valor
criterionType	Especifica el tipo de criterios de umbral. Es posible que se devuelvan valores no documentados anteriormente	'StaticThresholdCriterion' (obligatorio)

TrackedResourceTags

Nombre	Descripción	Valor

WebtestLocationAvailabilityCriteria

Nombre	Descripción	Valor
componentId	Identificador de recurso de Application Insights.	string (obligatorio)
failedLocationCount	Número de ubicaciones con errores.	int (obligatorio)
odata.type	Especifica el tipo de criterios de alerta. Es posible que se devuelvan valores no documentados anteriormente	'Microsoft.Azure. Monitor.WebtestLocalizaciónDisponibilidad' (obligatorio)
webTestId	Identificador de prueba web de Application Insights.	string (obligatorio)

Ejemplos de uso

Muestras de Bicep

Un ejemplo básico de cómo desplegar Metric Alert dentro de Azure Monitor.

param resourceName string = 'acctest0001'
param location string = 'westeurope'

resource metricAlert 'Microsoft.Insights/metricAlerts@2018-03-01' = {
  name: resourceName
  location: 'global'
  properties: {
    actions: []
    autoMitigate: true
    criteria: {
      allOf: [
        {
          criterionType: 'StaticThresholdCriterion'
          dimensions: []
          metricName: 'UsedCapacity'
          metricNamespace: 'Microsoft.Storage/storageAccounts'
          name: 'Metric1'
          operator: 'GreaterThan'
          skipMetricValidation: false
          threshold: any('55.5')
          timeAggregation: 'Average'
        }
      ]
      'odata.type': 'Microsoft.Azure.Monitor.MultipleResourceMultipleMetricCriteria'
    }
    description: ''
    enabled: true
    evaluationFrequency: 'PT1M'
    scopes: [
      storageAccount.id
    ]
    severity: 3
    targetResourceRegion: ''
    targetResourceType: ''
    windowSize: 'PT1H'
  }
  tags: {
    CUSTOMER: 'CUSTOMERx'
    Example: 'Example123'
    terraform: 'Coolllll'
    test: '123'
  }
}

resource storageAccount 'Microsoft.Storage/storageAccounts@2021-09-01' = {
  name: resourceName
  location: location
  sku: {
    name: 'Standard_LRS'
  }
  kind: 'StorageV2'
  properties: {
    accessTier: 'Hot'
    allowBlobPublicAccess: true
    allowCrossTenantReplication: true
    allowSharedKeyAccess: true
    defaultToOAuthAuthentication: false
    encryption: {
      keySource: 'Microsoft.Storage'
      services: {
        queue: {
          keyType: 'Service'
        }
        table: {
          keyType: 'Service'
        }
      }
    }
    isHnsEnabled: false
    isNfsV3Enabled: false
    isSftpEnabled: false
    minimumTlsVersion: 'TLS1_2'
    networkAcls: {
      defaultAction: 'Allow'
    }
    publicNetworkAccess: 'Enabled'
    supportsHttpsTrafficOnly: true
  }
}

Módulos comprobados de Azure

Los siguientes módulos verificados Azure pueden usarse para desplegar este tipo de recurso.

Módulo	Descripción
Alerta Métrica	Módulo de recursos de AVM para alertas de métricas

Ejemplos de inicio rápido de Azure

Las siguientes plantillas de inicio rápido Azure contienen Bicep ejemplos para desplegar este tipo de recurso.

Archivo Bicep	Descripción
Despliega Application Insight y crea alertas en él	Esta plantilla le permite implementar Application Insight y crear alertas en ella.

Definición de recursos de plantilla de ARM

El tipo de recurso metricAlerts se puede implementar con operaciones que tienen como destino:

grupos de recursos: consulte comandos de implementación de grupos de recursos

Para obtener una lista de las propiedades modificadas en cada versión de API, consulte registro de cambios.

Formato de recurso

Para crear un Microsoft. Recursos/metricAlerts, añade el siguiente JSON a tu plantilla.

{
  "type": "Microsoft.Insights/metricAlerts",
  "apiVersion": "2024-03-01-preview",
  "name": "string",
  "identity": {
    "type": "string",
    "userAssignedIdentities": {
      "{customized property}": {
      }
    }
  },
  "location": "string",
  "properties": {
    "actionProperties": {
      "{customized property}": "string"
    },
    "actions": [
      {
        "actionGroupId": "string",
        "webHookProperties": {
          "{customized property}": "string"
        }
      }
    ],
    "autoMitigate": "bool",
    "criteria": {
      "odata.type": "string"
      // For remaining properties, see MetricAlertCriteria objects
    },
    "customProperties": {
      "{customized property}": "string"
    },
    "description": "string",
    "enabled": "bool",
    "evaluationFrequency": "string",
    "resolveConfiguration": {
      "autoResolved": "bool",
      "timeToResolve": "string"
    },
    "scopes": [ "string" ],
    "severity": "int",
    "targetResourceRegion": "string",
    "targetResourceType": "string",
    "windowSize": "string"
  },
  "tags": {
    "{customized property}": "string"
  }
}

Objetos MultiPromQLCriteria

Establezca la propiedad criterionType para especificar el tipo de objeto.

Para DynamicThresholdCriterion, use:

{
  "alertSensitivity": "string",
  "criterionType": "DynamicThresholdCriterion",
  "ignoreDataBefore": "string",
  "operator": "string"
}

Para StaticThresholdCriterion, use:

{
  "criterionType": "StaticThresholdCriterion"
}

Objetos MultiMetricCriteria

Establezca la propiedad criterionType para especificar el tipo de objeto.

Para DynamicThresholdCriterion, use:

{
  "alertSensitivity": "string",
  "criterionType": "DynamicThresholdCriterion",
  "failingPeriods": {
    "minFailingPeriodsToAlert": "int",
    "numberOfEvaluationPeriods": "int"
  },
  "ignoreDataBefore": "string",
  "operator": "string"
}

Para StaticThresholdCriterion, use:

{
  "criterionType": "StaticThresholdCriterion",
  "operator": "string",
  "threshold": "int"
}

Objetos MetricAlertCriteria

Establezca la propiedad odata.type para especificar el tipo de objeto.

Para Microsoft.Azure. Monitor.MultipleResourceMultipleMultipleMetricCriteria, utilizar:

{
  "allOf": [ {
    "dimensions": [
      {
        "name": "string",
        "operator": "string",
        "values": [ "string" ]
      }
    ],
    "metricName": "string",
    "metricNamespace": "string",
    "name": "string",
    "skipMetricValidation": "bool",
    "timeAggregation": "string",
    "criterionType": "string"
    // For remaining properties, see MultiMetricCriteria objects
  } ],
  "odata.type": "Microsoft.Azure.Monitor.MultipleResourceMultipleMetricCriteria"
}

Para Microsoft.Azure. Monitor.PromQLCriteria, utilizar:

{
  "allOf": [ {
    "name": "string",
    "query": "string",
    "criterionType": "string"
    // For remaining properties, see MultiPromQLCriteria objects
  } ],
  "failingPeriods": {
    "for": "string"
  },
  "odata.type": "Microsoft.Azure.Monitor.PromQLCriteria"
}

Para Microsoft.Azure. Monitor.SingleResourceMultipleMetricCriteria, utilizar:

{
  "allOf": [
    {
      "criterionType": "string",
      "dimensions": [
        {
          "name": "string",
          "operator": "string",
          "values": [ "string" ]
        }
      ],
      "metricName": "string",
      "metricNamespace": "string",
      "name": "string",
      "operator": "string",
      "skipMetricValidation": "bool",
      "threshold": "int",
      "timeAggregation": "string"
    }
  ],
  "odata.type": "Microsoft.Azure.Monitor.SingleResourceMultipleMetricCriteria"
}

Para Microsoft.Azure. Monitor.WebtestLocationAvailabilityCriteria, utilizar:

{
  "componentId": "string",
  "failedLocationCount": "int",
  "odata.type": "Microsoft.Azure.Monitor.WebtestLocationAvailabilityCriteria",
  "webTestId": "string"
}

Valores de propiedad

Microsoft. Alertas de Insights/métricas

Nombre	Descripción	Valor
apiVersion	La versión de api	'2024-03-01-preview'
identity	Identidad del recurso.	MicrosoftCommonIdentity
ubicación	Ubicación geográfica donde reside el recurso	string (obligatorio)
nombre	El nombre del recurso	string (obligatorio)
Propiedades	Las propiedades de la regla de alerta del recurso.	MetricAlertProperties (obligatorio)
Etiquetas	Etiquetas de recursos	Diccionario de nombres y valores de etiqueta. Consulte etiquetas de en plantillas
tipo	El tipo de recurso	'Microsoft. Alertas de Insights/métricas

DynamicMetricCriteria

Nombre	Descripción	Valor
alertSensitivity	Extensión de desviación necesaria para desencadenar una alerta. Esto afectará a la limitación del umbral al patrón de serie de métricas. Es posible que se devuelvan valores no documentados anteriormente	"Alto" "Bajo" 'Medium' (obligatorio)
criterionType	Especifica el tipo de criterios de umbral. Es posible que se devuelvan valores no documentados anteriormente	'DynamicThresholdCriterion' (obligatorio)
errorPeriods	Número mínimo de infracciones necesarias en el período de tiempo de búsqueda seleccionado necesario para generar una alerta.	dynamicThresholdFailingPeriods (obligatorio)
ignoreDataBefore	Use esta opción para establecer la fecha desde la que empezar a aprender los datos históricos de métricas y calcular los umbrales dinámicos (en formato ISO8601)	cuerda
operador	Operador que se usa para comparar el valor de la métrica con respecto al umbral. Es posible que se devuelvan valores no documentados anteriormente	'Mayoro Menor que' 'Más grande que' 'LessThan' (obligatorio)

DynamicPromQLCriteria

Nombre	Descripción	Valor
alertSensitivity	Extensión de desviación necesaria para desencadenar una alerta. Esto afectará a la limitación del umbral al patrón de serie de métricas. Es posible que se devuelvan valores no documentados anteriormente	"Alto" "Bajo" 'Medium' (obligatorio)
criterionType	Especifica el tipo de criterios de umbral. Es posible que se devuelvan valores no documentados anteriormente	'DynamicThresholdCriterion' (obligatorio)
ignoreDataBefore	Use esta opción para establecer la fecha desde la que empezar a aprender los datos históricos de métricas y calcular los umbrales dinámicos (en formato ISO8601)	cuerda
operador	Operador que se usa para comparar el valor de la métrica con respecto al umbral. Es posible que se devuelvan valores no documentados anteriormente	'Mayoro Menor que' 'Más grande que' 'LessThan' (obligatorio)

DynamicThresholdFailingPeriods

Nombre	Descripción	Valor
minFailingPeriodsToAlert	Número de infracciones para desencadenar una alerta. Debe ser menor o igual que numberOfEvaluationPeriods.	int (obligatorio)
númeroDePeriodosDeEvaluación	Número de puntos de búsqueda agregados. El período de tiempo de búsqueda se calcula en función de la granularidad de agregación (windowSize) y del número seleccionado de puntos agregados.	int (obligatorio)

MetricAlertAction

Nombre	Descripción	Valor
actionGroupId	Identificador del grupo de acciones que se va a usar.	cuerda
webHookProperties	Este campo permite especificar propiedades personalizadas, que se anexarían a la carga de alerta enviada como entrada al webhook.	MetricAlertActionWebHookProperties

MetricAlertActionWebHookProperties

Nombre	Descripción	Valor

MetricAlertCriteria

Nombre	Descripción	Valor
odata.type	Configura en 'Microsoft.Azure. Monitor.MultipleResourceMultipleMetricCriteria' para el tipo MetricAlertMultipleResourceMultipleMultipleMetricCriteria. Configura en 'Microsoft.Azure. Monitor.PromQLCriteria' para el tipo PromQLCriteria. Configura en 'Microsoft.Azure. Monitor.SingleResourceMultipleMetricCriteria' para el tipo MetricAlertSingleResourceMultipleMetricCriteria. Configura en 'Microsoft.Azure. Monitor.WebtestUbicaciónCriteriosDisponibilidad' para tipo WebtestLocalizaciónCriteriosDisponibilidad.	'Microsoft.Azure. Monitor.MultipleResourceMultipleMetricCriteria' 'Microsoft.Azure. Monitor.PromQLCriteria' 'Microsoft.Azure. Monitor.CriteriosMultipleMétricos 'Microsoft.Azure. Monitor.WebtestLocalizaciónDisponibilidad' (obligatorio)

MetricAlertMultipleResourceMultipleMetricCriteria

Nombre	Descripción	Valor
allOf	La lista de múltiples criterios de métricas para esta operación "toda".	MultiMetricCriteria[]
odata.type	Especifica el tipo de criterios de alerta. Es posible que se devuelvan valores no documentados anteriormente	'Microsoft.Azure. Monitor.MultipleResourceMultipleMultipleMetricCriteria' (obligatorio)

MetricAlertProperties

Nombre	Descripción	Valor
actionProperties	Propiedades de una acción.	MetricAlertPropertiesActionProperties
Acciones	Matriz de acciones que se realizan cuando la regla de alerta se activa y cuando se resuelve una condición de alerta.	MetricAlertAction[]
Mitigación automática	La marca que indica si la alerta debe resolverse automáticamente o no. El valor predeterminado es true.	Bool
criterios	Define la información específica de los criterios de alerta.	MetricAlertCriteria (obligatorio)
customProperties	Propiedades de una carga de alerta.	MetricAlertPropertiesCustomProperties
descripción	La descripción de la alerta de métrica que se incluirá en el correo electrónico de alerta.	cuerda
Habilitado	Marca que indica si la alerta de métrica está habilitada.	bool (obligatorio)
Frecuencia: evaluación	La frecuencia con la que se evalúa la alerta métrica representada en formato de duración ISO 8601.	string (obligatorio)
resolveConfiguration	La configuración de cómo se resuelve la alerta. Aplicable para PromQLCriteria.	ResoluciónConfiguración
Ámbitos	La lista de identificadores de recursos a los que se limita esta alerta de métrica. No se puede cambiar el ámbito de una regla de métricas en función de los registros.	string[] (obligatorio)
severidad	Gravedad de alerta {0, 1, 2, 3, 4}	int (obligatorio)
targetResourceRegion	La región de los recursos de destino en la que se crea o actualiza la alerta. Obligatorio si el ámbito contiene una suscripción, un grupo de recursos o más de un recurso.	cuerda
targetResourceType	Tipo de recurso de los recursos de destino en los que se crea o actualiza la alerta. Obligatorio si el ámbito contiene una suscripción, un grupo de recursos o más de un recurso.	cuerda
tamaño de ventana	El período de tiempo (en formato de duración ISO 8601) que se utiliza para supervisar la actividad de alertas en función del umbral.	cuerda

MetricAlertPropertiesActionProperties

Nombre	Descripción	Valor

MetricAlertPropertiesCustomProperties

Nombre	Descripción	Valor

MetricAlertSingleResourceMultipleMetricCriteria

Nombre	Descripción	Valor
allOf	Lista de criterios de métrica para esta operación "todo".	CriteriosMétricos[]
odata.type	Especifica el tipo de criterios de alerta. Es posible que se devuelvan valores no documentados anteriormente	'Microsoft.Azure. Monitor.SingleResourceMultipleMetricCriteria' (obligatorio)

Criterios métricos

Nombre	Descripción	Valor
criterionType	Especifica el tipo de criterios de umbral. Es posible que se devuelvan valores no documentados anteriormente	'DynamicThresholdCriterion' 'StaticThresholdCriterion' (obligatorio)
Dimensiones	Lista de condiciones de dimensión.	MetricDimension[]
metricName	Nombre de la métrica.	string (obligatorio)
metricNamespace	Namespace de la métrica.	cuerda
nombre	Nombre de los criterios.	string (obligatorio)
operador	Operador criteria. Es posible que se devuelvan valores no documentados anteriormente	'Iguales' 'Más grande que' 'MayorQueIgual' 'Menos que' 'LessThanOrEqual' (obligatorio)
skipMetricValidation	Permite crear una regla de alerta en una métrica personalizada que aún no se ha emitido, lo que provoca que se omita la validación de métricas.	Bool
umbral	El valor de umbral de criterios que activa la alerta.	int (obligatorio)
timeAggregation	Los criterios de agregación de tiempo. Es posible que se devuelvan valores no documentados anteriormente	'Promedio' 'Conteo' 'Máximo' "Mínimo" 'Total' (obligatorio)

Criterios métricos

Nombre	Descripción	Valor
criterionType	Especifica el tipo de criterios de umbral. Es posible que se devuelvan valores no documentados anteriormente	'StaticThresholdCriterion' (obligatorio)
operador	Operador criteria. Es posible que se devuelvan valores no documentados anteriormente	'Iguales' 'Más grande que' 'MayorQueIgual' 'Menos que' 'LessThanOrEqual' (obligatorio)
umbral	El valor de umbral de criterios que activa la alerta.	int (obligatorio)

MetricDimension

Nombre	Descripción	Valor
nombre	Nombre de la dimensión.	string (obligatorio)
operador	El operador de dimensión. Solo se admiten 'Include' y 'Exclude'	string (obligatorio)
valores	Lista de valores de dimensión.	string[] (obligatorio)

MicrosoftCommonIdentity

Nombre	Descripción	Valor
tipo	Tipo de identidad de servicio administrada.	'None' 'SystemAssigned' 'UserAssigned' (obligatorio)
userAssignedIdentities	Lista de identidades de usuario asociadas al recurso. Las referencias de clave de diccionario de identidad de usuario serán identificadores de recursos de ARM con el formato: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}'.	MicrosoftCommonIdentityUserAssignedIdentities

MicrosoftCommonIdentityUserAssignedIdentities

Nombre	Descripción	Valor

MicrosoftCommonUserIdentityProperties

Nombre	Descripción	Valor

MultiMetricCriteria

Nombre	Descripción	Valor
criterionType	Establezca en "DynamicThresholdCriterion" para el tipo DynamicMetricCriteria. Establezca en "StaticThresholdCriterion" para el tipo MetricCriteria.	'DynamicThresholdCriterion' 'StaticThresholdCriterion' (obligatorio)
Dimensiones	Lista de condiciones de dimensión.	MetricDimension[]
metricName	Nombre de la métrica.	string (obligatorio)
metricNamespace	Namespace de la métrica.	cuerda
nombre	Nombre de los criterios.	string (obligatorio)
skipMetricValidation	Permite crear una regla de alerta en una métrica personalizada que aún no se ha emitido, lo que provoca que se omita la validación de métricas.	Bool
timeAggregation	Los criterios de agregación de tiempo. Es posible que se devuelvan valores no documentados anteriormente	'Promedio' 'Conteo' 'Máximo' "Mínimo" 'Total' (obligatorio)

MultiPromQLCriteria

Nombre	Descripción	Valor
criterionType	Establézcalo en 'DynamicThresholdCriterion' para el tipo DynamicPromQLCriteria. Establézcalo en 'StaticThresholdCriterion' para el tipo StaticPromQLCriteria.	'DynamicThresholdCriterion' 'StaticThresholdCriterion' (obligatorio)
nombre	Nombre de los criterios.	string (obligatorio)
query	La consulta utilizada para evaluar la regla de alerta	string (obligatorio)

PromQLCriteria

Nombre	Descripción	Valor
allOf	La lista de criterios de promQL. La alerta se activará cuando se cumplan todas las condiciones.	MultiPromQLCriteria[]
errorPeriods	Configuración de períodos de error en alertas basadas en consultas.	QueryFailingPeriods
odata.type	Especifica el tipo de criterios de alerta. Es posible que se devuelvan valores no documentados anteriormente	'Microsoft.Azure. Monitor.PromQLCriteria' (obligatorio)

QueryFailingPeriods

Nombre	Descripción	Valor
for	La cantidad de tiempo (en formato de duración ISO 8601) de alerta debe estar activa antes de disparar.	string (obligatorio)

ResoluciónConfiguración

Nombre	Descripción	Valor
Resuelto automáticamente	Indica si la alerta debe resolverse automáticamente	bool (obligatorio)
timeToResolve	La hora (en formato de duración ISO 8601) después de la cual la alerta debe resolverse automáticamente	cuerda

StaticPromQLCriteria

Nombre	Descripción	Valor
criterionType	Especifica el tipo de criterios de umbral. Es posible que se devuelvan valores no documentados anteriormente	'StaticThresholdCriterion' (obligatorio)

TrackedResourceTags

Nombre	Descripción	Valor

WebtestLocationAvailabilityCriteria

Nombre	Descripción	Valor
componentId	Identificador de recurso de Application Insights.	string (obligatorio)
failedLocationCount	Número de ubicaciones con errores.	int (obligatorio)
odata.type	Especifica el tipo de criterios de alerta. Es posible que se devuelvan valores no documentados anteriormente	'Microsoft.Azure. Monitor.WebtestLocalizaciónDisponibilidad' (obligatorio)
webTestId	Identificador de prueba web de Application Insights.	string (obligatorio)

Ejemplos de uso

Plantillas de inicio rápido de Azure

Las siguientes plantillas Azure Quickstart despliegan este tipo de recurso.

Plantilla	Descripción
Alert para la métrica de respuesta del último byte del backend	Utiliza estas plantillas para crear fácilmente alertas importantes de eventos para tu Azure Application Gateway.
Alerta para la métrica de recuento de huéspedes poco saludable	Utiliza estas plantillas para crear fácilmente alertas importantes de eventos para tu Azure Application Gateway.
BrowserBox Azure Edición	Esta plantilla despliega BrowserBox en una VM LVM de Azure Ubuntu Server 22.04 LTS, Debian 11 o RHEL 8.7.
Crea alertas para tu Gateway de Aplicaciones	Utiliza estas plantillas para crear fácilmente alertas importantes de eventos para tu Azure Application Gateway.
Despliega Application Insight y crea alertas en él	Esta plantilla le permite implementar Application Insight y crear alertas en ella.
Creación Dinámica de Pruebas Web	Cree cualquier número de pruebas web (ping) de App Insights.
Gobernanza Empresarial - AppService, SQL BASE DE DATOS, AD, OMS, Runbooks	La adopción de la nube para una empresa, pequeña o grande requiere modelos de gobernanza responsables y eficientes para derivar el valor de sus implementaciones en la nube. CloudWise (nombre en clave de la solución) es una solución compuesta disponible en Azure Partner QuickStarts, es un facilitador de adopción para clientes, integradores de sistemas y socios por igual, que ofrece una solución automatizada de gobernanza y operaciones autoservicio, centrada en optimizar tus costes, mejorar la fiabilidad de tu(s) aplicación(s) y reducir el riesgo empresarial. La solución resalta los pilares básicos de gobernanza de visibilidad y control.
Métrica para una prueba de disponibilidad	Esta plantilla crea una prueba de disponibilidad de Application Insights junto con una regla de alertas de métricas que la supervisa.
con umbral dinámico	Esta plantilla crea una regla de alerta de métrica que supervisa la métrica Porcentaje de CPU de una máquina virtual mediante un tipo de condición de umbral dinámico.
Métrica con umbral estático	Esta plantilla crea una regla de alerta de métrica que supervisa la métrica Porcentaje de CPU de una máquina virtual mediante un tipo de condición de umbral estático.
Escalable Umbraco CMS Web App	Esta plantilla ofrece una forma sencilla de desplegar la aplicación web de umbraco CMS en Azure App Service Web Apps.

Definición de recursos de Terraform (proveedor AzAPI)

El tipo de recurso metricAlerts se puede implementar con operaciones que tienen como destino:

Grupos de recursos

Para obtener una lista de las propiedades modificadas en cada versión de API, consulte registro de cambios.

Formato de recurso

Para crear un Microsoft. Recursos/metricAlerts, añade el siguiente Terraform a tu plantilla.

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.Insights/metricAlerts@2024-03-01-preview"
  name = "string"
  parent_id = "string"
  identity {
    type = "string"
    identity_ids = [
      "string"
    ]
  }
  location = "string"
  tags = {
    {customized property} = "string"
  }
  body = {
    properties = {
      actionProperties = {
        {customized property} = "string"
      }
      actions = [
        {
          actionGroupId = "string"
          webHookProperties = {
            {customized property} = "string"
          }
        }
      ]
      autoMitigate = bool
      criteria = {
        odata.type = "string"
        // For remaining properties, see MetricAlertCriteria objects
      }
      customProperties = {
        {customized property} = "string"
      }
      description = "string"
      enabled = bool
      evaluationFrequency = "string"
      resolveConfiguration = {
        autoResolved = bool
        timeToResolve = "string"
      }
      scopes = [
        "string"
      ]
      severity = int
      targetResourceRegion = "string"
      targetResourceType = "string"
      windowSize = "string"
    }
  }
}

Objetos MultiPromQLCriteria

Establezca la propiedad criterionType para especificar el tipo de objeto.

Para DynamicThresholdCriterion, use:

{
  alertSensitivity = "string"
  criterionType = "DynamicThresholdCriterion"
  ignoreDataBefore = "string"
  operator = "string"
}

Para StaticThresholdCriterion, use:

{
  criterionType = "StaticThresholdCriterion"
}

Objetos MultiMetricCriteria

Establezca la propiedad criterionType para especificar el tipo de objeto.

Para DynamicThresholdCriterion, use:

{
  alertSensitivity = "string"
  criterionType = "DynamicThresholdCriterion"
  failingPeriods = {
    minFailingPeriodsToAlert = int
    numberOfEvaluationPeriods = int
  }
  ignoreDataBefore = "string"
  operator = "string"
}

Para StaticThresholdCriterion, use:

{
  criterionType = "StaticThresholdCriterion"
  operator = "string"
  threshold = int
}

Objetos MetricAlertCriteria

Establezca la propiedad odata.type para especificar el tipo de objeto.

Para Microsoft.Azure. Monitor.MultipleResourceMultipleMultipleMetricCriteria, utilizar:

{
  allOf = [
    {
      dimensions = [
        {
          name = "string"
          operator = "string"
          values = [
            "string"
          ]
        }
      ]
      metricName = "string"
      metricNamespace = "string"
      name = "string"
      skipMetricValidation = bool
      timeAggregation = "string"
      criterionType = "string"
      // For remaining properties, see MultiMetricCriteria objects
    }
  ]
  odata.type = "Microsoft.Azure.Monitor.MultipleResourceMultipleMetricCriteria"
}

Para Microsoft.Azure. Monitor.PromQLCriteria, utilizar:

{
  allOf = [
    {
      name = "string"
      query = "string"
      criterionType = "string"
      // For remaining properties, see MultiPromQLCriteria objects
    }
  ]
  failingPeriods = {
    for = "string"
  }
  odata.type = "Microsoft.Azure.Monitor.PromQLCriteria"
}

Para Microsoft.Azure. Monitor.SingleResourceMultipleMetricCriteria, utilizar:

{
  allOf = [
    {
      criterionType = "string"
      dimensions = [
        {
          name = "string"
          operator = "string"
          values = [
            "string"
          ]
        }
      ]
      metricName = "string"
      metricNamespace = "string"
      name = "string"
      operator = "string"
      skipMetricValidation = bool
      threshold = int
      timeAggregation = "string"
    }
  ]
  odata.type = "Microsoft.Azure.Monitor.SingleResourceMultipleMetricCriteria"
}

Para Microsoft.Azure. Monitor.WebtestLocationAvailabilityCriteria, utilizar:

{
  componentId = "string"
  failedLocationCount = int
  odata.type = "Microsoft.Azure.Monitor.WebtestLocationAvailabilityCriteria"
  webTestId = "string"
}

Valores de propiedad

Microsoft. Alertas de Insights/métricas

Nombre	Descripción	Valor
identity	Identidad del recurso.	MicrosoftCommonIdentity
ubicación	Ubicación geográfica donde reside el recurso	string (obligatorio)
nombre	El nombre del recurso	string (obligatorio)
Propiedades	Las propiedades de la regla de alerta del recurso.	MetricAlertProperties (obligatorio)
Etiquetas	Etiquetas de recursos	Diccionario de nombres y valores de etiqueta.
tipo	El tipo de recurso	"Microsoft. Insights/metricAlerts@2024-03-01-preview"

DynamicMetricCriteria

Nombre	Descripción	Valor
alertSensitivity	Extensión de desviación necesaria para desencadenar una alerta. Esto afectará a la limitación del umbral al patrón de serie de métricas. Es posible que se devuelvan valores no documentados anteriormente	"Alto" "Bajo" 'Medium' (obligatorio)
criterionType	Especifica el tipo de criterios de umbral. Es posible que se devuelvan valores no documentados anteriormente	'DynamicThresholdCriterion' (obligatorio)
errorPeriods	Número mínimo de infracciones necesarias en el período de tiempo de búsqueda seleccionado necesario para generar una alerta.	dynamicThresholdFailingPeriods (obligatorio)
ignoreDataBefore	Use esta opción para establecer la fecha desde la que empezar a aprender los datos históricos de métricas y calcular los umbrales dinámicos (en formato ISO8601)	cuerda
operador	Operador que se usa para comparar el valor de la métrica con respecto al umbral. Es posible que se devuelvan valores no documentados anteriormente	'Mayoro Menor que' 'Más grande que' 'LessThan' (obligatorio)

DynamicPromQLCriteria

Nombre	Descripción	Valor
alertSensitivity	Extensión de desviación necesaria para desencadenar una alerta. Esto afectará a la limitación del umbral al patrón de serie de métricas. Es posible que se devuelvan valores no documentados anteriormente	"Alto" "Bajo" 'Medium' (obligatorio)
criterionType	Especifica el tipo de criterios de umbral. Es posible que se devuelvan valores no documentados anteriormente	'DynamicThresholdCriterion' (obligatorio)
ignoreDataBefore	Use esta opción para establecer la fecha desde la que empezar a aprender los datos históricos de métricas y calcular los umbrales dinámicos (en formato ISO8601)	cuerda
operador	Operador que se usa para comparar el valor de la métrica con respecto al umbral. Es posible que se devuelvan valores no documentados anteriormente	'Mayoro Menor que' 'Más grande que' 'LessThan' (obligatorio)

DynamicThresholdFailingPeriods

Nombre	Descripción	Valor
minFailingPeriodsToAlert	Número de infracciones para desencadenar una alerta. Debe ser menor o igual que numberOfEvaluationPeriods.	int (obligatorio)
númeroDePeriodosDeEvaluación	Número de puntos de búsqueda agregados. El período de tiempo de búsqueda se calcula en función de la granularidad de agregación (windowSize) y del número seleccionado de puntos agregados.	int (obligatorio)

MetricAlertAction

Nombre	Descripción	Valor
actionGroupId	Identificador del grupo de acciones que se va a usar.	cuerda
webHookProperties	Este campo permite especificar propiedades personalizadas, que se anexarían a la carga de alerta enviada como entrada al webhook.	MetricAlertActionWebHookProperties

MetricAlertActionWebHookProperties

Nombre	Descripción	Valor

MetricAlertCriteria

Nombre	Descripción	Valor
odata.type	Configura en 'Microsoft.Azure. Monitor.MultipleResourceMultipleMetricCriteria' para el tipo MetricAlertMultipleResourceMultipleMultipleMetricCriteria. Configura en 'Microsoft.Azure. Monitor.PromQLCriteria' para el tipo PromQLCriteria. Configura en 'Microsoft.Azure. Monitor.SingleResourceMultipleMetricCriteria' para el tipo MetricAlertSingleResourceMultipleMetricCriteria. Configura en 'Microsoft.Azure. Monitor.WebtestUbicaciónCriteriosDisponibilidad' para tipo WebtestLocalizaciónCriteriosDisponibilidad.	'Microsoft.Azure. Monitor.MultipleResourceMultipleMetricCriteria' 'Microsoft.Azure. Monitor.PromQLCriteria' 'Microsoft.Azure. Monitor.CriteriosMultipleMétricos 'Microsoft.Azure. Monitor.WebtestLocalizaciónDisponibilidad' (obligatorio)

MetricAlertMultipleResourceMultipleMetricCriteria

Nombre	Descripción	Valor
allOf	La lista de múltiples criterios de métricas para esta operación "toda".	MultiMetricCriteria[]
odata.type	Especifica el tipo de criterios de alerta. Es posible que se devuelvan valores no documentados anteriormente	'Microsoft.Azure. Monitor.MultipleResourceMultipleMultipleMetricCriteria' (obligatorio)

MetricAlertProperties

Nombre	Descripción	Valor
actionProperties	Propiedades de una acción.	MetricAlertPropertiesActionProperties
Acciones	Matriz de acciones que se realizan cuando la regla de alerta se activa y cuando se resuelve una condición de alerta.	MetricAlertAction[]
Mitigación automática	La marca que indica si la alerta debe resolverse automáticamente o no. El valor predeterminado es true.	Bool
criterios	Define la información específica de los criterios de alerta.	MetricAlertCriteria (obligatorio)
customProperties	Propiedades de una carga de alerta.	MetricAlertPropertiesCustomProperties
descripción	La descripción de la alerta de métrica que se incluirá en el correo electrónico de alerta.	cuerda
Habilitado	Marca que indica si la alerta de métrica está habilitada.	bool (obligatorio)
Frecuencia: evaluación	La frecuencia con la que se evalúa la alerta métrica representada en formato de duración ISO 8601.	string (obligatorio)
resolveConfiguration	La configuración de cómo se resuelve la alerta. Aplicable para PromQLCriteria.	ResoluciónConfiguración
Ámbitos	La lista de identificadores de recursos a los que se limita esta alerta de métrica. No se puede cambiar el ámbito de una regla de métricas en función de los registros.	string[] (obligatorio)
severidad	Gravedad de alerta {0, 1, 2, 3, 4}	int (obligatorio)
targetResourceRegion	La región de los recursos de destino en la que se crea o actualiza la alerta. Obligatorio si el ámbito contiene una suscripción, un grupo de recursos o más de un recurso.	cuerda
targetResourceType	Tipo de recurso de los recursos de destino en los que se crea o actualiza la alerta. Obligatorio si el ámbito contiene una suscripción, un grupo de recursos o más de un recurso.	cuerda
tamaño de ventana	El período de tiempo (en formato de duración ISO 8601) que se utiliza para supervisar la actividad de alertas en función del umbral.	cuerda

MetricAlertPropertiesActionProperties

Nombre	Descripción	Valor

MetricAlertPropertiesCustomProperties

Nombre	Descripción	Valor

MetricAlertSingleResourceMultipleMetricCriteria

Nombre	Descripción	Valor
allOf	Lista de criterios de métrica para esta operación "todo".	CriteriosMétricos[]
odata.type	Especifica el tipo de criterios de alerta. Es posible que se devuelvan valores no documentados anteriormente	'Microsoft.Azure. Monitor.SingleResourceMultipleMetricCriteria' (obligatorio)

Criterios métricos

Nombre	Descripción	Valor
criterionType	Especifica el tipo de criterios de umbral. Es posible que se devuelvan valores no documentados anteriormente	'DynamicThresholdCriterion' 'StaticThresholdCriterion' (obligatorio)
Dimensiones	Lista de condiciones de dimensión.	MetricDimension[]
metricName	Nombre de la métrica.	string (obligatorio)
metricNamespace	Namespace de la métrica.	cuerda
nombre	Nombre de los criterios.	string (obligatorio)
operador	Operador criteria. Es posible que se devuelvan valores no documentados anteriormente	'Iguales' 'Más grande que' 'MayorQueIgual' 'Menos que' 'LessThanOrEqual' (obligatorio)
skipMetricValidation	Permite crear una regla de alerta en una métrica personalizada que aún no se ha emitido, lo que provoca que se omita la validación de métricas.	Bool
umbral	El valor de umbral de criterios que activa la alerta.	int (obligatorio)
timeAggregation	Los criterios de agregación de tiempo. Es posible que se devuelvan valores no documentados anteriormente	'Promedio' 'Conteo' 'Máximo' "Mínimo" 'Total' (obligatorio)

Criterios métricos

Nombre	Descripción	Valor
criterionType	Especifica el tipo de criterios de umbral. Es posible que se devuelvan valores no documentados anteriormente	'StaticThresholdCriterion' (obligatorio)
operador	Operador criteria. Es posible que se devuelvan valores no documentados anteriormente	'Iguales' 'Más grande que' 'MayorQueIgual' 'Menos que' 'LessThanOrEqual' (obligatorio)
umbral	El valor de umbral de criterios que activa la alerta.	int (obligatorio)

MetricDimension

Nombre	Descripción	Valor
nombre	Nombre de la dimensión.	string (obligatorio)
operador	El operador de dimensión. Solo se admiten 'Include' y 'Exclude'	string (obligatorio)
valores	Lista de valores de dimensión.	string[] (obligatorio)

MicrosoftCommonIdentity

Nombre	Descripción	Valor
tipo	Tipo de identidad de servicio administrada.	'None' 'SystemAssigned' 'UserAssigned' (obligatorio)
userAssignedIdentities	Lista de identidades de usuario asociadas al recurso. Las referencias de clave de diccionario de identidad de usuario serán identificadores de recursos de ARM con el formato: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}'.	MicrosoftCommonIdentityUserAssignedIdentities

MicrosoftCommonIdentityUserAssignedIdentities

Nombre	Descripción	Valor

MicrosoftCommonUserIdentityProperties

Nombre	Descripción	Valor

MultiMetricCriteria

Nombre	Descripción	Valor
criterionType	Establezca en "DynamicThresholdCriterion" para el tipo DynamicMetricCriteria. Establezca en "StaticThresholdCriterion" para el tipo MetricCriteria.	'DynamicThresholdCriterion' 'StaticThresholdCriterion' (obligatorio)
Dimensiones	Lista de condiciones de dimensión.	MetricDimension[]
metricName	Nombre de la métrica.	string (obligatorio)
metricNamespace	Namespace de la métrica.	cuerda
nombre	Nombre de los criterios.	string (obligatorio)
skipMetricValidation	Permite crear una regla de alerta en una métrica personalizada que aún no se ha emitido, lo que provoca que se omita la validación de métricas.	Bool
timeAggregation	Los criterios de agregación de tiempo. Es posible que se devuelvan valores no documentados anteriormente	'Promedio' 'Conteo' 'Máximo' "Mínimo" 'Total' (obligatorio)

MultiPromQLCriteria

Nombre	Descripción	Valor
criterionType	Establézcalo en 'DynamicThresholdCriterion' para el tipo DynamicPromQLCriteria. Establézcalo en 'StaticThresholdCriterion' para el tipo StaticPromQLCriteria.	'DynamicThresholdCriterion' 'StaticThresholdCriterion' (obligatorio)
nombre	Nombre de los criterios.	string (obligatorio)
query	La consulta utilizada para evaluar la regla de alerta	string (obligatorio)

PromQLCriteria

Nombre	Descripción	Valor
allOf	La lista de criterios de promQL. La alerta se activará cuando se cumplan todas las condiciones.	MultiPromQLCriteria[]
errorPeriods	Configuración de períodos de error en alertas basadas en consultas.	QueryFailingPeriods
odata.type	Especifica el tipo de criterios de alerta. Es posible que se devuelvan valores no documentados anteriormente	'Microsoft.Azure. Monitor.PromQLCriteria' (obligatorio)

QueryFailingPeriods

Nombre	Descripción	Valor
for	La cantidad de tiempo (en formato de duración ISO 8601) de alerta debe estar activa antes de disparar.	string (obligatorio)

ResoluciónConfiguración

Nombre	Descripción	Valor
Resuelto automáticamente	Indica si la alerta debe resolverse automáticamente	bool (obligatorio)
timeToResolve	La hora (en formato de duración ISO 8601) después de la cual la alerta debe resolverse automáticamente	cuerda

StaticPromQLCriteria

Nombre	Descripción	Valor
criterionType	Especifica el tipo de criterios de umbral. Es posible que se devuelvan valores no documentados anteriormente	'StaticThresholdCriterion' (obligatorio)

TrackedResourceTags

Nombre	Descripción	Valor

WebtestLocationAvailabilityCriteria

Nombre	Descripción	Valor
componentId	Identificador de recurso de Application Insights.	string (obligatorio)
failedLocationCount	Número de ubicaciones con errores.	int (obligatorio)
odata.type	Especifica el tipo de criterios de alerta. Es posible que se devuelvan valores no documentados anteriormente	'Microsoft.Azure. Monitor.WebtestLocalizaciónDisponibilidad' (obligatorio)
webTestId	Identificador de prueba web de Application Insights.	string (obligatorio)

Ejemplos de uso

Ejemplos de Terraform

Un ejemplo básico de cómo desplegar Metric Alert dentro de Azure Monitor.

terraform {
  required_providers {
    azapi = {
      source = "Azure/azapi"
    }
  }
}

provider "azapi" {
  skip_provider_registration = false
}

variable "resource_name" {
  type    = string
  default = "acctest0001"
}

variable "location" {
  type    = string
  default = "westeurope"
}

resource "azapi_resource" "resourceGroup" {
  type     = "Microsoft.Resources/resourceGroups@2020-06-01"
  name     = var.resource_name
  location = var.location
}

resource "azapi_resource" "storageAccount" {
  type      = "Microsoft.Storage/storageAccounts@2021-09-01"
  parent_id = azapi_resource.resourceGroup.id
  name      = var.resource_name
  location  = var.location
  body = {
    kind = "StorageV2"
    properties = {
      accessTier                   = "Hot"
      allowBlobPublicAccess        = true
      allowCrossTenantReplication  = true
      allowSharedKeyAccess         = true
      defaultToOAuthAuthentication = false
      encryption = {
        keySource = "Microsoft.Storage"
        services = {
          queue = {
            keyType = "Service"
          }
          table = {
            keyType = "Service"
          }
        }
      }
      isHnsEnabled      = false
      isNfsV3Enabled    = false
      isSftpEnabled     = false
      minimumTlsVersion = "TLS1_2"
      networkAcls = {
        defaultAction = "Allow"
      }
      publicNetworkAccess      = "Enabled"
      supportsHttpsTrafficOnly = true
    }
    sku = {
      name = "Standard_LRS"
    }
  }
  schema_validation_enabled = false
  response_export_values    = ["*"]
}

resource "azapi_resource" "metricAlert" {
  type      = "Microsoft.Insights/metricAlerts@2018-03-01"
  parent_id = azapi_resource.resourceGroup.id
  name      = var.resource_name
  location  = "global"
  body = {
    properties = {
      actions = [
      ]
      autoMitigate = true
      criteria = {
        allOf = [
          {
            criterionType = "StaticThresholdCriterion"
            dimensions = [
            ]
            metricName           = "UsedCapacity"
            metricNamespace      = "Microsoft.Storage/storageAccounts"
            name                 = "Metric1"
            operator             = "GreaterThan"
            skipMetricValidation = false
            threshold            = 55.5
            timeAggregation      = "Average"
          },
        ]
        "odata.type" = "Microsoft.Azure.Monitor.MultipleResourceMultipleMetricCriteria"
      }
      description         = ""
      enabled             = true
      evaluationFrequency = "PT1M"
      scopes = [
        azapi_resource.storageAccount.id,
      ]
      severity             = 3
      targetResourceRegion = ""
      targetResourceType   = ""
      windowSize           = "PT1H"
    }
    tags = {
      CUSTOMER  = "CUSTOMERx"
      Example   = "Example123"
      terraform = "Coolllll"
      test      = "123"
    }
  }
  schema_validation_enabled = false
  response_export_values    = ["*"]
}

Comentarios

¿Le ha resultado útil esta página?

Last updated on 2026-04-20