Waarschuwing voor metrische gegevens maken in Azure CLI
Deze voorbeelden maken metrische waarschuwingsmonitors in Azure Monitor met behulp van Azure CLI-opdrachten. In het eerste voorbeeld wordt een waarschuwing voor een virtuele machine gemaakt. Met de tweede opdracht wordt een waarschuwing gemaakt die een dimensie voor een App Service-plan bevat.
Vereisten
Gebruik de Bash-omgeving in Azure Cloud Shell. Zie quickstart voor Bash in Azure Cloud Shell voor meer informatie.
Installeer de Azure CLI, indien gewenst, om CLI-referentieopdrachten uit te voeren. Als u in Windows of macOS werkt, kunt u Azure CLI uitvoeren in een Docker-container. Zie De Azure CLI uitvoeren in een Docker-container voor meer informatie.
Als u een lokale installatie gebruikt, meldt u zich aan bij Azure CLI met behulp van de opdracht az login. Volg de stappen die worden weergegeven in de terminal, om het verificatieproces te voltooien. Raadpleeg Aanmelden bij Azure CLI voor aanvullende aanmeldingsopties.
Installeer de Azure CLI-extensie bij het eerste gebruik, wanneer u hierom wordt gevraagd. Raadpleeg Extensies gebruiken met Azure CLI voor meer informatie over extensies.
Voer az version uit om de geïnstalleerde versie en afhankelijke bibliotheken te vinden. Voer az upgrade uit om te upgraden naar de nieuwste versie.
Een waarschuwing maken
Deze waarschuwing bewaakt een bestaande virtuele machine met de naam VM07
in de resourcegroep.ContosoVMRG
U kunt een resourcegroep maken met behulp van de opdracht az group create . Zie Een virtuele Windows-machine maken met de Azure CLI, een virtuele Linux-machine maken met de Azure CLI en de opdracht az vm create voor meer informatie over het maken van virtuele machines.
# 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 dit voorbeeld wordt het tsv
uitvoertype gebruikt, dat geen ongewenste symbolen zoals aanhalingstekens bevat. Zie Azure CLI effectief gebruiken voor meer informatie.
Een waarschuwing maken met een dimensie
In dit voorbeeld wordt een App Service-plan gemaakt en wordt er vervolgens een waarschuwing voor metrische gegevens voor gemaakt. In het voorbeeld wordt een dimensie gebruikt om op te geven dat alle exemplaren van het App Service-plan onder deze metrische waarde vallen. In het voorbeeld wordt een resourcegroep en toepassingsserviceplan gemaakt.
# 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)
Voer de opdracht az monitor metrics list-definitions uit om een lijst met mogelijke metrische gegevens weer te geven. De --output
parameter geeft de waarden weer in een leesbare indeling.
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"
Opschonen van implementatie
Als u resourcegroepen hebt gemaakt om deze opdrachten te testen, kunt u een resourcegroep en alle inhoud ervan verwijderen met behulp van de opdracht az group delete :
az group delete --name ContosoVMRG
az group delete --name ContosoRG
Als u bestaande resources hebt gebruikt die u wilt behouden, gebruikt u de opdracht az monitor metrics alert delete om uw praktijkwaarschuwingen te verwijderen:
az monitor metrics alert delete --name alert-01
az monitor metrics alert delete --name alert-02
Azure CLI-opdrachten die in dit artikel worden gebruikt
In dit artikel worden de volgende Azure CLI-opdrachten gebruikt:
- 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