Crie uma regra de alerta nova com o CLI, PowerShell ou com um modelo do ARM

  • Artigo

Você pode criar uma nova regra de alerta usando a CLI, o PowerShell ou um modelo do Azure Resource Manager.

Pré-requisitos

Para criar ou editar uma regra de alerta, você deve ter as seguintes permissões:

  • permissão de Ler no recurso de destino da regra de alerta.
  • Permissão de gravação no grupo de recursos no qual a regra de alerta é criada. Se estiver a criar a regra de alerta a partir do portal do Azure, a regra de alerta é criada por predefinição no mesmo grupo de recursos em que reside o recurso de destino.
  • permissão de Ler em qualquer grupo de ação associado à regra de alerta, se aplicável.

Criar uma nova regra de alerta usando a CLI

Você pode criar uma nova regra de alerta usando a CLI do Azure. Os exemplos de código a seguir usam o Azure Cloud Shell. Você pode ver a lista completa dos comandos da CLI do Azure para o Azure Monitor.

  1. No portal, selecione Cloud Shell. No prompt, use-os.

    Por exemplo, para criar uma regra de alerta de métrica que monitore se a porcentagem média de CPU em uma VM é maior que 90:

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

Criar uma nova regra de alerta usando o PowerShell

  • Para criar uma regra de alerta de métrica usando o PowerShell, use o cmdlet Add-AzMetricAlertRuleV2 .

    Nota

    Quando você cria um alerta de métrica em um único recurso, a sintaxe usa o TargetResourceId. Quando você cria um alerta de métrica em vários recursos, a sintaxe contém o TargetResourceScope, TargetResourceTypee TargetResourceRegion.

  • Para criar uma regra de alerta de pesquisa de log usando o PowerShell, use o cmdlet New-AzScheduledQueryRule .
  • Para criar uma regra de alerta de log de atividades usando o PowerShell, use o cmdlet New-AzActivityLogAlert .

Criar uma nova regra de alerta usando um modelo ARM

Você pode usar um modelo do Azure Resource Manager (modelo ARM) para configurar regras de alerta de forma consistente em todos os seus ambientes.

  1. Crie um novo recurso, usando os seguintes tipos de recursos:

    • Para alertas métricos: Microsoft.Insights/metricAlerts

      Nota

      • Recomendamos que você crie o alerta de métrica usando o mesmo grupo de recursos que o recurso de destino.
      • Os alertas de métrica para um tipo de recurso de espaço de trabalho do Azure Log Analytics (Microsoft.OperationalInsights/workspaces) são configurados de forma diferente de outros alertas de métrica. Para obter mais informações, consulte Modelo de recurso para alertas métricos para logs.
      • Se você estiver criando um alerta de métrica para um único recurso, o modelo usará o ResourceId do recurso de destino. Se você estiver criando um alerta de métrica para vários recursos, o modelo usará o scope, TargetResourceTypee TargetResourceRegion para os recursos de destino.
    • Para alertas de pesquisa de log: Microsoft.Insights/scheduledQueryRules
    • Para alertas de log de atividades, integridade do serviço e integridade do recurso: microsoft.Insights/activityLogAlerts

  2. Copie um dos modelos desses modelos ARM de exemplo.

  3. Edite o arquivo de modelo para conter as informações apropriadas para seu alerta e salve-o como <seu-alert-template-file>.json.

  4. Edite o arquivo de parâmetros correspondente para personalizar o alerta e salve como <seu-alert-template-file>.parameters.json.

  5. Defina o metricName parâmetro, usando um dos valores nas métricas com suporte do Azure Monitor.

  6. Implante o modelo usando o PowerShell ou a CLI.

Próximos passos