Personalizzare le notifiche degli avvisi usando App per la logica

  • Articolo

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. Usare App per la logica per personalizzare le notifiche di avviso. È possibile:

  • Personalizzare il messaggio di posta elettronica degli avvisi usando il proprio oggetto e il formato del corpo dell'indirizzo di posta elettronica.
  • Personalizzare i metadati dell'avviso cercando 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 sugli avvisi, vedere:
  • 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. Nella portale di Azure creare una nuova app per la logica. Nella barra di ricerca nella parte superiore della pagina immettere App per la logica.

  2. Nella pagina App per la logica selezionare Aggiungi.

  3. Selezionare la sottoscrizione e il gruppo di risorse per l'app per la logica.

  4. Impostare il nome dell'app per la logica. Per Tipo di piano selezionare Consumo.

  5. Selezionare Rivedi e crea>Crea.

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

    Screenshot che mostra la pagina Crea app per la logica.

  7. Nella pagina app per la logica Designer selezionare Quando viene ricevuta una richiesta HTTP.

    Screenshot che mostra la pagina iniziale di App per la logica Designer.

  8. 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": {}
                }
            }
        }
    }
}

    Screenshot che mostra la scheda Parametri per il riquadro Quando viene ricevuta una richiesta HTTP.

  9. (Facoltativo). È 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.
    • Suddividere l'ID risorsa in una matrice in modo che sia possibile usare i vari elementi, ad esempio la sottoscrizione e il 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 selezionare Matrice.

    5. Nel campo Valore selezionare Aggiungi contenuto dinamico. Selezionare la scheda Espressione e immettere la stringa split(triggerBody()?['data']?['essentials']?['alertTargetIDs'][0], '/').

      Screenshot che mostra la scheda Parametri per il riquadro Inizializza variabile.

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

    7. Nel campo Cerca cercare e selezionare Azure Resource Manager>Read a resource (Leggere una risorsa).

    8. Popolare i campi dell'azione Leggi una risorsa con i valori della matrice dalla AffectedResource variabile. In ognuno dei campi selezionare il campo e scorrere verso il basso fino a Immettere un valore personalizzato. Selezionare Aggiungi contenuto dinamico e quindi selezionare la scheda Espressione . Immettere le stringhe della tabella seguente:

      Campo Valore stringa
      Subscription 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 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 RESOURCE JSON viene visualizzata con ResourceID e la versione dell'API nella parte superiore della pagina.

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

  10. Inviare un messaggio di posta elettronica o pubblicare un messaggio di Teams.

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

    Screenshot che mostra i parametri per Quando viene ricevuta una richiesta HTTP.

  1. Nel campo di ricerca cercare Outlook.

  2. Selezionare Office 365 Outlook.

    Screenshot che mostra la pagina Aggiungi un'azione del Designer app per la logica con Office 365 Outlook selezionato.

  3. Selezionare Invia un messaggio di posta elettronica (V2) dall'elenco di azioni.

  4. Accedere a Office 365 quando viene richiesto di creare una connessione.

  5. Creare il corpo del messaggio di posta elettronica immettendo testo statico e includendo il contenuto tratto dal payload dell'avviso scegliendo i campi dall'elenco Contenuto dinamico . Ad esempio:

    • Un avviso ha una condizione di monitoraggio: Selezionare monitorCondition nell'elenco Contenuto dinamico .
    • Data di inizio: Selezionare firedDateTime dall'elenco Contenuto dinamico .
    • Risorse interessate: Selezionare alertTargetIDs dall'elenco Contenuto dinamico .

  6. Nel campo Oggetto creare il testo dell'oggetto immettendo testo statico e includendo il contenuto tratto dal payload dell'avviso scegliendo i campi dall'elenco Contenuto dinamico . Ad esempio:

    • Avviso: Selezionare alertRule nell'elenco Contenuto dinamico .
    • con gravità: Selezionare gravità nell'elenco Contenuto dinamico .
    • ha condizione: Selezionare monitorCondition nell'elenco Contenuto dinamico .

  7. Immettere l'indirizzo di posta elettronica per inviare l'avviso al campo A .

  8. Selezionare Salva.

    Screenshot che mostra la scheda Parametri nel riquadro Invia un messaggio di posta elettronica.

È stata creata un'app per la logica che invia un messaggio di posta elettronica all'indirizzo specificato, con i dettagli dell'avviso che lo ha attivato.

Il passaggio successivo consiste nel creare un gruppo di azioni per attivare l'app per la logica.

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 Gruppi di> azioniCrea.

  3. Selezionare i valori per Sottoscrizione, gruppo di risorse e Area.

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

  5. Fare clic sulla scheda Actions (Azioni).

    Screenshot che mostra la scheda Azioni nella pagina Crea un gruppo di 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 schema di avviso comune su Sì. Se si seleziona No, il tipo di avviso determina lo schema di avviso usato. Per altre informazioni sugli schemi di avviso, vedere Schemi di avviso specifici del contesto.

  9. Selezionare OK.

  10. Immettere un nome nel campo Nome .

  11. Selezionare Rivedi e crea>Crea.

    Screenshot che mostra la scheda Azioni nella pagina Crea un gruppo di azioni e nel riquadro App per la logica.

Testare il gruppo di azioni

  1. Selezionare il gruppo di azioni.

  2. Nella sezione App per la logica selezionare Test gruppo di azioni (anteprima).

    Screenshot che mostra una pagina dei dettagli del gruppo di azioni con l'opzione Gruppo di azioni di test.

  3. Selezionare un tipo di avviso di esempio nell'elenco a discesa Seleziona tipo di esempio .

  4. Selezionare Test.

    Screenshot che mostra una pagina test del gruppo di azioni.

    Il messaggio di posta elettronica seguente viene inviato all'account specificato:

    Screenshot che mostra un messaggio di posta elettronica di esempio inviato dalla pagina Test.

Creare una regola usando il gruppo di azioni

  1. Creare una regola per una delle risorse.

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

  3. Selezionare il gruppo di azioni dall'elenco.

  4. Scegliere Seleziona.

  5. Completare la creazione della regola.

    Screenshot che mostra la scheda Azioni nel riquadro Crea una regola di avviso e nel riquadro Seleziona gruppi di azioni.

Passaggi successivi