Condividi tramite

Creare una nuova regola di avviso utilizzando la CLI, PowerShell o un modello ARM

  • Articolo

È possibile creare una nuova regola di avviso usando l’interfaccia della riga di comando, PowerShell o un modello di Azure Resource Manager.

Prerequisiti

Per creare o modificare una regola di avviso, è necessario disporre delle autorizzazioni seguenti:

  • Autorizzazione di lettura nella risorsa di destinazione della regola di avviso.
  • Autorizzazione di scrittura nel gruppo di risorse in cui viene creata la regola di avviso. Se si sta creando la regola di avviso dal portale di Azure, questa viene creata per impostazione predefinita nello stesso gruppo di risorse in cui si trova la risorsa di destinazione.
  • Autorizzazione di lettura per qualsiasi gruppo di azioni associato alla regola di avviso, se applicabile.

Creare una nuova regola di avviso usando l'interfaccia della riga di comando

Una nuova regola di avviso può essere creata usando l'interfaccia della riga di comando di Azure. Gli esempi di codice seguenti usano Azure Cloud Shell. È possibile visualizzare l'elenco completo dei comandi dell'interfaccia della riga di comando di Azure per Monitoraggio di Azure.

  1. Nel portale selezionare Cloud Shell. Al prompt, considerare queste opzioni.

    Ad esempio è possibile creare una regola di avviso delle metriche che monitora se il valore medio di Percentuale CPU in una macchina virtuale è maggiore di 90:

     az monitor metrics alert create -n {nameofthealert} -g {ResourceGroup} --scopes {VirtualMachineResourceID} --condition "avg Percentage CPU > 90" --description {descriptionofthealert}

Creare una nuova regola di avviso con PowerShell

  • Per creare una regola di avviso delle metriche con PowerShell, usare il cmdlet Add-AzMetricAlertRuleV2.

    Nota

    Quando si crea un avviso delle metriche su una singola risorsa, la sintassi usa TargetResourceId. Quando si crea un avviso delle metriche su più risorse, la sintassi contiene TargetResourceScope, TargetResourceType e TargetResourceRegion.

  • Per creare una regola di avviso di ricerca log con PowerShell, usare il cmdlet New-AzScheduledQueryRule.
  • Per creare una regola di avviso del log attività con PowerShell, usare il cmdlet New-AzActivityLogAlert.

Creare una nuova regola di avviso usando un modello di Resource Manager

È possibile usare un modello di Azure Resource Manager (modello di ARM) per configurare le regole di avviso in modo coerente in tutti gli ambienti.

  1. Creare una nuova risorsa usando i tipi di risorsa seguenti:

    • Per gli avvisi delle metriche: Microsoft.Insights/metricAlerts

      Nota

      • È consigliabile creare l'avviso delle metriche usando lo stesso gruppo di risorse della risorsa di destinazione.
      • Gli avvisi delle metriche per un tipo di risorsa dell'area di lavoro Log Analytics di Azure (Microsoft.OperationalInsights/workspaces) sono configurati in modo diverso rispetto ad altri avvisi delle metriche. Per altre informazioni, vedere Modello di risorse per gli avvisi delle metriche per i log.
      • Se si crea un avviso delle metriche per una singola risorsa, il modello usa il ResourceId della risorsa di destinazione. Se si sta creando un avviso per le metriche per più risorse, il modello usa scope, TargetResourceType e TargetResourceRegion per le risorse di destinazione.
    • Per gli avvisi per la ricerca log: Microsoft.Insights/scheduledQueryRules
    • Regole di avviso per i log attività, integrità dei servizi o integrità risorse: microsoft.Insights/activityLogAlerts

  2. Copiare un modello da questi modelli di Azure Resource Manager di esempio.

  3. Modificare il file modello per contenere le informazioni appropriate per l'avviso, quindi salvarlo come <file-alert-template-file>.JSON.

  4. Modificare il file dei parametri corrispondente per personalizzare l'avviso, quindi salvarlo come <your-alert-template-file>.parameters.JSON.

  5. Impostare il parametro metricName usando uno dei valori nelle metriche supportate da Monitoraggio di Azure.

  6. Distribuire il modello usando PowerShell o l'interfaccia della riga di comando.

Passaggi successivi