Zelfstudie: Anomaliemeldingen inschakelen in Metrics Advisor

Belangrijk

Vanaf 20 september 2023 kunt u geen nieuwe Metrics Advisor-resources maken. De Metrics Advisor-service wordt op 1 oktober 2026 buiten gebruik gesteld.

In deze zelfstudie leert u het volgende:

• Een hook maken in Metrics Advisor
• Meldingen verzenden met Azure Logic Apps
• Meldingen verzenden naar Microsoft Teams
• Meldingen verzenden via SMTP-server

Vereisten

Een Metrics Advisor-resource maken

Als u de mogelijkheden van Metrics Advisor wilt verkennen, moet u mogelijk een Metrics Advisor-resource maken in Azure Portal om uw Metrics Advisor-exemplaar te implementeren.

Een hook maken in Metrics Advisor

Een hook in Metrics Advisor is een brug waarmee de klant zich kan abonneren op afwijkingen in metrische gegevens en meldingen kan verzenden via verschillende kanalen. Er zijn vier soorten hooks in Metrics Advisor:

• E-mailhook
• Webhook
• Teams-hook
• Azure DevOps-hook

Elk hooktype komt overeen met een specifiek kanaal dat anomalie via een melding wordt ontvangen.

Meldingen verzenden met Azure Logic Apps, Teams en SMTP

Logic-apps

E-mailmeldingen verzenden met behulp van Azure Logic Apps

Er zijn twee algemene opties voor het verzenden van e-mailmeldingen die worden ondersteund in Metrics Advisor. De ene is het gebruik van webhooks en Azure Logic Apps voor het verzenden van e-mailwaarschuwingen, de andere is het instellen van een SMTP-server en het rechtstreeks gebruiken om e-mailwaarschuwingen te verzenden. Deze sectie richt zich op de eerste optie, wat eenvoudiger is voor klanten die geen beschikbare SMTP-server hebben.

Stap 1: Een webhook maken in Metrics Advisor

Een webhook is het toegangspunt voor alle informatie die beschikbaar is in de Metrics Advisor-service en roept een door de gebruiker geleverde API aan wanneer een waarschuwing wordt geactiveerd. Alle waarschuwingen kunnen worden verzonden via een webhook.

Selecteer het tabblad Hooks in uw Metrics Advisor-werkruimte en selecteer de knop Hook maken . Kies een haaktype webhook. Vul de vereiste parameters in en selecteer OK. Raadpleeg een webhook maken voor gedetailleerde stappen.

Er is één extra parameter van Eindpunt die moet worden ingevuld. Dit kan worden gedaan nadat u stap 3 hieronder hebt voltooid.

Stap 2: een logische app-resource voor verbruik maken

Maak in Azure Portal een resource voor een logische app Verbruik met een lege werkstroom door de instructies te volgen in een voorbeeldwerkstroom voor logische verbruiks-apps maken. Wanneer u ziet dat de werkstroomontwerper wordt geopend, gaat u terug naar deze zelfstudie.

Stap 3: Een trigger toevoegen van wanneer een HTTP-aanvraag wordt ontvangen

• Azure Logic Apps maakt gebruik van verschillende acties om werkstromen te activeren die zijn gedefinieerd. Voor deze use case wordt de trigger gebruikt met de naam Wanneer een HTTP-aanvraag wordt ontvangen.

• Selecteer in het dialoogvenster Wanneer een HTTP-aanvraag wordt ontvangen de optie Voorbeeldpayload gebruiken om schema te genereren.

  

  Kopieer de volgende voorbeeld-JSON naar het tekstvak en selecteer Gereed.

  {
  "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"
   }
  

• Kies de methode als 'POST' en selecteer Opslaan. U kunt nu de URL van de HTTP-aanvraagtrigger zien. Selecteer het kopieerpictogram om het te kopiëren en in te vullen in het eindpunt in stap 1.

  

Stap 4: Een volgende stap toevoegen met behulp van de actie HTTP

Signalen die via de webhook worden gepusht, bevatten alleen beperkte informatie, zoals tijdstempel, alertID, configurationID, enzovoort. Gedetailleerde informatie moet worden opgevraagd met behulp van de callback-URL in het signaal. Deze stap bestaat uit het opvragen van gedetailleerde waarschuwingsgegevens.

• Kies een methode van 'GET'

• Selecteer CallBackURL in de lijst Dynamische inhoud in 'URI'.

• Voer een sleutel van 'Content-Type' in 'Headers' in en voer een waarde in van 'application/json'

• Voer een sleutel van 'x-api-key' in 'Headers' in en haal dit op door te klikken op het tabblad API-sleutels in uw Metrics Advisor-werkruimte. Deze stap is om ervoor te zorgen dat de werkstroom voldoende machtigingen heeft voor API-aanroepen.

  

Stap 5: Voeg een volgende stap toe aan 'JSON parseren'

U moet het antwoord van de API parseren voor een eenvoudigere opmaak van e-mailinhoud.

Notitie

In deze zelfstudie wordt alleen een snel voorbeeld gedeeld. De uiteindelijke e-mailindeling moet verder worden ontworpen.

• Hoofdtekst selecteren in de lijst Dynamische inhoud in 'Inhoud'
• selecteer Voorbeeldpayload gebruiken om een schema te genereren. Kopieer de volgende voorbeeld-JSON naar het tekstvak en selecteer Gereed.

{
    "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"
}

Stap 6: Voeg een volgende stap toe om een HTML-tabel te maken

Er is echter veel informatie geretourneerd uit de API-aanroep, maar afhankelijk van uw scenario's kan niet alle informatie nuttig zijn. Kies de items die u belangrijk vindt en wilt opnemen in de waarschuwings-e-mail.

Hieronder ziet u een voorbeeld van een HTML-tabel die kiest voor 'timestamp', 'metricGUID' en 'dimension' die moet worden opgenomen in de waarschuwings-e-mail.

Stap 7: Voeg de laatste stap toe om een e-mailbericht te verzenden

Er zijn verschillende opties voor het verzenden van e-mail, zowel door Microsoft gehoste als externe aanbiedingen. De klant moet mogelijk een tenant/account hebben voor de gekozen optie. Als u bijvoorbeeld Office 365 Outlook als server kiest. Aanmeldingsproces wordt gepompt voor het bouwen van verbinding en autorisatie. Er wordt een API-verbinding tot stand gebracht voor het gebruik van de e-mailserver om een waarschuwing te verzenden.

Vul de inhoud in die u wilt opnemen in 'Hoofdtekst', 'Onderwerp' in het e-mailbericht en vul een e-mailadres in in 'Aan'.

Teams-kanaal

Anomaliemelding verzenden via een Microsoft Teams-kanaal

In deze sectie wordt uitgelegd hoe u anomaliemeldingen verzendt via een Microsoft Teams-kanaal. Dit kan helpen scenario's mogelijk te maken waarbij teamleden samenwerken aan het analyseren van afwijkingen die worden gedetecteerd door Metrics Advisor. De werkstroom is eenvoudig te configureren en heeft geen groot aantal vereisten.

Stap 1: Een connector voor binnenkomende webhook toevoegen aan uw Teams-kanaal

• Navigeer naar het Teams-kanaal waarnaar u een melding wilt verzenden en selecteer •••(Meer opties).

• Selecteer 'Verbinding maken ors' in de vervolgkeuzelijst. Zoek in het nieuwe dialoogvenster naar 'Inkomende webhook' en klik op Toevoegen.

  

• Als u de optie 'Verbinding maken ors' niet kunt bekijken, neemt u contact op met de groepseigenaren van Teams. Selecteer 'Team beheren' en selecteer vervolgens het tabblad 'Instellingen' bovenaan en controleer of de instelling 'Leden toestaan connectors te maken, bij te werken en te verwijderen' is ingeschakeld.

  

• Voer een naam in voor de connector en u kunt ook een afbeelding uploaden om deze als avatar te maken. Selecteer 'Maken' en vervolgens wordt de binnenkomende webhookconnector aan uw kanaal toegevoegd. Er wordt een URL gegenereerd onder aan het dialoogvenster, zorg ervoor dat u 'Kopiëren' selecteert en vervolgens Gereed selecteert.

  

Stap 2: Maak een nieuwe 'Teams-hook' in Metrics Advisor

• Selecteer het tabblad Hooks in de linkernavigatiebalk en selecteer de knop 'Haak maken' rechtsboven op de pagina.

• Kies haaktype 'Teams' en voer vervolgens een naam in en plak de URL die u uit de bovenstaande stap hebt gekopieerd.

• Selecteer Opslaan.

  

Stap 3: De Teams-hook toepassen op een waarschuwingsconfiguratie

Ga en selecteer een van de gegevensfeeds die u hebt ge onboardd. Selecteer een metrische waarde in de feed en open de detailpagina met metrische gegevens. U kunt een waarschuwingsconfiguratie maken om u te abonneren op afwijkingen die worden gedetecteerd en gewaarschuwd via een Teams-kanaal.

Selecteer de knop +en kies de haak die u hebt gemaakt, vul andere velden in en selecteer Opslaan. Vervolgens kunt u een Teams-hook toepassen op een waarschuwingsconfiguratie. Nieuwe afwijkingen worden via het Teams-kanaal op de hoogte gesteld.

SMTP-e-mail

E-mailmelding verzenden door een SMTP-server te configureren

In deze sectie wordt het gebruik van een SMTP-server gedeeld om e-mailmeldingen te verzenden over afwijkingen die worden gedetecteerd. Zorg ervoor dat u een bruikbare SMTP-server hebt en voldoende machtigingen hebt om parameters op te halen, zoals accountnaam en wachtwoord.

Stap 1: Uw account toewijzen als de rol Cognitive Services Metrics Advisor Beheer istrator

• Een gebruiker met de bevoegdheden abonnementsbeheerder of resourcegroepbeheerder moet naar de Metrics Advisor-resource gaan die is gemaakt in Azure Portal en het tabblad Toegangsbeheer (IAM) selecteren.
• Selecteer Roltoewijzingen toevoegen.
• Kies een rol van Cognitive Services Metrics Advisor Beheer istrator, selecteer uw account zoals in de onderstaande afbeelding.
• Selecteer de knop Opslaan en vervolgens bent u toegevoegd als beheerder van een Metrics Advisor-resource. Alle bovenstaande acties moeten worden uitgevoerd door een abonnementsbeheerder of resourcegroepbeheerder. Het kan tot één minuut duren voordat de machtigingen zijn doorgegeven.

Stap 2: SMTP-server configureren in metrics Advisor-werkruimte

Nadat u de bovenstaande stappen hebt voltooid en als beheerder van de Metrics Advisor-resource bent toegevoegd. Wacht enkele minuten totdat de machtigingen zijn doorgegeven. Meld u vervolgens aan bij uw Metrics Advisor-werkruimte. U moet een nieuw tabblad met de naam 'E-mailinstelling' in het linkernavigatievenster kunnen weergeven. Selecteer deze en ga door met de configuratie.

Parameters die moeten worden ingevuld:

• SMTP-servernaam (vereist): vul de naam van uw SMTP-serverprovider in, de meeste servernamen worden geschreven in de notatie 'smtp.domain.com' of 'mail.domain.com'. Neem Office365 als voorbeeld, deze moet worden ingesteld als 'smtp.office365.com'.
• SMTP-serverpoort (vereist): poort 587 is de standaardpoort voor SMTP-verzending op het moderne web. Hoewel u andere poorten kunt gebruiken voor verzending (meer op de volgende poorten), moet u altijd beginnen met poort 587 als standaard en alleen een andere poort gebruiken als omstandigheden dicteren (zoals uw host die poort 587 om een of andere reden blokkeert).
• Afzender(s) van e-mail (vereist): dit is het echte e-mailaccount dat verantwoordelijk is voor het verzenden van e-mailberichten. Mogelijk moet u de accountnaam en het wachtwoord van de afzender invullen. U kunt een quotumdrempel instellen voor het maximum aantal waarschuwingsmails dat binnen één minuut voor één account moet worden verzonden. U kunt meerdere afzenders instellen als er in één minuut grote hoeveelheden waarschuwingen moeten worden verzonden, maar er moet ten minste één account worden ingesteld.
• Verzenden namens (optioneel): Als u meerdere afzenders hebt geconfigureerd, maar u wilt dat e-mailberichten met waarschuwingen vanuit één account worden verzonden. U kunt dit veld gebruiken om ze uit te lijnen. Houd er rekening mee dat u mogelijk toestemming moet verlenen aan de afzenders om het verzenden van e-mailberichten namens hun account toe te staan.
• Standaard CC (optioneel): Als u een standaard-e-mailadres wilt instellen dat cc in alle e-mailwaarschuwingen wordt weergegeven.

Hieronder ziet u een voorbeeld van een geconfigureerde SMTP-server:

Stap 3: Een e-mailhook maken in Metrics Advisor

Nadat u een SMTP-server hebt geconfigureerd, kunt u een 'e-mailhook' maken op het tabblad Hooks in Metrics Advisor. Raadpleeg het artikel over waarschuwingen en volg de stappen voor voltooiing voor meer informatie over het maken van een 'e-mailhook'.

Stap 4: De e-mailhook toepassen op een waarschuwingsconfiguratie

Ga en selecteer een van de gegevensfeeds die u hebt ingevoerd, selecteer een metrische waarde in de feed en open de detailpagina met metrische gegevens. U kunt een waarschuwingsconfiguratie maken om u te abonneren op de afwijkingen die zijn gedetecteerd en verzonden via e-mailberichten.

Selecteer de knop +en kies de haak die u hebt gemaakt, vul andere velden in en selecteer Opslaan. U hebt nu een e-mailhook ingesteld met een aangepaste waarschuwingsconfiguratie en eventuele nieuwe afwijkingen worden geëscaleerd via de hook met behulp van de SMTP-server.

Volgende stappen

Ga naar het volgende artikel voor meer informatie over het maken.

Een geldige query schrijven