Creare un avviso per le metriche nell'interfaccia della riga di comando di Azure
Questi campioni creano rilevatori degli avvisi per le metriche in Monitoraggio di Azure usando i comandi dell'interfaccia della riga di comando di Azure. Il primo campione crea un avviso per una macchina virtuale. Il secondo comando crea un avviso che include una dimensione per un piano di servizio app.
Prerequisiti
Usare l'ambiente Bash in Azure Cloud Shell. Per altre informazioni, vedere Avvio rapido su Bash in Azure Cloud Shell.
Se si preferisce eseguire i comandi di riferimento dell'interfaccia della riga di comando in locale, installare l'interfaccia della riga di comando di Azure. Per l'esecuzione in Windows o macOS, è consigliabile eseguire l'interfaccia della riga di comando di Azure in un contenitore Docker. Per altre informazioni, vedere Come eseguire l'interfaccia della riga di comando di Azure in un contenitore Docker.
Se si usa un'installazione locale, accedere all'interfaccia della riga di comando di Azure con il comando az login. Per completare il processo di autenticazione, seguire la procedura visualizzata nel terminale. Per altre opzioni di accesso, vedere Accedere tramite l'interfaccia della riga di comando di Azure.
Quando richiesto, al primo utilizzo installare l'estensione dell'interfaccia della riga di comando di Azure. Per altre informazioni sulle estensioni, vedere Usare le estensioni con l'interfaccia della riga di comando di Azure.
Eseguire az version per trovare la versione e le librerie dipendenti installate. Per eseguire l'aggiornamento alla versione più recente, eseguire az upgrade.
Creare un avviso
Tale avviso monitora una macchina virtuale esistente denominata VM07
nel gruppo di risorse denominato ContosoVMRG
.
Si crea prima di tutto un gruppo di risorse usando il comando az group create. Per informazioni sulla creazione di macchine virtuali, vedere Creare una macchina virtuale Windows con l'interfaccia della riga di comando di Azure, Creare una macchina virtuale Linux con l'interfaccia della riga di comando di Azure e il comando 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"
Questo campione usa il tipo di output tsv
, che non include simboli indesiderati, ad esempio le virgolette. Per altre informazioni, vedere Usare l'interfaccia della riga di comando di Azure in modo efficace.
Creare un avviso con una dimensione
Questo campione crea un piano di servizio app e quindi il relativo avviso per le metriche. Nell'esempio viene usata una dimensione per specificare che tutte le istanze del piano di servizio app rientreranno in questa metrica. Il campione crea un gruppo di risorse e un piano di servizio dell'applicazione.
# 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)
Per visualizzare un elenco delle possibili metriche, eseguire il comando az monitor metrics list-definitions. Il parametro --output
visualizza i valori in un formato leggibile.
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"
Pulire la distribuzione
Se si sono creati gruppi di risorse per testare questi comandi, è possibile eliminarne uno e i relativi contenuti usando il comando az group delete:
az group delete --name ContosoVMRG
az group delete --name ContosoRG
Se si sono usate risorse esistenti da mantenere, usare il comando az monitor metrics alert delete per eliminare gli avvisi delle procedure:
az monitor metrics alert delete --name alert-01
az monitor metrics alert delete --name alert-02
Comandi dell'interfaccia della riga di comando di Azure usati in questo articolo
In questo articolo vengono usati i comandi dell'interfaccia della riga di comando di Azure seguenti:
- 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