Så här konfigurerar du aviseringar och får meddelanden med en hook

När en avvikelse identifieras av en Metrics Advisor utlöses ett aviseringsmeddelande baserat på aviseringsinställningarna med hjälp av en hook. En aviseringsinställning kan användas med flera identifieringskonfigurationer. Olika parametrar är tillgängliga för att anpassa din aviseringsregel.

Skapa en hook

Metrics Advisor stöder fyra olika typer av hookar: e-post, Teams, webhook och Azure DevOps. Du kan välja den som fungerar för ditt specifika scenario.

E-post hook

Anteckning

Metrics Advisor måste konfigurera e-postinställningarna och ange SMTP-relaterad information i Metrics Advisor innan avvikelseaviseringar kan skickas. Resursgruppsadministratören eller prenumerationsadministratören måste tilldela minst en Cognitive Services Metrics Advisor administratörsroll på fliken Åtkomstkontroll för Metrics Advisor resurs. Läs mer om konfiguration av e-postinställningar.

En e-post hook är kanalen för avvikelseaviseringar som ska skickas till e-postadresser som anges i avsnittet E-post till. Två typer av e-postaviseringar skickas: Datafeed inte tillgängliga aviseringar och incidentrapporter, som innehåller en eller flera avvikelser.

Följande parametrar är tillgängliga för att skapa en e-post-hook:

Parameter Beskrivning
Name Namn på e-post hook
Skicka e-post till E-postadresser att skicka aviseringar till
Extern länk Valfritt fält, som möjliggör en anpassad omdirigering, till exempel för felsökningsanteckningar.
Anpassad rubrik för avvikelseavisering Rubrikmallen ${severity} stöder , , , , , , , , ${alertSettingName} ${datafeedName} ${metricName} ${detectConfigName} ${timestamp} ${topDimension} ${incidentCount} , ${anomalyCount}

När du har valt OK skapas en e-post hook. Du kan använda den i alla aviseringsinställningar för att ta emot aviseringar om avvikelser. Detaljerade steg finns i självstudien om att aktivera avvikelseavisering Metrics Advisor i .

Teams hook

En Teams hook är kanalen där avvikelseaviseringar skickas till en kanal i Microsoft Teams. En Teams hook implementeras via en inkommande webhook-anslutningsapp. Du kan behöva skapa en "inkommande webhook"-anslutningsapp i förväg Teams målkanal och hämta en URL för den. Gå sedan tillbaka till Metrics Advisor arbetsyta.

Välj fliken "Hookar" i det vänstra navigeringsfältet och välj knappen "Skapa hook" längst upp till höger på sidan. Välj hooktyp för "Teams". Följande parametrar anges:

Parameter Beskrivning
Name Namnet på Teams hook
Anslutningsapps-URL Den URL som precis kopierades från anslutningsappen "Incoming webhook" (Inkommande webhook) som skapades Teams målkanalen.

När du har valt OK skapas Teams en hook. Du kan använda den i alla aviseringsinställningar för att meddela avvikelseaviseringar till Teams kanal. Detaljerade steg finns i självstudien om att aktivera avvikelseavisering Metrics Advisor i .

Web Hook

En web hook är en annan meddelandekanal med hjälp av en slutpunkt som tillhandahålls av kunden. Eventuella avvikelser som identifieras i tidsserien meddelas via en web hook. Det finns flera steg för att aktivera en web hook som aviseringsmeddelandekanal i Metrics Advisor.

Steg 1. Aktivera hanterad identitet i din Metrics Advisor resurs

En system tilldelad hanterad identitet är begränsad till en per resurs och är kopplad till den här resursens livscykel. Du kan bevilja behörigheter till den hanterade identiteten med hjälp av rollbaserad åtkomstkontroll i Azure (Azure RBAC). Den hanterade identiteten autentiseras med Azure AD, så du behöver inte lagra några autentiseringsuppgifter i koden.

Gå till Metrics Advisor resurs i Azure Portal och välj "Identitet", aktivera den och sedan aktiverad hanterad identitet.

Steg 2. Skapa en web hook i Metrics Advisor arbetsyta

Logga in på arbetsytan och välj fliken "Hooks" och välj sedan knappen "Skapa hook".

Om du vill skapa en web hook måste du lägga till följande information:

Parameter Beskrivning
Slutpunkt DEN API-adress som ska anropas när en avisering utlöses. MÅSTE vara Https.
Användarnamn/lösenord För autentisering till API-adressen. Lämna den här svart om autentisering inte behövs.
Huvud Anpassade huvuden i API-anropet.
Certifikatidentifierare i Azure Key Vault Om åtkomst till slutpunkten måste autentiseras av ett certifikat ska certifikatet lagras i Azure Key Vaults. Ange identifieraren här.

Anteckning

När en web hook skapas eller ändras anropas slutpunkten som ett test med en tom begärandetext. Ditt API måste returnera en 200 HTTP-kod för att valideringen ska lyckas.

fönstret för skapande av web hook.

  • Request-metoden är POST
  • Timeout 30-tal
  • Försök igen för 5xx-fel, ignorera andra fel. Kommer inte att följa 301/302 omdirigeringsbegäran.
  • Begärandetext:
{
"value": [{
    "hookId": "b0f27e91-28cf-4aa2-aa66-ac0275df14dd",
    "alertType": "Anomaly",
    "alertInfo": {
        "anomalyAlertingConfigurationId": "1bc6052e-9a2a-430b-9cbd-80cd07a78c64",
        "alertId": "172536dbc00",
        "timestamp": "2020-05-27T00:00:00Z",
        "createdTime": "2020-05-29T10:04:45.590Z",
        "modifiedTime": "2020-05-29T10:04:45.590Z"
    },
    "callBackUrl": "https://kensho2-api.azurewebsites.net/alert/anomaly/configurations/1bc6052e-9a2a-430b-9cbd-80cd07a78c64/alerts/172536dbc00/incidents"
}]
}

Steg 3. (valfritt) Lagra certifikatet i Azure Key Vaults och hämta identifierare. Om åtkomst till slutpunkten måste autentiseras av ett certifikat ska certifikatet lagras i Azure Key Vaults.

  • Markera Ange och hämta ett certifikat från Azure Key Vault med hjälp av Azure Portal
  • Klicka på det certifikat som du har lagt till, så kan du kopiera "Certifikat-ID".
  • Välj sedan "Åtkomstprinciper" och "Lägg till åtkomstprincip", bevilja "get"-behörighet för "Nyckelbehörigheter", "Hemlighetsbehörigheter" och "Certifikatbehörigheter". Välj huvudnamn som namn på din Metrics Advisor resurs. Välj knappen "Lägg till" och "Spara" på sidan Åtkomstprinciper.

Steg 4. Ta emot avvikelsemeddelande När ett meddelande skickas via en webhook kan du hämta incidentdata genom att anropa "callBackUrl" i Webhook-begäran. Information om det här API:et:

Genom att använda web hook Azure Logic Apps kan du skicka e-postaviseringar utan att en SMTP-server har konfigurerats. Detaljerade steg finns i självstudien om att aktivera avvikelseavisering Metrics Advisor i .

Azure DevOps

Metrics Advisor också stöd för att automatiskt skapa ett arbetsobjekt i Azure DevOps för att spåra problem/buggar när avvikelser identifieras. Alla aviseringar kan skickas via Azure DevOps-hookar.

Om du vill skapa en Azure DevOps-hook måste du lägga till följande information

Parameter Beskrivning
Name Ett namn på hooken
Organisation Den organisation som din DevOps tillhör
Project Det specifika projektet i DevOps.
Åtkomsttoken En token för autentisering till DevOps.

Anteckning

Du måste bevilja skrivbehörigheter om du vill Metrics Advisor att skapa arbetsobjekt baserat på avvikelseaviseringar. När du har skapat hookar kan du använda dem i någon av dina aviseringsinställningar. Hantera dina hookar på sidan med hook-inställningar.

Lägga till eller redigera aviseringsinställningar

Gå till sidan med måttinformation för att hitta avsnittet Aviseringsinställningar i det nedre vänstra hörnet på sidan med måttinformation. Den visar en lista över alla aviseringsinställningar som gäller för den valda identifieringskonfigurationen. När en ny identifieringskonfiguration skapas finns det ingen aviseringsinställning och inga aviseringar skickas.
Du kan använda ikonerna lägg till, redigera och ta bort för att ändra aviseringsinställningarna.

Menyalternativet Aviseringsinställningar.

Välj knapparna lägg till eller redigera för att få ett fönster där du kan lägga till eller redigera dina aviseringsinställningar.

Lägga till eller redigera aviseringsinställningar

Namn på aviseringsinställning: Namnet på aviseringsinställningen. Det visas i e-postrubriken för aviseringen.

Hooks: Listan över hookar som aviseringar ska skickas till.

Avsnittet som visas i skärmbilden ovan är inställningarna för en identifieringskonfiguration. Du kan ange olika aviseringsinställningar för olika identifieringskonfigurationer. Välj målkonfigurationen med hjälp av den tredje listrutan i det här fönstret.

Filterinställningar

Följande är filterinställningar för en identifieringskonfiguration.

Avisering för har fyra alternativ för att filtrera avvikelser:

  • Avvikelser i alla serier: Alla avvikelser tas med i aviseringen.
  • Avvikelser i seriegruppen: Filtrera serier efter dimensionsvärden. Ange specifika värden för vissa dimensioner. Avvikelser tas bara med i aviseringen när serien matchar det angivna värdet.
  • Avvikelser i favoritserien: Endast serien som markerats som favorit tas med i aviseringen. |
  • Avvikelser i topp N i alla serier: Det här filtret är för att du bara bryr dig om serien vars värde är högst upp N. Metrics Advisor kommer att titta tillbaka över tidigare tidsstämplar och kontrollera om värdena i serien vid dessa tidsstämplar finns i de översta N. Om antalet "i översta n" är större än det angivna antalet inkluderas avvikelsen i en avisering. |

Alternativ för filteravviklighet är ett extra filter med följande alternativ:

  • Allvarlighetsgrad: Avvikelsen inkluderas bara när allvarlighetsgraden för avvikelsen ligger inom det angivna intervallet.
  • Snooze: Stoppa aviseringar tillfälligt för avvikelser vid nästa N punkter (period) när de utlöses i en avisering.
    • snooze-typ: När det här är inställt på Series (Serie) snoozes en utlöst avvikelse endast i dess serie. För Mått kommer en utlöst avvikelse att snooze i alla serier i det här måttet.
    • snooze-nummer: antalet punkter (period) som ska snooze.
    • reset for non-successive(återställ för icke-efterföljande): När en utlöst avvikelse väljs snoozes endast de efterföljande avvikelserna. Om någon av följande datapunkter inte är en avvikelse återställs snooze från den punkten. När den är avmarkerad kommer en utlöst avvikelse att snooze nästa n punkter (period), även om efterföljande datapunkter inte är avvikelser.
  • value (valfritt): Filtrera efter värde. Endast punktvärden som uppfyller villkoret, avvikelse inkluderas. Om du använder motsvarande värde för ett annat mått ska dimensionsnamnen för de två måtten vara konsekventa.

Avvikelser som inte filtreras ut skickas i en avisering.

Lägga till inställningar för flera mått

Välj + Lägg till inställningar för korsmått på sidan med aviseringsinställningar för att lägga till ett till avsnitt.

Operatorväljaren är den logiska relationen för varje avsnitt för att avgöra om de skickar en avisering.

Operator Beskrivning
AND Skicka endast en avisering om en serie matchar varje aviseringsavsnitt, och alla datapunkter är avvikelser. Om måtten har olika dimensionsnamn utlöses aldrig en avisering.
ELLER Skicka aviseringen om minst ett avsnitt innehåller avvikelser.

Operator för flera avsnitt med aviseringsinställningar

Nästa steg