Compartir a través de

Creación de una nueva regla de alertas mediante la CLI, PowerShell o una plantilla de ARM

  • Artículo

Puede crear una nueva regla de alerta mediante la CLI, PowerShell o una plantilla de Azure Resource Manager.

Requisitos previos

Para crear o editar una regla de alerta, debe tener los permisos siguientes:

  • Permiso de lectura en el recurso de destino de la regla de alerta.
  • Permiso de escritura en el grupo de recursos en el que se crea la regla de alertas. Si va a crear la regla de alerta desde el portal de Azure, esta se crea de forma predeterminada en el mismo grupo de recursos en el que reside el recurso de destino.
  • Permiso de lectura en cualquier grupo de acciones asociado a la regla de alerta, si procediera.

Crear una nueva regla de alerta usando la CLI

Puede crear una nueva regla de alertas mediante la CLI de Azure. En los ejemplos siguientes, se usa Azure Cloud Shell. Puede ver la lista completa de los comandos de la CLI de Azure para Azure Monitor.

  1. En el portal, seleccione Cloud Shell. En la solicitud, utilícelos.

    Por ejemplo, para crear una regla de alerta de métricas que supervise si el porcentaje medio de la CPU en una máquina virtual es mayor que 90:

     az monitor metrics alert create -n {nameofthealert} -g {ResourceGroup} --scopes {VirtualMachineResourceID} --condition "avg Percentage CPU > 90" --description {descriptionofthealert}

Creación de una nueva regla de alertas mediante PowerShell

  • Para crear una regla de alertas de métricas mediante PowerShell, use el cmdlet Add-AzMetricAlertRuleV2.

    Nota:

    Al crear una alerta de métrica en un único recurso, la sintaxis usa el TargetResourceId. Al crear una alerta de métrica en varios recursos, la sintaxis contiene los valores TargetResourceScope, TargetResourceType y TargetResourceRegion.

  • Para crear una regla de alertas de búsqueda de registros mediante PowerShell, use el cmdlet New-AzScheduledQueryRule.
  • Para crear una regla de alertas de registro de actividad mediante PowerShell, use el cmdlet New-AzActivityLogAlert.

Creación de una nueva regla de alertas mediante una plantilla de ARM

Puede usar una plantilla de Azure Resource Manager (plantilla de ARM) para configurar reglas de alertas de forma coherente en todos los entornos.

  1. Creación de recurso con los siguientes tipos de recursos:

    • Para alertas de métricas: Microsoft.Insights/metricAlerts

      Nota:

      • Se recomienda crear la alerta de métrica con el mismo grupo de recursos que el recurso de destino.
      • Las alertas de métricas para un tipo de recurso de área de trabajo de Azure Log Analytics (Microsoft.OperationalInsights/workspaces) se configuran de forma diferente a otras alertas de métricas. Para obtener más información, consulte Plantilla de recursos para alertas métricas para registros.
      • Si va a crear una alerta de métrica para un único recurso, la plantilla usa el valor ResourceId del recurso de destino. Si va a crear una alerta métrica para varios recursos, la plantilla usa los scope, TargetResourceType y TargetResourceRegion para los recursos de destino.
    • Para las alertas de búsqueda de registros: Microsoft.Insights/scheduledQueryRules
    • En el registro de actividad, el estado del servicio y las alertas de Resource Health: microsoft.Insights/activityLogAlerts

  2. Copie una de las plantillas de estas plantillas de ARM de ejemplo.

  3. Edite el archivo de plantilla para que contenga la información adecuada para la alerta y guarde el archivo como <your-alert-template-file.json>.

  4. Edite el archivo de parámetros correspondiente para personalizar la alerta y guárdelo como <your-alert-template-file>.parameters.json.

  5. Establezca el parámetro metricName mediante uno de los valores de las métricas admitidas de Azure Monitor.

  6. Implemente la plantilla mediante PowerShell o la CLI.

Pasos siguientes