Freigeben über

Erstellen einer metrischen Warnung in Azure CLI

  • Artikel

In diesen Beispiele werden Metrikwarnungsmonitore in Azure Monitor mithilfe von Azure CLI Befehlen erstellt. Im ersten Beispiel wird eine Warnung für einen virtuellen Computer erstellt. Der zweite Befehl erstellt eine Warnung, die eine Dimension für einen App Service-Plan enthält.

Voraussetzungen

  • Verwenden Sie die Bash-Umgebung in Azure Cloud Shell. Weitere Informationen finden Sie unter Schnellstart für Bash in Azure Cloud Shell.

  • Wenn Sie CLI-Referenzbefehle lieber lokal ausführen, installieren Sie die Azure CLI. Wenn Sie Windows oder macOS ausführen, sollten Sie die Azure CLI in einem Docker-Container ausführen. Weitere Informationen finden Sie unter Ausführen der Azure CLI in einem Docker-Container.

    • Wenn Sie eine lokale Installation verwenden, melden Sie sich mithilfe des Befehls az login bei der Azure CLI an. Führen Sie die in Ihrem Terminal angezeigten Schritte aus, um den Authentifizierungsprozess abzuschließen. Informationen zu anderen Anmeldeoptionen finden Sie unter Anmelden mit der Azure CLI.

    • Installieren Sie die Azure CLI-Erweiterung beim ersten Einsatz, wenn Sie dazu aufgefordert werden. Weitere Informationen zu Erweiterungen finden Sie unter Verwenden von Erweiterungen mit der Azure CLI.

    • Führen Sie az version aus, um die installierte Version und die abhängigen Bibliotheken zu ermitteln. Führen Sie az upgrade aus, um das Upgrade auf die aktuelle Version durchzuführen.

Erstellen einer Warnung

Diese Warnung überwacht einen vorhandenen virtuellen Computer namens VM07 in der Ressourcengruppe mit dem Namen ContosoVMRG.

Sie können eine Ressourcengruppe mithilfe des Befehls az group create erstellen. Informationen zum Erstellen virtueller Computer finden Sie unter Erstellen eines virtuellen Windows-Computers mit der Azure CLI, Erstellen eines virtuellen Linux-Computers mit der Azure CLI sowie unter dem Befehl 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"

In diesem Beispiel wird der Ausgabetyp tsv verwendet, der keine unerwünschten Symbole wie Anführungszeichen enthält. Weitere Informationen finden Sie unter Effektives Verwenden von Azure CLI.

Erstellen einer Warnung mit einer Dimension

In diesem Beispiel wird ein App Service-Plan und dann eine Metrikwarnung dafür erstellt. Im Beispiel wird eine Dimension verwendet, um anzugeben, dass alle Instanzen des App Service-Plans unter diese Metrik fallen. Im Beispiel werden eine Ressourcengruppe und ein Anwendungsdienstplan erstellt.

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

Um eine Liste der möglichen Metriken anzuzeigen, führen Sie den Befehl az monitor metrics list-definitions aus. Der Parameter --output zeigt die Werte in einem lesbaren Format an.

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"

Bereinigen der Bereitstellung

Wenn Sie Ressourcengruppen zum Testen dieser Befehle erstellt haben, können Sie eine Ressourcengruppe und ihren gesamten Inhalt mit dem Befehl az group delete entfernen:

az group delete --name ContosoVMRG

az group delete --name ContosoRG

Wenn Sie vorhandene Ressourcen verwendet haben, die Sie behalten möchten, verwenden Sie den Befehl az monitor metrics alert delete, um Ihre Übungswarnungen zu löschen:

az monitor metrics alert delete --name alert-01

az monitor metrics alert delete --name alert-02

In diesem Artikel verwendete Azure CLI-Befehle

In diesem Artikel werden die folgenden Azure CLI-Befehle verwendet:

Nächste Schritte