Condividi tramite


Guida introduttiva: Creare avvisi con Azure Resource Graph e Log Analytics

In questa guida introduttiva si apprenderà come usare Azure Log Analytics per creare avvisi nelle query di Azure Resource Graph. È possibile creare avvisi con query di Azure Resource Graph, area di lavoro Log Analytics e identità gestite. Le condizioni dell'avviso inviano notifiche a un intervallo specificato.

È possibile usare le query per configurare gli avvisi per le risorse di Azure distribuite. È possibile creare query usando le tabelle di Azure Resource Graph oppure combinare tabelle di Azure Resource Graph e dati di Log Analytics dai log di Monitoraggio di Azure.

Negli esempi di questo articolo creare risorse nello stesso gruppo di risorse e usare la stessa area, ad esempio Stati Uniti occidentali 3. Gli esempi in questo articolo eseguono query e creano avvisi per le risorse di Azure in un singolo tenant di Azure. I cluster di Esplora dati di Azure non rientrano nell'ambito di questo articolo.

Questo articolo include due esempi di avvisi:

  • Azure Resource Graph: usa la tabella di Azure Resource Graph Resources per creare una query che ottiene i dati per le risorse di Azure distribuite e crea un avviso.
  • Azure Resource Graph e Log Analytics: usa la tabella di Azure Resource Graph Resources e i dati di Log Analytics della tabella Heartbeat dei log di Monitoraggio di Azure. In questo esempio viene usata una macchina virtuale per illustrare come configurare la query e l'avviso.

Nota

L'integrazione degli avvisi di Azure Resource Graph con Log Analytics è disponibile in anteprima pubblica.

Prerequisiti

  • Se non si ha un account Azure, creare un account gratuito prima di iniziare.
  • Risorse distribuite in Azure, ad esempio macchine virtuali o account di archiviazione.
  • Per usare l'esempio per la query Azure Resource Graph e Log Analytics, è necessaria almeno una macchina virtuale di Azure con l'agente di Monitoraggio di Azure.

Creare un'area di lavoro

Creare un'area di lavoro Log Analytics nella sottoscrizione monitorata.

  1. Accedere al portale di Azure.

  2. Nel campo di ricerca digitare aree di lavoro log analytics e selezionare Aree di lavoro Log Analytics.

    Se sono state usate aree di lavoro Log Analytics, è possibile selezionarla dai servizi di Azure.

    Screenshot della home page di Azure che evidenzia il campo di ricerca e le aree di lavoro Log Analytics.

  3. Selezionare Crea:

    • Sottoscrizione: selezionare la sottoscrizione di Azure
    • Gruppo di risorse: demo-arg-alert-rg
    • Nome: demo-arg-alert-workspace
    • Area: Stati Uniti occidentali 3
      • È possibile selezionare un'area diversa, ma usare la stessa area per altre risorse.
  4. Selezionare Rivedi e crea e attendere che venga visualizzata la convalida passata.

  5. Selezionare Crea per avviare la distribuzione.

  6. Al termine della distribuzione, selezionare Vai alla risorsa.

Crea macchina virtuale

Non è necessario creare una macchina virtuale per l'esempio che usa la tabella di Azure Resource Graph.

Crea query

Nell'area di lavoro Log Analytics creare una query di Azure Resource Graph per ottenere un conteggio delle risorse di Azure. Questo esempio usa la tabella Resources di Azure Resource Graph.

  1. Selezionare Log dal lato sinistro della pagina dell'area di lavoro Log Analytics. Chiudere la finestra Query se visualizzata.

  2. Usare il codice seguente nella nuova query:

    arg("").Resources
    | count
    

    I nomi delle tabelle in Log Analytics devono essere maiuscole e minuscole con la prima lettera di ogni parola maiuscola, ad esempio Resources o ResourceContainers. È anche possibile usare lettere minuscole come resources o resourcecontainers.

    Screenshot dell'area di lavoro Log Analytics con una query della tabella Risorse che evidenzia i log e il pulsante Esegui.

  3. Selezionare Esegui.

    I risultati visualizzano il numero di risorse nella sottoscrizione di Azure. Prendere nota di tale numero perché è necessario per la condizione della regola di avviso. Quando si esegue manualmente la query, il conteggio si basa sull'identità utente e un avviso attivato usa un'identità gestita. È possibile che il conteggio possa variare tra un'esecuzione manuale o un avviso attivato.

  4. Rimuovere il conteggio dalla query.

    arg("").Resources
    

Crea regola di avviso

Nell'area di lavoro Log Analytics selezionare Nuova regola di avviso. La query dall'area di lavoro Log Analytics viene copiata nella regola di avviso. Creare una regola di avviso include diverse schede che devono essere aggiornate per creare l'avviso.

Screenshot della pagina dell'area di lavoro Log Analytics che evidenzia la nuova regola di avviso.

Ambito

Verificare che l'ambito predefinito sia l'area di lavoro Log Analytics denominata demo-arg-alert-workspace.

Solo se l'ambito non è impostato sul valore predefinito, seguire questa procedura:

  1. Passare alla scheda Ambito e selezionare Seleziona ambito.
  2. Nella parte inferiore della schermata Risorse selezionate rimuovere l'ambito corrente.
  3. Selezionare l'opzione Seleziona ambito.
  4. Espandere demo-arg-alert-rg dall'elenco delle risorse e selezionare demo-arg-alert-workspace.
  5. Selezionare Applica.
  6. Selezionare Avanti: Condizione.

Condizione

Il modulo include diversi campi da completare:

  • Nome del segnale: ricerca log personalizzata
  • Query di ricerca: visualizza il codice della query
    • Se l'ambito è stato modificato, è necessario aggiungere la query dalla sezione Crea query.

Misura

  • Misura: righe di tabella
  • Tipo di aggregazione: Conteggio
  • Granularità aggregazione: 5 minuti

Logica avvisi

  • Operatore: maggiore di
  • Valore soglia: usare un numero minore che il numero restituito dal numero delle risorse.
    • Ad esempio, se il numero di risorse è 50, usare 45. Questo valore attiva l'avviso quando valuta le risorse perché il numero di risorse è maggiore del valore soglia.
  • Frequenza della valutazione: 5 minuti

Al termine, selezionare Avanti: Azioni.

Azioni

Selezionare Crea gruppo di azioni:

  • Sottoscrizione: selezionare una sottoscrizione di Azure.
  • Gruppo di risorse: demo-arg-alert-rg
  • Area: globale consente al servizio gruppi di azioni di selezionare la posizione.
  • Nome gruppo di azioni: demo-arg-alert-action-group
  • Nome visualizzato: azione demo (il limite è di 12 caratteri)

Selezionare Avanti: Notifiche:

  • Tipo di notifica: selezionare Messaggio di posta elettronica/SMS/Push/Voce.
  • Nome: email-alert
  • Selezionare la casella di controllo posta elettronica e digitare l'indirizzo di posta elettronica.
  • Selezionare OK.

Selezionare Rivedi e crea, verificare che il riepilogo sia corretto e selezionare Crea. Si torna alla scheda Azioni della pagina Crea una regola di avviso. Il nome del gruppo di azioni mostra il gruppo di azioni creato. Si riceve una notifica tramite posta elettronica per confermare l'aggiunta al gruppo di azioni.

Selezionare Avanti: Dettagli.

Dettagli

Usare le informazioni seguenti nella scheda Dettagli:

  • Sottoscrizione: selezionare una sottoscrizione di Azure.
  • Gruppo di risorse: demo-arg-alert-rg
  • Gravità: accettare il valore predefinito 3 - Informativo.
  • Nome della regola di avviso: demo-arg-alert-rule
  • Descrizione della regola di avviso: avviso di posta elettronica per il numero di risorse di Azure
  • Area: Stati Uniti occidentali 3
  • Identity: Selezionare l'identità gestita assegnata dal sistema.

Selezionare Rivedi e crea, verificare che il riepilogo sia corretto e selezionare Crea. Si torna alla pagina Log dell'area di lavoro Log Analytics.

Assegnare il ruolo

Assegnare il lettore di Log Analytics all'identità gestita assegnata dal sistema in modo che disponga delle autorizzazioni per lanciare gli avvisi che inviano notifiche via e-mail.

  1. Selezionare Monitoraggio>avvisi nell'area di lavoro Log Analytics. Selezionare OK se viene richiesto che le modifiche non salvate verranno rimosse.
  2. Selezionare le regole di avviso.
  3. Selezionare demo-arg-alert-rule.
  4. Selezionare Impostazioni>Identità>Sistema assegnato:
    • Stato: Attivato
    • ID oggetto: mostra il GUID per l'applicazione aziendale (entità servizio) in Microsoft Entra ID.
    • Autorizzazione: selezionare assegnazioni di ruolo di Azure:
      • Verificare che la sottoscrizione sia selezionata.
      • Selezionare Aggiungi assegnazione di ruolo:
      • Ambito: sottoscrizione
      • Abbonamento: selezionare il nome dell’abbonamento di Azure.
      • Ruolo: lettore di Log Analytics
  5. Seleziona Salva.

La visualizzazione del lettore di Log Analytics nella pagina assegnazioni di ruolo di Azure richiede alcuni minuti. Selezionare Aggiorna per aggiornare la pagina.

Usare il pulsante Indietro del browser per tornare all'identità e quindi selezionare Panoramica per tornare alla regola di avviso. Selezionare il collegamento al gruppo di risorse denominato demo-arg-alert-rg.

Anche se non rientra nell'ambito di questo articolo, per un cluster di Esplora dati di Azure aggiungere il ruolo Lettore all'identità gestita assegnata dal sistema. Per altre informazioni, alla fine di questo articolo selezionare il collegamento Assegnazioni di ruolo per i cluster di Esplora dati di Azure.

Verificare gli avvisi

Dopo aver assegnato il ruolo alla regola di avviso, si inizia a ricevere messaggi di posta elettronica per i messaggi di avviso. La regola è stata creata per inviare avvisi ogni cinque minuti e sono necessari alcuni minuti per ottenere il primo avviso.

È anche possibile visualizzare gli avvisi nel portale di Azure:

  1. Passare al gruppo di risorse demo-arg-alert-rg.

  2. Selezionare demo-arg-alert-workspace nell'elenco di risorse.

  3. Selezionare Monitoraggio>Avvisi.

  4. Viene visualizzato un elenco di avvisi.

    Screenshot dell'area di lavoro Log Analytics che mostra l'elenco degli avvisi attivati.

Pulire le risorse

Se si vuole mantenere la configurazione dell'avviso ma arrestare l'attivazione e l'invio di notifiche tramite posta elettronica, è possibile disabilitarla. Passare alla regola di avviso demo-arg-alert-rule o demo-arg-la-alert-rule e selezionare Disabilita.

Se non è necessario questo avviso o le risorse create in questo esempio, eliminare il gruppo di risorse seguendo questa procedura:

  1. Passare al gruppo di risorse demo-arg-alert-rg.
  2. Selezionare Elimina gruppo di risorse.
  3. Digitare il nome del gruppo di risorse da confermare.
  4. Selezionare Elimina.

Se è stata creata una macchina virtuale, eliminare la chiave privata scaricata nel computer durante la distribuzione. Il nome file ha un'estensione .pem.

Per altre informazioni sul linguaggio di query o su come esplorare le risorse, vedere gli articoli seguenti.