Share via

Criar alerta de métrica na CLI do Azure

  • Artigo

Esses exemplos criam monitores de alerta métrico no Azure Monitor usando comandos da 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, consulte Guia de início rápido para Bash no Azure Cloud Shell.

  • Se preferir executar comandos de referência da CLI localmente, instale a CLI do Azure. Se estiver a utilizar o Windows ou macOS, considere executar a CLI do Azure num contentor Docker. Para obter mais informações, consulte Como executar a CLI do Azure em um contêiner do Docker.

    • Se estiver a utilizar uma instalação local, inicie sessão no CLI do Azure ao utilizar o comando az login. Para concluir o processo de autenticação, siga os passos apresentados no seu terminal. Para outras opções de entrada, consulte Entrar com a CLI do Azure.

    • Quando solicitado, instale a extensão da CLI do Azure na primeira utilização. Para obter mais informações sobre as extensões, veja Utilizar extensões com o CLI do Azure.

    • Execute o comando az version para localizar a versão e as bibliotecas dependentes instaladas. Para atualizar para a versão mais recente, execute o comando az upgrade.

Criar um alerta

Este alerta monitoriza uma máquina virtual existente nomeada VM07 no grupo de recursos denominado ContosoVMRG.

Você pode criar 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 a CLI do Azure, Criar uma máquina virtual Linux com a 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 tsv tipo de saída, que não inclui símbolos indesejados, como aspas. Para obter mais informações, consulte Usar a CLI do Azure de forma 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 enquadrarão 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 métricas possíveis, execute o comando az monitor metrics list-definitions . O --output parâmetro 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 implementação

Se você criou grupos de recursos para testar esses comandos, poderá 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 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 da CLI do Azure:

Próximos passos