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.
- 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.
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.
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. |