Esercitazione: Abilitare la notifica anomalie in Advisor metriche

Importante

A partire dal 20 settembre 2023 non sarà possibile creare nuove risorse di Advisor metriche. Il servizio Advisor metriche viene 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 inviare notifiche tramite canali diversi. 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 una notifica tramite posta elettronica usando App per la logica di Azure

Esistono due opzioni comuni per inviare notifiche tramite posta elettronica 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 direttamente avvisi di posta elettronica. 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 dal 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 e selezionare il pulsante Crea 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 che deve essere compilato. Questa operazione può essere eseguita dopo aver completato il passaggio 3 seguente.

Passaggio 2: Creare una risorsa dell'app per la logica a consumo

Nella 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 esempio di flusso di lavoro dell'app per la logica a consumo. Quando viene visualizzata 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 viene ricevuta 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 Salva. Verrò visualizzato l'URL del trigger della richiesta HTTP. Selezionare l'icona di copia per copiarla e ricopiarla nell'endpoint nel passaggio 1.

  

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

I segnali inseriti nel webhook contengono solo informazioni limitate, ad esempio timestamp, alertID, configurationID e così via. È necessario eseguire query dettagliate usando l'URL di callback fornito nel segnale. Questo passaggio consiste nell'eseguire una query sulle informazioni dettagliate sugli avvisi.

• Scegliere un metodo "GET"

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

• Immettere una chiave "Content-Type" in "Headers" (Intestazioni) e immettere il valore "application/json"

• Immettere una chiave "x-api-key" in "Intestazioni" e ottenere questa chiave 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 a "analizza JSON"

È necessario analizzare la risposta dell'API per semplificare la formattazione del contenuto della posta elettronica.

Nota

Questa esercitazione condivide solo un esempio rapido, il formato di posta elettronica finale deve essere ulteriormente progettato.

• Selezionare 'Body' dall'elenco 'Dynamic content' (Contenuto dinamico) in 'Content'
• Selezionare Usa 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 di cui si è interessati e si desidera includere nel messaggio di posta elettronica di avviso.

Di seguito è riportato un esempio di tabella HTML che sceglie 'timestamp', 'metricGUID' e 'dimension' da includere nel messaggio di posta elettronica 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 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 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" nel messaggio di posta elettronica e immettere un indirizzo di posta elettronica in "A".

Canale Teams

Inviare una notifica anomalie tramite un canale di Microsoft Teams

Questa sezione illustra la procedura di invio di notifiche 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 inviare la notifica, selezionare '•••'(Altre opzioni).

• Nell'elenco a discesa selezionare "Connessione ors". Nella nuova finestra di dialogo cercare "Webhook in ingresso" e fare clic su "Aggiungi".

  

• Se non è possibile visualizzare l'opzione "Connessione ors", 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 "Crea", quindi il connettore Webhook in ingresso viene aggiunto correttamente al canale. Nella parte inferiore della finestra di dialogo verrà generato un URL, assicurarsi 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 "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 "Salva".

  

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 "Salva". Si è quindi impostato per l'applicazione di un hook di Teams a una configurazione degli avvisi. Eventuali nuove anomalie verranno notificate tramite il canale Teams.

Posta elettronica SMTP

Inviare una notifica tramite posta elettronica configurando un server SMTP

Questa sezione condividerà la procedura di utilizzo di un server SMTP per inviare notifiche tramite posta elettronica su anomalie rilevate. Assicurarsi di disporre di un server SMTP utilizzabile e disporre di autorizzazioni sufficienti per ottenere parametri come il nome e la password dell'account.

Passaggio 1: Assegnare l'account come ruolo "Advisor metriche di Servizi cognitivi Amministrazione istrator"

• 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'.
• Selezionare un ruolo di "Advisor metriche di Servizi cognitivi Amministrazione istrator", selezionare l'account come nell'immagine seguente.
• Selezionare il pulsante "Salva", quindi è stato aggiunto correttamente come amministratore di una risorsa di Advisor metriche. Tutte le azioni precedenti devono essere eseguite da un amministratore della sottoscrizione o da un 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 precedenti 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, sarà possibile visualizzare una nuova scheda denominata "Impostazione posta elettronica" nel pannello di spostamento 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 determinano (ad esempio, la porta 587 che blocca l'host per qualche motivo).
• Mittenti di posta elettronica obbligatori: questo è l'account di posta elettronica reale che si assume la responsabilità di inviare messaggi di posta elettronica. Potrebbe essere necessario immettere il nome dell'account e la password del mittente. È possibile impostare una soglia di quota per il numero massimo di messaggi di posta elettronica di avviso da inviare entro un minuto per un account. È possibile impostare più mittenti se è possibile 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 i messaggi di posta elettronica di avviso vengano inviati 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 tutti gli avvisi di posta elettronica.

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 messaggi di posta elettronica.

Selezionare il pulsante "+" e scegliere l'hook creato, compilare altri campi e selezionare "Salva". È 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