Leggere in inglese

Condividi tramite

Personalizzare le notifiche di avviso 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 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:
  • 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 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 il Tipo di piano, selezionare A 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 progettazione App per la logica, selezionare Quando viene ricevuta una richiesta HTTP.

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

  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. (Passaggio 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.
    • 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 Corpo, 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 Ricerca cercare e selezionare Azure Resource Manager>Leggere una risorsa.

    8. 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 Aggiungi contenuto dinamico e quindi selezionare la scheda Espressione. Immettere le stringhe di questa tabella:

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

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

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

    Screenshot che mostra i parametri per la ricezione di una richiesta HTTP.

  1. Nel campo di ricerca, cercare Outlook.

  2. Selezionare Office 365 Outlook.

    Screenshot che mostra la pagina Aggiungi un'azione di progettazione App per la logica con Office 365 Outlook selezionato.

  3. Selezionare Invia un messaggio di posta elettronica (V2) dall'elenco delle 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 presenta una condizione di monitoraggio: Selezionare monitorCondition dall'elenco Contenuto dinamico.
    • Data attivata: 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 dall'elenco Contenuto dinamico.
    • con gravità: selezionare gravità nell'elenco Contenuto dinamico.
    • con condizione: selezionare monitorCondition dall'elenco Contenuto dinamico.

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

  8. Seleziona Salva.

    Screenshot che mostra la scheda Parametri nel riquadro Invia una e-mail.

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

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

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

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

Testare il gruppo di azioni

  1. Selezionare il gruppo di azioni.

  2. Nella sezione App per la logica, selezionare Gruppo di azioni di test (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 dall'elenco a discesa Seleziona tipo di esempio.

  4. Selezionare Verifica.

    Screenshot che mostra la pagina di test con i dettagli del gruppo di azioni.

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

    Screenshot che mostra un messaggio di posta elettronica di esempio inviato dalla pagina di 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. Scegli 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