Vytvoření upozornění na metriku v Azure CLI

Článek
11/27/2023

Tyto ukázky vytvářejí monitorování upozornění na metriky ve službě Azure Monitor pomocí příkazů Azure CLI. První ukázka vytvoří výstrahu pro virtuální počítač. Druhý příkaz vytvoří výstrahu, která obsahuje dimenzi plánu služby App Service.

Požadavky

Použijte prostředí Bash v Azure Cloud Shellu. Další informace najdete v tématu Rychlý start pro Bash v Azure Cloud Shellu.
Pokud dáváte přednost místnímu spouštění referenčních příkazů rozhraní příkazového řádku, nainstalujte Azure CLI. Pokud používáte Windows nebo macOS, zvažte spuštění Azure CLI v kontejneru Docker. Další informace najdete v tématu Jak spustit Azure CLI v kontejneru Dockeru.
- Pokud používáte místní instalaci, přihlaste se k Azure CLI pomocí příkazu az login. Pokud chcete dokončit proces ověřování, postupujte podle kroků zobrazených na terminálu. Další možnosti přihlášení najdete v tématu Přihlášení pomocí Azure CLI.
- Po zobrazení výzvy nainstalujte rozšíření Azure CLI při prvním použití. Další informace o rozšířeních najdete v tématu Využití rozšíření v Azure CLI.
- Spuštěním příkazu az version zjistěte verzi a závislé knihovny, které jsou nainstalované. Pokud chcete upgradovat na nejnovější verzi, spusťte az upgrade.

Vytvoření upozornění

Tato výstraha monitoruje existující virtuální počítač pojmenovaný VM07 ve skupině prostředků s názvem ContosoVMRG.

Skupinu prostředků můžete vytvořit pomocí příkazu az group create . Informace o vytváření virtuálních počítačů najdete v tématu Vytvoření virtuálního počítače s Windows pomocí Azure CLI, vytvoření virtuálního počítače s Linuxem pomocí Azure CLI a příkazu 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"

Tato ukázka používá tsv výstupní typ, který neobsahuje nežádoucí symboly, jako jsou uvozovky. Další informace najdete v tématu Efektivní použití Azure CLI.

Vytvoření výstrahy s dimenzí

Tato ukázka vytvoří plán služby App Service a pak pro něj vytvoří upozornění na metriky. Příklad používá dimenzi k určení, že všechny instance plánu služby App Service spadají pod tuto metriku. Ukázka vytvoří skupinu prostředků a plán aplikační služby.

# 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)

Pokud chcete zobrazit seznam možných metrik, spusťte příkaz az monitor metrics list-definitions . Parametr --output zobrazí hodnoty ve čitelném formátu.

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"

Vyčištění nasazení

Pokud jste vytvořili skupiny prostředků k otestování těchto příkazů, můžete odebrat skupinu prostředků a veškerý její obsah pomocí příkazu az group delete :

az group delete --name ContosoVMRG

az group delete --name ContosoRG

Pokud jste použili existující prostředky, které chcete zachovat, pomocí příkazu az monitor metrics alert delete odstraňte vaše praktické výstrahy:

az monitor metrics alert delete --name alert-01

az monitor metrics alert delete --name alert-02

Příkazy Azure CLI použité v tomto článku

Tento článek používá následující příkazy Azure CLI:

Share via