Usare l'interfaccia della riga di comando di Azure multipiattaforma per creare avvisi per le metriche in versione classica in Monitoraggio di Azure per i servizi di AzureUse the cross-platform Azure CLI to create classic metric alerts in Azure Monitor for Azure services

Nota

Questo articolo descrive come creare avvisi delle metriche classici di tipo precedente. Monitoraggio di Azure supporta ora avvisi delle metriche più recenti e migliori. Questi avvisi possono monitorare più metriche e consentire le segnalazioni sulle metriche dimensionali. Il supporto dell'interfaccia della riga di comando di Azure per i nuovi avvisi per le metriche sarà presto disponibile.

Questo articolo descrive come configurare avvisi per le metriche di Azure in versione classica tramite l'interfaccia della riga di comando multipiattaforma di Azure.This article shows you how to set up Azure classic metric alerts by using the cross-platform command-line interface (Azure CLI).

Nota

Dal 25 settembre 2016 Monitoraggio di Azure è il nuovo nome di "Azure Insights". Gli spazi dei nomi e quindi i comandi descritti in questo articolo contengono tuttavia ancora il termine "insights".

È possibile ricevere un avviso in base alle metriche per i servizi di Azure o in base agli eventi che si verificano in Azure.You can receive an alert based on metrics for your Azure services, or based on events that occur in Azure.

  • Valori delle metriche: l'avviso si attiva quando il valore di una metrica specifica supera una soglia assegnata per eccesso o per difetto.Metric values: The alert triggers when the value of a specified metric crosses a threshold that you assign in either direction. Vale a dire che si attiva sia quando la condizione viene inizialmente soddisfatta che quando tale condizione non è più soddisfatta.That is, it triggers both when the condition is first met and then when that condition is no longer being met.

  • Eventi del log attività: è possibile attivare un avviso per ogni evento o solo quando si verifica un determinato evento.Activity log events: An alert can trigger on every event or when certain events occur. Per altre informazioni sui log attività, vedere Creare avvisi del log attività (versione classica).To learn more about activity logs, see Create activity log alerts (classic).

È possibile configurare un avviso classico delle metriche affinché esegua queste operazioni al momento dell'attivazione:You can configure a classic metric alert to do the following when it triggers:

  • Inviare notifiche di posta elettronica all'amministratore e ai coamministratori del servizio.Send email notifications to the service administrator and co-administrators.
  • Inviare un messaggio di posta elettronica agli indirizzi specificati.Send email to email addresses that you specify.
  • Chiamare un webhook.Call a webhook.
  • Avviare l'esecuzione di un runbook di Azure (al momento ciò è possibile solo dal portale di Azure).Start execution of an Azure runbook (only from the Azure portal at this time).

È possibile configurare le regole di avviso per le metriche in versione classica e ottenere informazioni su di esse tramite:You can configure and get information about classic metric alert rules by using the following:

È anche possibile ottenere informazioni sui comandi digitando un comando seguito da -help.You can also get help for commands by typing a command with -help at the end. Di seguito è illustrato un esempio:Following is an example:

 azure insights alerts -help
 azure insights alerts actions email create -help

Creare regole di avviso tramite l'interfaccia della riga di comando di AzureCreate alert rules by using Azure CLI

  1. Dopo avere installato i prerequisiti, accedere ad Azure.After you've installed the prerequisites, sign in to Azure. Vedere Esempi dell'interfaccia della riga di comando per Monitoraggio di Azure per i comandi necessari per iniziare.See Azure Monitor CLI samples for the commands that you need to get started. Questi comandi sono utili per eseguire l'accesso, visualizzare la sottoscrizione in uso e prepararsi all'esecuzione dei comandi di Monitoraggio di Azure.These commands help you get signed in, show you what subscription you're using, and prepare you to run Azure Monitor commands.

    azure login
    azure account show
    azure config mode arm
    
  2. Per elencare le regole esistenti in un gruppo di risorse, usare il formato seguente:To list existing rules on a resource group, use the following format:

    azure insights alerts rule list [opzioni] <GruppoDiRisorse>azure insights alerts rule list [options] <resourceGroup>

    azure insights alerts rule list myresourcegroupname
    
  3. Per creare una regola, per prima cosa è necessario disporre di alcune informazioni importanti.To create a rule, you need to have several important pieces of information first.

    • ID della risorsa per la quale si vuole impostare un avviso.The resource ID for the resource you want to set an alert for.
    • Definizioni delle metriche disponibili per la risorsa.The metric definitions that are available for that resource.

      È possibile ottenere l'ID della risorsa tramite il portale di Azure.One way to get the resource ID is to use the Azure portal. Se la risorsa è già stata creata, selezionarla nel portale.Assuming that the resource is already created, select it in the portal. Nel pannello successivo, nella sezione Impostazioni, selezionare quindi Proprietà.Then, in the next blade, in the Settings section, select Properties. ID RISORSA è un campo del pannello successivo.RESOURCE ID is a field in the next blade.

      È anche possibile ottenere l'ID della risorsa tramite Azure Resource Explorer.You can also get the resource ID by using Azure Resource Explorer.

      Di seguito è illustrato un ID della risorsa di esempio per un'app Web:Following is an example resource ID for a web app:

      /subscriptions/dededede-7aa0-407d-a6fb-eb20c8bd1192/resourceGroups/myresourcegroupname/providers/Microsoft.Web/sites/mywebsitename
      

      Per ottenere un elenco delle metriche e delle unità per le metriche disponibili per la risorsa di esempio precedente, usare il comando dell'interfaccia della riga di comando di Azure seguente:To get a list of the available metrics and units for the metrics in the previous resource example, use the following Azure CLI command:

      azure insights metrics list /subscriptions/dededede-7aa0-407d-a6fb-eb20c8bd1192/resourceGroups/myresourcegroupname/providers/Microsoft.Web/sites/mywebsitename PT1M
      

      PT1M indica la granularità della misura disponibile, ovvero con intervalli di 1 minuto.PT1M is the granularity of the available measurement (in 1-minute intervals). L'uso di granularità diverse offre opzioni delle metriche diverse.You have different metric options when you use different granularities.

  4. Per creare una regola di avviso basata su una metrica, usare un comando nel formato seguente:To create a metric-based alert rule, use a command in the following format:

    azure insights alerts rule metric set [opzioni] <ruleName> <location> <resourceGroup> <windowSize> <operator> <threshold> <targetResourceId> <metricName> <timeAggregationOperator>azure insights alerts rule metric set [options] <ruleName> <location> <resourceGroup> <windowSize> <operator> <threshold> <targetResourceId> <metricName> <timeAggregationOperator>

    L'esempio seguente configura un avviso relativo a una risorsa di un sito Web.The following example sets up an alert on a website resource. L'avviso viene attivato ogni volta che si riceve il traffico costantemente per 5 minuti e di nuovo quando non si riceve traffico per 5 minuti.The alert triggers whenever it consistently receives any traffic for 5 minutes and again when it receives no traffic for 5 minutes.

    azure insights alerts rule metric set myrule eastus myreasourcegroup PT5M GreaterThan 2 /subscriptions/dededede-7aa0-407d-a6fb-eb20c8bd1192/resourceGroups/myresourcegroupname/providers/Microsoft.Web/sites/mywebsitename BytesReceived Total
    
  5. Per creare un webhook o inviare un messaggio di posta elettronica all'attivazione di un avviso per le metriche in versione classica, creare prima di tutto il messaggio di posta elettronica o il webhook.To create a webhook or send an email when a classic metric alert fires, first create the email or webhook. Creare la regola immediatamente dopo.Then create the rule immediately afterwards. Non è possibile associare webhook o messaggi di posta elettronica a regole già create.You can't associate webhooks or emails with rules that have already been created.

    azure insights alerts actions email create --customEmails myemail@contoso.com
    
    azure insights alerts actions webhook create https://www.contoso.com
    
    azure insights alerts rule metric set myrulewithwebhookandemail eastus myreasourcegroup PT5M GreaterThan 2 /subscriptions/dededede-7aa0-407d-a6fb-eb20c8bd1192/resourceGroups/myresourcegroupname/providers/Microsoft.Web/sites/mywebsitename BytesReceived Total
    
  6. È possibile verificare che gli avvisi siano stati creati correttamente esaminando una singola regola.You can verify that your alerts have been created properly by looking at an individual rule.

    azure insights alerts rule list myresourcegroup --ruleName myrule
    
  7. Per eliminare le regole, usare un comando nel formato seguente:To delete rules, use a command in the following format:

    insights alerts rule delete [opzioni] <resourceGroup><ruleName>insights alerts rule delete [options] <resourceGroup> <ruleName>

    Questi comandi eliminano le regole create in precedenza in questo articolo.These commands delete the rules that were previously created in this article.

    azure insights alerts rule delete myresourcegroup myrule
    azure insights alerts rule delete myresourcegroup myrulewithwebhookandemail
    azure insights alerts rule delete myresourcegroup myActivityLogRule
    

Passaggi successiviNext steps