Creare avvisi sulle metriche in Monitoraggio di Azure per i servizi di Azure - Interfaccia della riga di comando multipiattaformaCreate metric alerts in Azure Monitor for Azure services - Cross-platform CLI

PanoramicaOverview

Questo articolo descrive come impostare gli avvisi sulle metriche di Azure tramite l'interfaccia della riga di comando multipiattaforma.This article shows you how to set up Azure metric alerts using the cross-platform Command Line Interface (CLI).

Nota

Dal 25 settembre 2016 Monitoraggio di Azure è il nuovo nome di "Azure Insights".Azure Monitor is the new name for what was called "Azure Insights" until Sept 25th, 2016. Tuttavia, gli spazi dei nomi e quindi i comandi seguenti contengono ancora il termine "insights".However, the namespaces and thus the commands below still contain the "insights".

È possibile ricevere avvisi basati su metriche di monitoraggio o eventi nei servizi Azure.You can receive an alert based on monitoring metrics for, or events on, your Azure services.

  • Valori metrici : l'avviso si attiva quando il valore di una specifica metrica supera una soglia assegnata per eccesso o difetto.Metric values - The alert triggers when the value of a specified metric crosses a threshold you assign in either direction. Vale a dire che si attiva sia quando la condizione viene inizialmente soddisfatta e successivamente quando tale condizione non è più soddisfatta.That is, it triggers both when the condition is first met and then afterwards 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, only when a certain events occurs. Per altre informazioni sugli avvisi sui log attività fare clic quiTo learn more about activity log alerts click here

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

  • inviare un messaggio di posta elettronica all'amministratore e ai coamministratori del serviziosend email notifications to the service administrator and co-administrators
  • inviare un messaggio di posta elettronica ad altri indirizzi specificatisend email to additional emails that you specify.
  • chiamare un webhookcall a webhook
  • avviare l'esecuzione di un runbook di Azure; attualmente è possibile solo dal portale di Azurestart execution of an Azure runbook (only from the Azure portal at this time)

È possibile configurare e ottenere informazioni sulle regole degli avvisi sulle metriche tramiteYou can configure and get information about metric alert rules using

È possibile ricevere assistenza per i comandi digitando un comando e inserendo -help al termine.You can always receive help for commands by typing a command and putting -help at the end. Ad esempio:For example:

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

Creare le regole di avviso tramite l'interfaccia della riga di comandoCreate alert rules using the CLI

  1. Controllare i prerequisiti e accedere ad Azure.Perform the Prerequisites and login to Azure. Vedere gli esempi dell'interfaccia della riga di comando di Monitoraggio di Azure.See Azure Monitor CLI samples. In breve, installare l'interfaccia della riga di comando ed eseguire questi comandi.In short, install the CLI and run these commands. Questi comandi eseguono l'accesso, indicano la sottoscrizione in uso e preparano l'esecuzione dei comandi di Monitoraggio di Azure.They get you logged in, show what subscription you are 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 seguente formato azure insights alerts rule list [opzioni] <resourceGroup>To list existing rules on a resource group, use the following form 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.

    • L' ID risorsa della risorsa per la quale si intende impostare un avvisoThe Resource ID for the resource you want to set an alert for
    • Le definizioni delle metriche disponibili per tale risorsaThe metric definitions 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 the resource is already created, select it in the portal. Nel pannello successivo, nella sezione Impostazioni, selezionare Proprietà.Then in the next blade, select Properties under the Settings section. ID RISORSA è un campo nel pannello successivo.The RESOURCE ID is a field in the next blade. È anche possibile usare Esplora risorse di Azure.Another way is to use the Azure Resource Explorer.

      Un esempio di ID risorsa per un'app Web èAn example resource id for a web app is

      /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 l'esempio precedente di risorse, usare il comando dell'interfaccia della riga di comando seguente:To get a list of the available metrics and units for those metrics for the previous resource example, use the following 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 misurazione disponibile, con intervalli di 1 minuto.PT1M is the granularity of the available measurement (1-minute intervals). L'uso di granularità diverse offre opzioni di metrica diverse.Using different granularities gives you different metric options.

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

    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 imposta un avviso relativo a una risorsa del sito Web.The following example sets up an alert on a web site 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 il webhook o inviare un messaggio di posta elettronica all'attivazione di un avviso di metrica, creare prima il messaggio di posta elettronica e/o i webhook.To create webhook or send email when a metric alert fires, first create the email and/or webhooks. Creare la regola immediatamente dopo.Then create the rule immediately afterwards. Non è possibile associare il webhook o messaggi di posta elettronica a regole già create tramite l'interfaccia della riga di comando.You cannot associate webhook or emails with already created rules using the CLI.

    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:To delete rules, use a command of the form:

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