Personalizzare le notifiche di avviso utilizzando Logic Apps

Questo articolo illustra come creare un'app per la logica e integrarla con un avviso di Monitoraggio di Azure. È possibile usare App per la logica di Azure per creare e personalizzare i flussi di lavoro per l'integrazione. Usa Logic Apps per personalizzare le notifiche degli avvisi. È possibile:

• Personalizzare il messaggio di posta elettronica degli avvisi, utilizzando il formato preferito per l'oggetto e il corpo dell'email.

• Personalizzare i metadati dell'avviso cercando i tag per le risorse interessate o recuperando un risultato della ricerca di query di log. Per informazioni su come accedere alle righe dei risultati della ricerca contenenti dati degli avvisi, vedere:

  • Formato di risposta dell'API di Log Analytics di Azure Monitor
  • Risposta HTTP di query/gestione

• Eseguire l'integrazione con i servizi esterni usando connettori esistenti come Outlook, Microsoft Teams, Slack e PagerDuty. È anche possibile configurare l'app per la logica per i propri servizi.

Questo esempio crea un'app per la logica che usa lo schema degli avvisi comuni per inviare i dettagli dall'avviso.

Creare un'app per la logica

1. Nel portale di Azure, creare un'app per la logica. Nella barra di ricerca nella parte superiore della pagina, inserire Logic Apps e selezionarla dal menu a tendina.

2. Nella pagina App per la logica selezionare Aggiungi.

3. In Consumoselezionare Multi-tenant.

4. Nella pagina successiva, selezionare la Sottoscrizione e il Gruppo di risorse per l’app per la logica.

5. Imposta un nome della Logic App e scegli una Regione.

6. Selezionare Rivedi e crea>Crea.

   

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

Configurare un trigger

1. Nella pagina App per la logica selezionare Modifica nella barra delle azioni superiore.

2. Selezionare Aggiungi un trigger, cercare Quando viene ricevuta una richiesta HTTP e selezionarla nei risultati della ricerca.

   

3. Incollare lo schema di avviso comune nel campo Schema JSON del corpo della richiesta dal codice JSON seguente:

    {
       "type": "object",
       "properties": {
           "schemaId": {
               "type": "string"
           },
           "data": {
               "type": "object",
               "properties": {
                   "essentials": {
                       "type": "object",
                       "properties": {
                           "alertId": {
                               "type": "string"
                           },
                           "alertRule": {
                               "type": "string"
                           },
                           "severity": {
                               "type": "string"
                           },
                           "signalType": {
                               "type": "string"
                           },
                           "monitorCondition": {
                               "type": "string"
                           },
                           "monitoringService": {
                               "type": "string"
                           },
                           "alertTargetIDs": {
                               "type": "array",
                               "items": {
                                   "type": "string"
                               }
                           },
                           "originAlertId": {
                               "type": "string"
                           },
                           "firedDateTime": {
                               "type": "string"
                           },
                           "resolvedDateTime": {
                               "type": "string"
                           },
                           "description": {
                               "type": "string"
                           },
                           "essentialsVersion": {
                               "type": "string"
                           },
                           "alertContextVersion": {
                               "type": "string"
                           }
                       }
                   },
                   "alertContext": {
                       "type": "object",
                       "properties": {}
                   }
               }
           }
       }
   }
   

   

4. (Opzionale). È possibile personalizzare la notifica di avviso estraendo informazioni sulla risorsa interessata in cui è stato attivato l'avviso, ad esempio i tag della risorsa. È quindi possibile includere tali tag di risorsa nel payload dell'avviso e usare le informazioni nelle espressioni logiche per l'invio delle notifiche. Per eseguire questo passaggio, verranno eseguite le operazioni seguenti:

   • Creare una variabile per gli ID risorsa interessati.
   • Dividere l'ID risorsa in una matrice in modo che sia possibile usare i vari elementi, ad esempio sottoscrizione e gruppo di risorse.
   • Usare il connettore Azure Resource Manager per leggere i metadati della risorsa.
   • Recuperare i tag della risorsa, che possono quindi essere usati nei passaggi successivi dell'app per la logica.

   1. Selezionare +>Aggiungi un'azione per inserire un nuovo passaggio.

   2. Nel campo Cerca, cercare e selezionare Inizializza variabile.

   3. Nel campo Nome, immettere il nome della variabile, ad esempio AffectedResource.

   4. Nel campo Tipo seleziona Matrice.

   5. Nel campo Valore selezionare fx per aprire la finestra popup Funzione. Immettere la stringa split(triggerBody()?['data']?['essentials']?['alertTargetIDs'][0], '/') nel campo vuoto nella parte superiore e selezionare Aggiungi.

      

   6. Selezionare +>Aggiungi un'azione per inserire un altro passaggio.

   7. Nel campo Ricerca cercare e selezionare Azure Resource Manager>Per altreinformazioni, vedere >Altre informazioni su una risorsa.

   8. Selezionare un metodo di autenticazione e Accedi.

   9. Popolare i campi dell'azione Leggi una risorsa con i valori della matrice dalla variabile AffectedResource. In ognuno dei campi, selezionare il campo e scorrere verso il basso fino a Immettere un valore personalizzato. Selezionare fx per aprire la finestra popup Funzione. Immettere la stringa corrispondente da questa tabella nel campo vuoto nella parte superiore e selezionare Aggiungi.

      Campo	Valore stringa
      Abbonamento	variables('AffectedResource')[2]
      Gruppo di risorse	variables('AffectedResource')[4]
      Provider di risorse	variables('AffectedResource')[6]
      ID risorsa breve	concat(variables('AffectedResource')[7], '/', variables('AffectedResource')[8])
      Versione API client	Versione dell'API del tipo di risorsa

      Per trovare la versione dell'API del tipo di risorsa, selezionare il collegamento visualizzazione JSON nella parte superiore destra della pagina di panoramica delle risorse.

      La pagina JSON della risorsa viene visualizzata con ResourceID e la versione APInella parte superiore della pagina.

   Il contenuto dinamico ora include i tag della risorsa interessata. È possibile usare questi tag quando si configurano le notifiche come descritto nei passaggi seguenti.

Configurare un'azione

Selezionare +>Aggiungi un'azione per inserire un nuovo passaggio.

Creare un gruppo di azioni

Per attivare l'app per la logica, creare un gruppo di azioni. Creare quindi un avviso che usa tale gruppo di azioni.

1. Passare alla pagina Monitoraggio di Azure e selezionare Avvisi nel riquadro a sinistra.

2. Selezionare i Gruppi di azioni>Crea.

3. Selezionare i valori per Sottoscrizione, Gruppo di risorse e Regione.

4. Immettere un nome per Nome del gruppo di azioni e Nome visualizzato.

5. Seleziona la scheda Azioni.

   

6. Nella scheda Azioni in Tipo di azione, selezionare App per la logica.

7. Nella sezione App per la logica, selezionare l'app per la logica dall'elenco a discesa.

8. Impostare Abilita lo schema di avviso comune su Sì. Se si seleziona No, il tipo di avviso determina quale schema di avviso viene usato. Per altre informazioni sugli schemi di avviso, vedere Schemi di avviso specifici del contesto.

9. Seleziona OK.

10. Immettere un nome nel campo Nome.

11. Selezionare Rivedi e crea>Crea.

    

Metti alla prova il gruppo di azioni

1. Passare alla pagina Monitoraggio di Azure e selezionare Avvisi nel riquadro a sinistra.

2. Passare a Gruppi di azioni e selezionare l'app per la logica.

3. Selezionare Test nella barra delle azioni superiore.

4. Selezionare un tipo di avviso di esempio dall'elenco a discesa Seleziona tipo di esempio.

5. Selezionare Verifica.

   

   L'indirizzo di posta elettronica seguente viene inviato all'account specificato:

   

Creare una regola usando il gruppo di azioni

1. Creare una regola di avviso per una delle risorse.

2. Nella scheda Azioni della regola scegliere Usa gruppi di azioni.

3. Selezionare il gruppo di azioni dall'elenco.

4. Scegli Seleziona.

5. Completare la creazione della regola.

   

Passaggi successivi

• Altre informazioni sui gruppi di azioni.
• Altre informazioni sullo schema di avviso comune.