Självstudie: Aktivera avvikelsemeddelande i Metrics Advisor

Viktigt!

Från och med den 20 september 2023 kommer du inte att kunna skapa nya Metrics Advisor-resurser. Metrics Advisor-tjänsten dras tillbaka den 1 oktober 2026.

I den här självstudien lär du dig att:

• Skapa en krok i Metrics Advisor
• Skicka meddelanden med Azure Logic Apps
• Skicka meddelanden till Microsoft Teams
• Skicka meddelanden via SMTP-server

Förutsättningar

Skapa en Metrics Advisor-resurs

Om du vill utforska funktionerna i Metrics Advisor kan du behöva skapa en Metrics Advisor-resurs i Azure-portalen för att distribuera din Metrics Advisor-instans.

Skapa en krok i Metrics Advisor

En krok i Metrics Advisor är en brygga som gör det möjligt för kunden att prenumerera på måttavvikelser och skicka meddelanden via olika kanaler. Det finns fyra typer av krokar i Metrics Advisor:

• E-postkrok
• Webhook
• Teams-krok
• Azure DevOps-krok

Varje kroktyp motsvarar en specifik kanal som avvikelsen kommer att meddelas via.

Skicka meddelanden med Azure Logic Apps, Teams och SMTP

Logiska appar

Skicka e-postavisering med hjälp av Azure Logic Apps

Det finns två vanliga alternativ för att skicka e-postmeddelanden som stöds i Metrics Advisor. Den ena är att använda webhooks och Azure Logic Apps för att skicka e-postaviseringar, den andra är att konfigurera en SMTP-server och använda den för att skicka e-postaviseringar direkt. Det här avsnittet fokuserar på det första alternativet, vilket är enklare för kunder som inte har någon tillgänglig SMTP-server.

Steg 1: Skapa en webhook i Metrics Advisor

En webhook är startpunkten för all information som är tillgänglig från Metrics Advisor-tjänsten och anropar ett API som tillhandahålls av användaren när en avisering utlöses. Alla aviseringar kan skickas via en webhook.

Välj fliken Krokar i din Metrics Advisor-arbetsyta och välj knappen Skapa krok. Välj en krok typ av webbkrok. Fyll i de obligatoriska parametrarna och välj OK. Detaljerade steg finns i skapa en webhook.

Det finns en extra parameter för slutpunkten som måste fyllas i. Detta kan göras när du har slutfört steg 3 nedan.

Steg 2: Skapa en förbrukningslogikappresurs

I Azure-portalen skapar du en förbrukningslogikappresurs med ett tomt arbetsflöde genom att följa anvisningarna i Skapa ett exempel på arbetsflöde för förbrukningslogikapp. När arbetsflödesdesignern öppnas återgår du till den här självstudien.

Steg 3: Lägg till en utlösare för När en HTTP-begäran tas emot

• Azure Logic Apps använder olika åtgärder för att utlösa arbetsflöden som definieras. I det här användningsfallet använder den utlösaren med namnet När en HTTP-begäran tas emot.

• I dialogrutan för När en HTTP-begäran tas emot väljer du Använd exempelnyttolast för att generera schema.

  

  Kopiera följande JSON-exempel till textrutan och välj Klar.

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

• Välj metoden som POST och välj Spara. Nu kan du se URL:en för din HTTP-begärandeutlösare. Välj kopieringsikonen för att kopiera den och fyll tillbaka den i slutpunkten i steg 1.

  

Steg 4: Lägg till nästa steg med http-åtgärden

Signaler som skickas via webhooken innehåller endast begränsad information som tidsstämpel, alertID, configurationID osv. Detaljerad information måste efterfrågas med hjälp av motringnings-URL:en som anges i signalen. Det här steget är att fråga efter detaljerad aviseringsinformation.

• Välj en metod för GET

• Välj "callBackURL" i listan "Dynamiskt innehåll" i "URI".

• Ange en nyckel för "Innehållstyp" i "Rubriker" och ange värdet "application/json"

• Ange en nyckel för "x-api-key" i "Headers" och hämta detta genom att klicka på fliken API-nycklar på din Metrics Advisor-arbetsyta. Det här steget är att se till att arbetsflödet har tillräcklig behörighet för API-anrop.

  

Steg 5: Lägg till nästa steg i "parsa JSON"

Du måste parsa svaret från API:et för enklare formatering av e-postinnehåll.

Kommentar

Den här självstudien delar bara ett snabbt exempel. Det slutliga e-postformatet måste utformas ytterligare.

• Välj "Brödtext" i listan "Dynamiskt innehåll" i "Innehåll"
• välj Använd exempelnyttolast för att generera schema. Kopiera följande JSON-exempel till textrutan och välj Klar.

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

Steg 6: Lägg till nästa steg för att skapa HTML-tabell

En massa information har returnerats från API-anropet, men beroende på dina scenarier kan inte all information vara användbar. Välj de objekt som du bryr dig om och vill inkludera i aviseringsmeddelandet.

Nedan visas ett exempel på en HTML-tabell som väljer "tidsstämpel", "metricGUID" och "dimension" som ska ingå i aviseringsmeddelandet.

Steg 7: Lägg till det sista steget för att "skicka ett e-postmeddelande"

Det finns flera alternativ för att skicka e-post, både Microsoft-värdbaserade och tredjepartserbjudanden. Kunden kan behöva ha en klientorganisation/ett konto för det valda alternativet. När du till exempel väljer Office 365 Outlook som server. Inloggningsprocessen kommer att pumpas för att skapa anslutning och auktorisering. En API-anslutning upprättas för att använda e-postservern för att skicka aviseringar.

Fyll i innehållet som du vill inkludera i "Brödtext", "Ämne" i e-postmeddelandet och fyll i en e-postadress i "Till".

Teams-kanal

Skicka avvikelsemeddelande via en Microsoft Teams-kanal

I det här avsnittet går vi igenom hur du skickar avvikelsemeddelanden via en Microsoft Teams-kanal. Detta kan hjälpa till att aktivera scenarier där teammedlemmar samarbetar för att analysera avvikelser som identifieras av Metrics Advisor. Arbetsflödet är enkelt att konfigurera och har inte ett stort antal krav.

Steg 1: Lägg till en anslutning för inkommande webhook i Teams-kanalen

• Gå till den Teams-kanal som du vill skicka meddelanden till och välj •••(Fler alternativ).

• I listrutan väljer du "Anslut orer". I den nya dialogrutan söker du efter "Inkommande webhook" och klickar på Lägg till.

  

• Om du inte kan visa alternativet "Anslut orer" kontaktar du teams gruppägare. Välj "Hantera team", välj sedan fliken "Inställningar" längst upp och kontrollera om inställningen Tillåt medlemmar att skapa, uppdatera och ta bort anslutningsappar är markerad.

  

• Ange ett namn för anslutningsappen och du kan också ladda upp en bild för att göra den till avatar. Välj Skapa och sedan läggs den inkommande Webhook-anslutningsappen till i kanalen. En URL genereras längst ned i dialogrutan, välj Kopiera och välj sedan Klar.

  

Steg 2: Skapa en ny "Teams-krok" i Metrics Advisor

• Välj fliken Krokar i det vänstra navigeringsfältet och välj knappen Skapa krok längst upp till höger på sidan.

• Välj kroktyp för "Teams", ange sedan ett namn och klistra in url:en som du kopierade från ovanstående steg.

• Välj Spara.

  

Steg 3: Tillämpa Teams-kroken på en aviseringskonfiguration

Gå och välj en av de dataflöden som du har registrerat. Välj ett mått i flödet och öppna sidan med måttinformation. Du kan skapa en "aviseringskonfiguration" för att prenumerera på avvikelser som identifieras och meddelas via en Teams-kanal.

Välj knappen +och välj den krok som du skapade, fyll i andra fält och välj Spara. Sedan är du inställd på att tillämpa en Teams-krok på en aviseringskonfiguration. Nya avvikelser meddelas via Teams-kanalen.

SMTP-e-post

Skicka e-postavisering genom att konfigurera en SMTP-server

Det här avsnittet delar praxisen att använda en SMTP-server för att skicka e-postaviseringar om avvikelser som identifieras. Kontrollera att du har en användbar SMTP-server och har tillräcklig behörighet för att hämta parametrar som kontonamn och lösenord.

Steg 1: Tilldela ditt konto som rollen Som administratör för Cognitive Services Metrics Advisor

• En användare med administratörs- eller resursgruppsadministratörsbehörighet måste navigera till den Metrics Advisor-resurs som skapades i Azure-portalen och välja fliken Åtkomstkontroll (IAM).
• Välj Lägg till rolltilldelningar.
• Välj rollen "Cognitive Services Metrics Advisor Administrator" (Administratör för Cognitive Services Metrics Advisor) och välj ditt konto som i bilden nedan.
• Välj knappen Spara och sedan har du lagts till som administratör för en Metrics Advisor-resurs. Alla ovanstående åtgärder måste utföras av en prenumerationsadministratör eller resursgruppsadministratör. Det kan ta upp till en minut innan behörigheterna sprids.

Steg 2: Konfigurera SMTP-server i Metrics Advisor-arbetsytan

När du har slutfört stegen ovan och har lagts till som administratör för Metrics Advisor-resursen. Vänta i flera minuter på att behörigheterna ska spridas. Logga sedan in på din Metrics Advisor-arbetsyta. Du bör kunna visa en ny flik med namnet "E-postinställning" i den vänstra navigeringspanelen. Välj den och fortsätt konfigurationen.

Parametrar som ska fyllas i:

• SMTP-servernamn (krävs): Fyll i namnet på SMTP-serverprovidern, de flesta servernamn skrivs i formuläret "smtp.domain.com" eller "mail.domain.com". Ta Office365 som exempel. Det bör anges som "smtp.office365.com".
• SMTP-serverport (krävs): Port 587 är standardporten för SMTP-överföring på den moderna webben. Även om du kan använda andra portar för insändning (mer om dessa härnäst), bör du alltid börja med port 587 som standard och endast använda en annan port om omständigheterna dikterar (som att värden blockerar port 587 av någon anledning).
• E-postsändare(krävs): Det här är det verkliga e-postkontot som tar ansvar för att skicka e-postmeddelanden. Du kan behöva fylla i avsändarens kontonamn och lösenord. Du kan ange ett kvottröskelvärde för det maximala antalet aviseringsmeddelanden som ska skickas inom en minut för ett konto. Du kan ange flera avsändare om det finns risk för att stora mängder aviseringar skickas på en minut, men minst ett konto ska anges.
• Skicka på uppdrag av (valfritt): Om du har flera avsändare konfigurerade, men du vill att aviseringsmeddelanden ska visas som skickade från ett konto. Du kan använda det här fältet för att justera dem. Observera dock att du kan behöva bevilja behörighet till avsändare för att tillåta att e-postmeddelanden skickas för deras konto.
• Standard-CC (valfritt): Ange en standard-e-postadress som ska vara cc'd i alla e-postaviseringar.

Nedan visas ett exempel på en konfigurerad SMTP-server:

Steg 3: Skapa en e-postkrok i Metrics Advisor

När du har konfigurerat en SMTP-server är du inställd på att skapa en "e-postkrok" på fliken Hooks i Metrics Advisor. Mer information om hur du skapar en "e-postkrok" finns i artikeln om aviseringar och följ stegen för att slutföra.

Steg 4: Tillämpa e-postkroken på en aviseringskonfiguration

Gå och välj en av de dataflöden som du har sparat, välj ett mått i flödet och öppna sidan med måttinformation. Du kan skapa en "aviseringskonfiguration" för att prenumerera på de avvikelser som har identifierats och skickats via e-post.

Välj knappen +och välj den krok som du skapade, fyll i andra fält och välj Spara. Nu har du konfigurerat en e-postkrok med en anpassad aviseringskonfiguration och eventuella nya avvikelser eskaleras via kroken med hjälp av SMTP-servern.

Nästa steg

Gå vidare till nästa artikel för att lära dig hur du skapar.

Skriva en giltig fråga