Tworzenie alertu dotyczącego metryk w interfejsie wiersza polecenia platformy Azure

  • Artykuł

Te przykłady umożliwiają tworzenie monitorów alertów metryk w usłudze Azure Monitor przy użyciu poleceń interfejsu wiersza polecenia platformy Azure. Pierwszy przykład tworzy alert dla maszyny wirtualnej. Drugie polecenie tworzy alert zawierający wymiar planu usługi App Service.

Wymagania wstępne

Utworzenie alertu

Ten alert monitoruje istniejącą maszynę wirtualną o nazwie VM07 w grupie zasobów o nazwie ContosoVMRG.

Grupę zasobów można utworzyć za pomocą polecenia az group create . Aby uzyskać informacje na temat tworzenia maszyn wirtualnych, zobacz Tworzenie maszyny wirtualnej z systemem Windows przy użyciu interfejsu wiersza polecenia platformy Azure, Tworzenie maszyny wirtualnej z systemem Linux przy użyciu interfejsu wiersza polecenia platformy Azure i polecenie 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"

W tym przykładzie tsv jest używany typ danych wyjściowych, który nie zawiera niechcianych symboli, takich jak cudzysłów. Aby uzyskać więcej informacji, zobacz Efektywne używanie interfejsu wiersza polecenia platformy Azure.

Tworzenie alertu z wymiarem

Ten przykład tworzy plan usługi App Service, a następnie tworzy dla niego alert metryk. W przykładzie użyto wymiaru, aby określić, że wszystkie wystąpienia planu usługi App Service zostaną objęte tą metryką. Przykład tworzy grupę zasobów i plan usługi aplikacji.

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

Aby wyświetlić listę możliwych metryk, uruchom polecenie az monitor metrics list-definitions . Parametr --output wyświetla wartości w formacie czytelnym.

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"

Czyszczenie wdrożenia

Jeśli utworzono grupy zasobów w celu przetestowania tych poleceń, możesz usunąć grupę zasobów i całą jej zawartość przy użyciu polecenia az group delete :

az group delete --name ContosoVMRG

az group delete --name ContosoRG

Jeśli używasz istniejących zasobów, które chcesz zachować, użyj polecenia az monitor metrics alert delete , aby usunąć alerty dotyczące praktyki:

az monitor metrics alert delete --name alert-01

az monitor metrics alert delete --name alert-02

Polecenia interfejsu wiersza polecenia platformy Azure używane w tym artykule

W tym artykule są używane następujące polecenia interfejsu wiersza polecenia platformy Azure:

Następne kroki