Esercitazione: Abilitare la notifica di anomalie in Metrics Advisor

Inviare una notifica tramite posta elettronica usando App per la logica di Azure

Esistono due opzioni comuni per inviare e-mail di notifica supportate in Advisor metriche. Uno consiste nell'usare webhook e App per la logica di Azure per inviare avvisi di posta elettronica, l'altro consiste nel configurare un server SMTP e usarlo per inviare avvisi di posta elettronica direttamente. Questa sezione si concentrerà sulla prima opzione, più semplice per i clienti che non hanno un server SMTP disponibile.

Passaggio 1: creare un webhook in Advisor metriche

Un webhook è il punto di ingresso per tutte le informazioni disponibili nel servizio Advisor metriche e chiama un'API fornita dall'utente quando viene attivato un avviso. Tutti gli avvisi possono essere inviati tramite un webhook.

Selezionare la scheda Hook nell'area di lavoro Advisor metriche, quindi selezionare il pulsante Creare hook. Scegliere un tipo di hook di web hook. Compilare i parametri obbligatori e selezionare OK. Per i passaggi dettagliati, vedere creare un webhook.

È presente un parametro aggiuntivo di Endpoint da compilare. Questa operazione può essere eseguita dopo aver completato il passaggio 3 seguente.

Passaggio 2: creare una risorsa dell'app logica di consumo

Nel portale Azure creare una risorsa dell'app per la logica a consumo con un flusso di lavoro vuoto seguendo le istruzioni riportate in Creare un flusso di lavoro dell'app per la logica a consumo. Quando si vede che si apre la finestra di progettazione del flusso di lavoro, torna a questo tutorial.

Passaggio 3: Aggiungere un trigger di Quando viene ricevuta una richiesta HTTP

• App per la logica di Azure usa varie azioni per attivare flussi di lavoro definiti. Per questo caso d'uso, usa il trigger denominato Quando si riceve una richiesta HTTP.

• Nella finestra di dialogo Alla ricezione di una richiesta HTTP, selezionare Usare il payload di esempio per generare lo schema.

  

  Copiare il codice JSON di esempio seguente nella casella di testo e selezionare Fine.

  {
  "properties": {
      "value": {
          "items": {
              "properties": {
                  "alertInfo": {
                      "properties": {
                          "alertId": {
                              "type": "string"
                          },
                          "anomalyAlertingConfigurationId": {
                              "type": "string"
                          },
                          "createdTime": {
                              "type": "string"
                          },
                          "modifiedTime": {
                              "type": "string"
                          },
                          "timestamp": {
                              "type": "string"
                          }
                      },
                      "type": "object"
                  },
                  "alertType": {
                      "type": "string"
                  },
                  "callBackUrl": {
                      "type": "string"
                  },
                  "hookId": {
                      "type": "string"
                  }
              },
              "required": [
                  "hookId",
                  "alertType",
                  "alertInfo",
                  "callBackUrl"
              ],
              "type": "object"
          },
          "type": "array"
      }
  },
  "type": "object"
   }
  

• Scegliere il metodo "POST" e selezionare Salvare. Verrò visualizzato l'URL del trigger della richiesta HTTP. Selezionare l'icona di copia per copiarlo e riempirlo di nuovo nell'Endpoint del passaggio 1.

  

Passaggio 4: Aggiungere un passaggio successivo usando l'azione "HTTP"

I segnali inseriti nel webhook contengono solo informazioni limitate, come ad esempio timestamp, alertID, configurationID e così via. Le informazioni dettagliate devono essere richieste usando l'URL di callback fornito nel segnale. Questo passaggio consiste nell'eseguire una query per ottenere informazioni dettagliate sugli avvisi.

• Scegliere un metodo "GET"

• Selezionare “callBackURL” dall'elenco “Contenuto dinamico” in “URI”.

• Immettere una chiave "Tipo di contenuto" in "Intestazioni" e immettere il valore "application/json"

• Immettere una chiave "x-api-key" in "Intestazioni" e ottenerla facendo clic sulla scheda "Chiavi API" nell'area di lavoro di Advisor metriche. Questo passaggio consiste nel garantire che il flusso di lavoro disponga di autorizzazioni sufficienti per le chiamate API.

  

Passaggio 5: Aggiungere un passaggio successivo per “analizzare JSON”

È necessario analizzare la risposta dell'API per semplificare la formattazione del contenuto dell’e-mail.

• Selezionare “Body” dall'elenco “Contenuto dinamico” in “Contenuto”
• Selezionare Usare il payload di esempio per generare lo schema. Copiare il codice JSON di esempio seguente nella casella di testo e selezionare Fine.

{
    "properties": {
        "@@nextLink": {},
        "value": {
            "items": {
                "properties": {
                    "properties": {
                        "properties": {
                            "IncidentSeverity": {
                                "type": "string"
                            },
                            "IncidentStatus": {
                                "type": "string"
                            }
                        },
                        "type": "object"
                    },
                    "rootNode": {
                        "properties": {
                            "createdTime": {
                                "type": "string"
                            },
                            "detectConfigGuid": {
                                "type": "string"
                            },
                            "dimensions": {
                                "properties": {
                                },
                                "type": "object"
                            },
                            "metricGuid": {
                                "type": "string"
                            },
                            "modifiedTime": {
                                "type": "string"
                            },
                            "properties": {
                                "properties": {
                                    "AnomalySeverity": {
                                        "type": "string"
                                    },
                                    "ExpectedValue": {}
                                },
                                "type": "object"
                            },
                            "seriesId": {
                                "type": "string"
                            },
                            "timestamp": {
                                "type": "string"
                            },
                            "value": {
                                "type": "number"
                            }
                        },
                        "type": "object"
                    }
                },
                "required": [
                    "rootNode",
                    "properties"
                ],
                "type": "object"
            },
            "type": "array"
        }
    },
    "type": "object"
}

Passaggio 6: Aggiungere un passaggio successivo per “creare una tabella HTML”

Una serie di informazioni è stata restituita dalla chiamata API, tuttavia, a seconda degli scenari, non tutte le informazioni possono essere utili. Scegliere gli elementi a cui si è interessati e che si desidera includere nell’e-mail di avviso.

Di seguito è riportato un esempio di tabella HTML che sceglie “timestamp”, “metricGUID” e “dimension” da includere nell’e-mail di avviso.

Passaggio 7: Aggiungere il passaggio finale per “inviare un messaggio di posta elettronica”

Sono disponibili diverse opzioni per inviare messaggi di posta elettronica, sia offerte ospitate da Microsoft che di terze parti. Il cliente potrebbe aver bisogno di un tenant/account per l'opzione scelta. Ad esempio, quando si sceglie "Office 365 Outlook" come server. Il processo di accesso sarà potenziato per migliorare la connessione e l'autorizzazione. Verrà stabilita una connessione API per usare il server di posta elettronica per inviare un avviso.

Inserisci il contenuto che desideri includere nel "Corpo" e "Oggetto" dell'e-mail e inserisci un indirizzo di posta elettronica nel "Destinatario".

Invia una notifica di anomalia tramite un canale di Microsoft Teams

Questa sezione illustra la procedura di invio di notifiche anomalie tramite un canale Microsoft Teams. Ciò consente di abilitare scenari in cui i membri del team collaborano per l'analisi delle anomalie rilevate da Advisor metriche. Il flusso di lavoro è facile da configurare e non ha un numero elevato di prerequisiti.

Passaggio 1: Aggiungere un connettore "Webhook in ingresso" al canale di Teams

• Passare al canale di Teams a cui si desidera inviare la notifica, selezionare “•••”(Altre opzioni).

• Nell'elenco a discesa selezionare “Connettori”. Nella nuova finestra di dialogo, cercare “Webhook in ingresso” e fare clic su “Aggiungi”.

  

• Se non è possibile visualizzare l'opzione “Connettori”, contattare i proprietari del gruppo di Teams. Selezionare “Gestisci team”, quindi selezionare la scheda “Impostazioni” nella parte superiore e verificare se è selezionata l'impostazione “Consenti ai membri di creare, aggiornare e rimuovere i connettori”.

  

• Immettere un nome per il connettore ed è anche possibile caricare un'immagine per impostarla come avatar. Selezionare “Creare”, quindi il connettore Webhook in ingresso viene aggiunto correttamente al canale. Nella parte inferiore della finestra di dialogo verrà generato un URL, accertarsi di selezionare “Copia”,quindi selezionare “Fine”.

  

Passaggio 2: Creare un nuovo "hook di Teams" in Advisor metriche

• Selezionare la scheda "Hook" nel riquadro sinistro e selezionare il pulsante "Crea hook" in alto a destra della pagina.

• Scegliere il tipo di hook “Teams”, quindi immettere un nome e incollare l'URL copiato dal passaggio precedente.

• Selezionare “Salvare”.

  

Passaggio 3: Applicare l'hook di Teams a una configurazione degli avvisi

Vai a selezionare uno dei feed di dati che hai integrato. Selezionare una metrica all'interno del feed e aprire la pagina dei dettagli delle metriche. È possibile creare una “configurazione di avviso” per sottoscrivere anomalie rilevate e inviare notifiche tramite un canale di Teams.

Selezionare il pulsante “+” e scegliere l'hook creato, compilare altri campi e selezionare “Salvare”. A questo punto sei pronto per applicare un webhook di Teams a una configurazione di avviso. Eventuali nuove anomalie verranno notificate tramite il canale Teams.

Inviare una notifica tramite e-mail configurando un server SMTP

Questa sezione condividerà la procedura di utilizzo di un server SMTP per inviare e-mail di notifica su anomalie rilevate. Accertarsi di disporre di un server SMTP utilizzabile e di autorizzazioni sufficienti per ottenere parametri come il nome e la password dell'account.

Passaggio 1: Assegna il tuo account al ruolo di 'Amministratore Metrics Advisor di Servizi Cognitivi'

• Un utente con privilegi di amministratore della sottoscrizione o amministratore del gruppo di risorse deve passare alla risorsa Advisor metriche creata nel portale di Azure e selezionare la scheda Controllo di accesso (IAM).
• Selezionare “Aggiungi assegnazioni di ruolo”.
• Scegliere il ruolo di "Amministratore di Cognitive Services Metrics Advisor", selezionare il proprio account, come mostrato nell'immagine seguente.
• Selezionare il pulsante “Salvare”: sei stato aggiunto correttamente come amministratore di una risorsa di Advisor metriche. Tutte le azioni di cui sopra devono essere eseguite dall'amministratore della sottoscrizione o dall'amministratore del gruppo di risorse. La propagazione delle autorizzazioni potrebbe richiedere fino a un minuto.

Passaggio 2: Configurare il server SMTP nell'area di lavoro Advisor metriche

Dopo aver completato i passaggi sopra indicati ed essere stato aggiunto correttamente come amministratore della risorsa Metrics Advisor, Attendere alcuni minuti affinché le autorizzazioni vengano propagate. Accedere quindi all'area di lavoro di Advisor metriche, sarà possibile visualizzare una nuova scheda denominata "Impostazione posta elettronica" nel pannello sinistro. Selezionarlo e continuare la configurazione.

Parametri da compilare:

• Nome server SMTP (obbligatorio): immettere il nome del provider del server SMTP, la maggior parte dei nomi dei server viene scritta nel formato “smtp.domain.com” o “mail.domain.com”. Ad esempio, Office365 deve essere impostato come “smtp.office365.com”.
• Porta server SMTP (obbligatoria): la porta 587 è la porta predefinita per l'invio SMTP sul Web moderno. Anche se è possibile usare altre porte per l'invio (più avanti), è consigliabile iniziare sempre con la porta 587 come predefinita e usare una porta diversa solo se le circostanze lo determinano (ad esempio, la porta 587 blocca l'host per qualche motivo).
• Mittente/i di email (obbligatori): questo è l'account e-mail reale che ha la responsabilità di inviare e-mail. Potrebbe essere necessario immettere il nome dell'account e la password del mittente. È possibile impostare una soglia di quota per il numero massimo di e-mail di avviso da inviare entro un minuto per un account. È possibile impostare più mittenti se occorre inviare un volume elevato di avvisi in un minuto, ma è necessario impostare almeno un account.
• Invia per conto di (facoltativo): se sono configurati più mittenti ma si desidera che le e-mail di avviso vengano inviate da un account. È possibile usare questo campo per allinearli. Tuttavia, potrebbe essere necessario concedere l'autorizzazione ai mittenti per consentire l'invio di messaggi di posta elettronica per conto del proprio account.
• CC predefinito (facoltativo): per impostare un indirizzo di posta elettronica predefinito che sarà cc’d in tutte le e-mail di avviso.

Di seguito è riportato un esempio di server SMTP configurato:

Passaggio 3: creare un hook di posta elettronica in Metrics Advisor

Dopo aver configurato correttamente un server SMTP, è possibile creare un “Hook di posta elettronica” nella scheda “Hook” in Advisor metriche. Per ulteriori informazioni sulla creazione di un 'hook email', vedere l’articolo sugli avvisi e seguire i passaggi fino al completamento.

Passaggio 4: applicare l'hook di posta elettronica a una configurazione degli avvisi

Passare e selezionare uno dei feed di dati inseriti, selezionare una metrica all'interno del feed e aprire la pagina dei dettagli delle metriche. È possibile creare una “configurazione di avviso” per sottoscrivere le anomalie rilevate e inviate tramite e-mail.

Selezionare il pulsante “+” e scegliere l'hook creato, compilare altri campi e selezionare “Salvare”. Hai configurato con successo un hook di posta elettronica con un'impostazione di avviso personalizzata e ogni nuova anomalia verrà inoltrata tramite l'hook utilizzando il server SMTP.