Criar uma nova regra de alerta usando a CLI, PowerShell ou um modelo do ARM

  • Artigo

Você pode criar uma nova regra de alerta usando a a CLI, 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 leitura 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 você estiver criando a regra de alerta no portal do Azure, a regra de alerta será criada por padrão no mesmo grupo de recursos em que reside o recurso de destino.
  • Permissão de leitura em qualquer grupo de ações associado à regra de alerta, se aplicável.

Criar uma 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 de comandos da CLI do Azure para o Azure Monitor.

  1. No portal, selecione Cloud Shell. No prompt, use os seguintes comandos.

    Por exemplo, para criar uma regra de alerta de métrica que monitore se o Percentual de CPU médio em uma VM ultrapassa 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.

    Observação

    Quando você cria um alerta de métrica para um único recurso, a sintaxe emprega o TargetResourceId. Quando você cria um alerta de métrica em vários recursos, a sintaxe inclui o TargetResourceScope, TargetResourceType e 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 do log de atividades usando o PowerShell, use o cmdlet New-AzActivityLogAlert.

Criar uma regra de alerta usando um modelo do ARM

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

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

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

      Observação

      • 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 workspace do Azure Log Analytics (Microsoft.OperationalInsights/workspaces) são configurados de maneira diferente de outros alertas de métrica. Para obter mais informações, consulte Modelo de recurso para alertas de métrica de logs.
      • Se você estiver criando um alerta de métrica para um recurso individual, o modelo usará a ResourceId do recurso de destino. Se você estiver criando um alerta de métrica para vários recursos, o modelo usará o scope, o TargetResourceType e a TargetResourceRegion dos recursos de destino.
    • 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 do ARM de exemplo.

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

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

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

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

Próximas etapas