Criar alerta de métrica na CLI do Azure

Artigo
11/16/2023

Esses exemplos criam monitores de alerta de métrica no Azure Monitor usando comandos do CLI do Azure. O primeiro exemplo cria um alerta para uma máquina virtual. O segundo comando cria um alerta que inclui uma dimensão para um plano do Serviço de Aplicativo.

Pré-requisitos

Use o ambiente Bash no Azure Cloud Shell. Para obter mais informações, confira Início Rápido para Bash no Azure Cloud Shell.
Se preferir executar os comandos de referência da CLI localmente, instale a CLI do Azure. Para execuções no Windows ou no macOS, considere executar a CLI do Azure em um contêiner do Docker. Para saber mais, confira Como executar a CLI do Azure em um contêiner do Docker.
- Se estiver usando uma instalação local, entre com a CLI do Azure usando o comando az login. Para concluir o processo de autenticação, siga as etapas exibidas no terminal. Para ver outras opções de entrada, confira Conectar-se com a CLI do Azure.
- Quando solicitado, instale a extensão da CLI do Azure no primeiro uso. Para obter mais informações sobre extensões, confira Usar extensões com a CLI do Azure.
- Execute az version para localizar a versão e as bibliotecas dependentes que estão instaladas. Para fazer a atualização para a versão mais recente, execute az upgrade.

Criar um alerta

Este alerta monitora uma máquina virtual chamada VM07 no grupo de recursos chamado ContosoVMRG.

Crie um grupo de recursos usando o comando az group create. Para obter informações sobre como criar máquinas virtuais, consulte Criar uma máquina virtual do Windows com o CLI do Azure, Criar uma máquina virtual do Linux com o CLI do Azure e o comando az vm create.

# resource group name: ContosoVMRG
# virtual machine name: VM07

# Create scope
scope=$(az vm show --resource-group ContosoVMRG --name VM07 --output tsv --query id)

# Create action
action=$(az monitor action-group create --name ContosoWebhookAction \
  --resource-group ContosoVMRG --output tsv --query id \
  --action webhook https://alerts.contoso.com usecommonalertschema)

# Create condition
condition=$(az monitor metrics alert condition create --aggregation Average \
  --metric "Percentage CPU" --op GreaterThan --type static --threshold 90 --output tsv)

# Create metrics alert
az monitor metrics alert create --name alert-01 --resource-group ContosoVMRG \
  --scopes $scope --action $action --condition $condition --description "Test High CPU"

Este exemplo usa o tipo de saída tsv, que não inclui símbolos indesejados, como as aspas. Para obter mais informações, confira Usar o CLI do Azure de maneira eficaz.

Criar um alerta com uma dimensão

Este exemplo cria um plano do Serviço de Aplicativo e, em seguida, cria um alerta de métricas para ele. O exemplo usa uma dimensão para especificar que todas as instâncias do plano do Serviço de Aplicativo se enquadram nessa métrica. O exemplo cria um grupo de recursos e um plano de Serviço de Aplicativo.

# Create resource group
az group create --name ContosoRG --location eastus2
 
# Create application service plan
az appservice plan create --resource-group ContosoRG --name ContosoAppServicePlan \
   --is-linux --number-of-workers 4 --sku S1 
 
# Create scope
scope=$(az appservice plan show --resource-group ContosoRG --name ContosoAppServicePlan \
   --output tsv --query id) 
 
# Create dimension
dim01=$(az monitor metrics alert dimension create --name Instance --value * --op Include --output tsv)
 
# Create condition
condition=$(az monitor metrics alert condition create --aggregation Average \
   --metric CpuPercentage --op GreaterThan --type static --threshold 90 \
   --dimension $dim01 --output tsv)

Para ver uma lista das possíveis métricas, execute o comando az monitor metrics list-definitions. O parâmetro --output exibe os valores em um formato legível.

az monitor metrics list-definitions --resource $scope --output table 
 
# Create metrics alert
az monitor metrics alert create --name alert-02 --resource-group ContosoRG \
   --scopes $scope --condition $condition --description "Service Plan High CPU"

Limpar a implantação

Se você criou grupos de recursos para testar esses comandos, você pode remover um grupo de recursos e todo o seu conteúdo usando o comando az group delete:

az group delete --name ContosoVMRG

az group delete --name ContosoRG

Se você usou recursos existentes que deseja manter, use o comando az monitor metrics alert delete para excluir os seus alertas de prática:

az monitor metrics alert delete --name alert-01

az monitor metrics alert delete --name alert-02

Comandos da CLI do Azure usados neste artigo

Este artigo usa os seguintes comandos do CLI do Azure:

Share via