Tworzenie alertu dotyczącego metryk w interfejsie wiersza polecenia platformy Azure
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
Użyj środowiska powłoki Bash w usłudze Azure Cloud Shell. Aby uzyskać więcej informacji, zobacz Szybki start dotyczący powłoki Bash w usłudze Azure Cloud Shell.
Jeśli wolisz uruchamiać polecenia referencyjne interfejsu wiersza polecenia lokalnie, zainstaluj interfejs wiersza polecenia platformy Azure. Jeśli korzystasz z systemu Windows lub macOS, rozważ uruchomienie interfejsu wiersza polecenia platformy Azure w kontenerze Docker. Aby uzyskać więcej informacji, zobacz Jak uruchomić interfejs wiersza polecenia platformy Azure w kontenerze platformy Docker.
Jeśli korzystasz z instalacji lokalnej, zaloguj się do interfejsu wiersza polecenia platformy Azure za pomocą polecenia az login. Aby ukończyć proces uwierzytelniania, wykonaj kroki wyświetlane w terminalu. Aby uzyskać inne opcje logowania, zobacz Logowanie się przy użyciu interfejsu wiersza polecenia platformy Azure.
Po wyświetleniu monitu zainstaluj rozszerzenie interfejsu wiersza polecenia platformy Azure podczas pierwszego użycia. Aby uzyskać więcej informacji na temat rozszerzeń, zobacz Korzystanie z rozszerzeń w interfejsie wiersza polecenia platformy Azure.
Uruchom polecenie az version, aby znaleźć zainstalowane wersje i biblioteki zależne. Aby uaktualnić do najnowszej wersji, uruchom polecenie az upgrade.
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:
- az appservice plan create
- az appservice plan show
- az group create
- az group delete
- az monitor action-group create
- az monitor metrics alert condition create
- az monitor metrics alert create
- az monitor metrics alert delete
- az monitor metrics alert dimension create
- az monitor metrics list-definitions
- az vm show