Esercitazione: Abilitare la notifica di anomalie in Advisor metriche

Importante

A partire dal 20 settembre 2023 non sarà possibile creare nuove risorse di Advisor metriche. Il servizio Advisor metriche verrà ritirato il 1° ottobre 2026.

In questa esercitazione apprenderai a:

• Creare un hook in Advisor metriche
• Inviare notifiche con App per la logica di Azure
• Inviare notifiche a Microsoft Teams
• Inviare notifiche tramite il server SMTP

Prerequisiti

Creare una risorsa di Advisor metriche

Per esplorare le funzionalità di Advisor metriche, potrebbe essere necessario creare una risorsa di Advisor metriche nella portale di Azure per distribuire l'istanza di Advisor metriche.

Creare un hook in Advisor metriche

Un hook in Advisor metriche è un bridge che consente al cliente di sottoscrivere le anomalie delle metriche e di inviare notifiche tramite diversi canali. Esistono quattro tipi di hook in Advisor metriche:

• Hook di posta elettronica
• Webhook
• Hook di Teams
• Hook di Azure DevOps

Ogni tipo di hook corrisponde a un canale specifico tramite cui verrà notificata un'anomalia.

Inviare notifiche con App per la logica di Azure, Teams e SMTP

App per la logica

Inviare notifiche 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 e-mail di avviso, l'altro consiste nel configurare un server SMTP e usarlo per inviare direttamente e-mail di avviso. 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 per la logica a consumo

Nel portale di 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 di app per la logica a consumo di esempio. Quando si apre la finestra di progettazione del flusso di lavoro, tornare a questa esercitazione.

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 incollarlo nell'endpoint nel 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 "Content-Type" 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.

Nota

Questa esercitazione condivide solo un esempio rapido, il formato di e-mail finale deve essere ulteriormente progettato.

• 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 e-mail, sia come offerte ospitate da Microsoft che da terze parti. Il cliente potrebbe avere un tenant o un account per l'opzione scelta. Ad esempio, quando si sceglie "Office 365 Outlook" come server. Il processo di accesso verrà pompato per la creazione di connessioni e di autorizzazioni. Verrà stabilita una connessione API per usare il server di posta elettronica per inviare un avviso.

Compilare il contenuto che si vuole includere in "Corpo", "Oggetto" nell’e-mail e immettere un indirizzo di posta elettronica in "A".

Canale di Teams

Inviare una notifica di anomalie tramite un canale di Microsoft Teams

Questa sezione illustra la procedura di invio di notifiche di anomalie tramite un canale di 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” nella barra di spostamento a sinistra e selezionare il pulsante “Creare 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

Passare e selezionare uno dei feed di dati di cui è stato eseguito l'onboarding. 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 si è pronti per applicare un hook Teams a una configurazione di avviso. Eventuali nuove anomalie verranno notificate tramite il canale Teams.

Posta elettronica SMTP

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: Assegnare l'account come "Amministratore di Advisor metriche di Servizi cognitivi"

• Un utente con privilegi di amministratore della sottoscrizione o amministratore del gruppo di risorse deve passare alla risorsa di Advisor metriche creata nel portale di Azure e selezionare la scheda Controllo di accesso (IAM).
• Selezionare “Aggiungi assegnazioni di ruolo”.
• Scegliere il ruolo “Amministratore servizi cognitivi di Advisor metriche” e selezionare l'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 di cui sopra ed essere stati aggiunti correttamente come amministratore della risorsa di Advisor metriche, attendere alcuni minuti per la propagazione delle autorizzazioni. Accedere quindi all'area di lavoro Advisor metriche, dove sarà possibile visualizzare una nuova scheda denominata “Impostazioni e-mail” nel pannello di navigazione a sinistra. 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 e-mail (obbligatori): questo è l'account di posta elettronica reale che si assume 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 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 Advisor metriche

Dopo aver configurato correttamente un server SMTP, è possibile creare un “Hook di posta elettronica” nella scheda “Hook” in Advisor metriche. Per altre informazioni sulla creazione di un “Hook di posta elettronica”, vedere l’articolo sugli avvisi e seguire i passaggi per il 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”. È stato configurato correttamente un hook di posta elettronica con una configurazione di avviso personalizzata ed eventuali nuove anomalie verranno inoltrate tramite l'hook usando il server SMTP.

Passaggi successivi

Passare all'articolo successivo per informazioni su come creare.

Scrivere una query valida