Postupy: Konfigurace výstrah a získání oznámení pomocí zavěšení
Po zjištění anomálie nástrojem metriky se aktivuje upozornění na upozornění na základě nastavení výstrah, a to pomocí zavěšení. Nastavení výstrahy se dá použít s několika konfiguracemi detekce, k dispozici jsou různé parametry pro přizpůsobení pravidla upozornění.
Vytvořit zavěšení
poradce pro metriky podporuje čtyři různé typy zavěšení: e-mail, Teams, webhook a Azure DevOps. Můžete zvolit ten, který bude fungovat pro konkrétní scénář.
E-mail háček
Poznámka
Správci prostředků Advisoru musí nakonfigurovat nastavení e-mailu a zadat informace související s protokolem SMTP do poradce metriky, než se můžou výstrahy na anomálii odeslat. Správce skupiny prostředků nebo správce předplatného musí na kartě řízení přístupu v prostředku Advisoru metriky přiřadit alespoň jednu roli správce Poradce pro Cognitive Services metriky . Přečtěte si další informace o konfiguraci nastavení e-mailu.
E-mail Hookem je kanál pro výstrahy anomálií, který se pošle e-mailovým adresám uvedeným v části e-mail . Odesílají se dva typy e-mailů s výstrahami: datový kanál není k dispozici výstrahy a sestavy incidentů, které obsahují jednu nebo více anomálií.
K vytvoření e-mailového zavěšení jsou k dispozici následující parametry:
| Parametr | Popis |
|---|---|
| Název | Název e-mailového zavěšení |
| E-mail na | E-mailové adresy, na které se mají posílat výstrahy |
| Externí odkaz | Volitelné pole, které umožňuje přizpůsobené přesměrování, například při odstraňování poznámek. |
| Název vlastní výstrahy anomálií | Šablona nadpisu podporuje ${severity} , ${alertSettingName} , ${datafeedName} , ${metricName} , ${detectConfigName} , ${timestamp} , ${topDimension} , ${incidentCount} , ${anomalyCount} |
Po výběru OK se vytvoří e-mail s e-mailem. Můžete ji použít v jakémkoli nastavení výstrahy a získat tak výstrahy anomálií. Podrobné pokyny najdete v kurzu Povolení oznámení anomálií v poradci metriky .
Teams vidlice
Teams vidlice je kanál pro výstrahy anomálií, který se odešle do kanálu v Microsoft Teams. Teams vidlice se implementuje prostřednictvím konektoru "příchozího webhooku". možná budete muset vytvořit konektor "příchozí webhook" předem v cílovém Teams kanálu a získat adresu URL. Pak se znovu vraťte do pracovního prostoru poradce metrik.
V levém navigačním panelu vyberte kartu "háky" a v pravém horním rohu stránky vyberte tlačítko vytvořit zavěšení. vyberte typ zavěšení "Teams", jsou zadány následující parametry:
| Parametr | Popis |
|---|---|
| Název | název zavěšení Teams |
| Adresa URL konektoru | adresa URL, která se právě zkopírovala z konektoru příchozího webhooku, který se vytvořil v cílovém kanálu Teams. |
po výběru OK se vytvoří Teams vidlice. můžete ji použít v jakémkoli nastavení výstrahy k upozornění na anomálie na cílovou Teams kanál. Podrobné pokyny najdete v kurzu Povolení oznámení anomálií v poradci metriky .
Webový Hook
Webhook je další kanál oznámení pomocí koncového bodu, který poskytuje zákazník. Jakékoli anomálie zjištěné v časové řadě bude zaslána prostřednictvím webového zavěšení. Je k dispozici několik kroků pro povolení webového zavěšení jako kanálu oznámení výstrah v rámci poradce metrik.
Krok 1. Povolení spravované identity v prostředku Advisoru metrik
Spravovaná identita přiřazená systémem je omezená na jeden prostředek a je vázaná na životní cyklus tohoto prostředku. Pomocí řízení přístupu na základě role Azure (RBAC) můžete udělit oprávnění ke spravované identitě. Spravovaná identita se ověřuje pomocí Azure AD, takže nemusíte ukládat žádné přihlašovací údaje do kódu.
V Azure Portal přejít na prostředek Advisor metriky a vyberte identita, zapněte ji na zapnuto, spravovaná identita je povolená.
Krok 2. Vytvoření webového zavěšení v pracovním prostoru Poradce pro metriky
Přihlaste se k pracovnímu prostoru a vyberte kartu "háky" a pak vyberte tlačítko vytvořit zavěšení.
Chcete-li vytvořit Webhook, budete muset přidat následující informace:
| Parametr | Popis |
|---|---|
| Koncový bod | Adresa rozhraní API, která se má volat při aktivaci výstrahy. Musí být https. |
| Uživatelské jméno a heslo | Pro ověřování na adresu rozhraní API. Tuto černou položku nechte v případě, že není vyžadováno ověřování. |
| Hlavička | Vlastní hlavičky v volání rozhraní API. |
| Identifikátor certifikátu v trezorech klíčů Azure | Pokud je nutné přístup k koncovému bodu ověřit certifikátem, musí být certifikát uložený v trezorech klíčů Azure. Sem zadejte identifikátor. |
Poznámka
Když se vytvoří nebo upraví webový Hook, koncový bod se zavolá jako test s prázdným textem žádosti. Vaše rozhraní API musí vrátit kód HTTP 200, aby bylo možné úspěšně předat ověření.
- Metoda požadavku je post .
- Časový limit 30 s
- Opakovat pro 5xx chybu, ignoruje jinou chybu. Nebude následovat požadavek na přesměrování 301/302.
- Text požadavku:
{
"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"
}]
}
Step3. (volitelné) Uložte si certifikát do trezorů klíčů Azure a získejte podle uvedeného identifikátor, pokud je potřeba, aby byl přístup ke koncovému bodu ověřený certifikátem, musí být certifikát uložený v trezorech klíčů Azure.
- Ověřte nastavení a načtěte certifikát z Azure Key Vault pomocí Azure Portal
- Klikněte na certifikát, který jste přidali, a potom si můžete zkopírovat "identifikátor certifikátu".
- Pak vyberte zásady přístupu a přidat zásadu přístupu, udělte oprávnění k klíčům oprávnění k klíčům, oprávněním ke klíčovým odkazům a oprávněním k certifikátu. Jako název prostředku Advisoru metrik vyberte objekt zabezpečení. Na stránce zásady přístupu vyberte tlačítko Přidat a uložit.
Step4. Obdržení oznámení o anomáliích při vložení oznámení prostřednictvím Webhooku můžete načíst data incidentů voláním "callBackUrl" v žádosti Webhooku. Podrobnosti pro toto rozhraní API:
pomocí webového zavěšení a Azure Logic Apps je možné odeslat e-mailové oznámení bez nakonfigurovaného serveru SMTP. Podrobné pokyny najdete v kurzu Povolení oznámení anomálií v poradci metriky .
Azure DevOps
poradce pro metriky také podporuje automatické vytváření pracovních položek v Azure DevOps ke sledování problémů a chyb, pokud je zjištěna kterákoli anomálie. všechny výstrahy je možné odesílat pomocí Azure DevOpsch zavěšení.
k vytvoření zavěšení Azure DevOps budete muset přidat následující informace:
| Parametr | Popis |
|---|---|
| Název | Název zavěšení |
| Organizace | organizace, do které patří váš DevOps |
| Project | Konkrétní projekt v DevOps. |
| Token přístupu | Token pro ověřování DevOps. |
Poznámka
Musíte udělit oprávnění k zápisu, pokud chcete, aby Poradce pro metriky vytvořil pracovní položky na základě upozornění na anomálie. Po vytvoření se háky můžete použít v libovolném z nastavení výstrah. Spravujte své háky na stránce nastavení zavěšení .
Přidat nebo upravit nastavení výstrah
Přejít na stránku podrobností metriky, kde najdete část Nastavení výstrah v levém dolním rohu stránky s podrobnostmi metrik. Obsahuje seznam všech nastavení výstrah, která se vztahují na vybranou konfiguraci zjišťování. Při vytvoření nové konfigurace detekce není k dispozici žádné nastavení výstrahy a nebudou odeslány žádné výstrahy.
K úpravě nastavení výstrah můžete použít ikony Přidat, Upravit a Odstranit .
Výběrem tlačítek Přidat nebo Upravit zobrazíte okno pro přidání nebo úpravu nastavení výstrah.
Název nastavení výstrahy: název nastavení výstrahy. Zobrazí se v nadpisu e-mailu s výstrahou.
Zavěšení: seznam háčků, na které se mají odesílat výstrahy.
Oddíl označený na snímku obrazovky výše je nastavení pro jednu konfiguraci detekce. Můžete nastavit různá nastavení výstrah pro různé konfigurace detekce. Vyberte cílovou konfiguraci pomocí třetího rozevíracího seznamu v tomto okně.
Nastavení filtru
Níže jsou uvedené nastavení filtru pro jednu konfiguraci detekce.
Výstraha pro má čtyři možnosti pro filtrování anomálií:
- Anomálie ve všech řadách: všechny anomálie budou zahrnuty do výstrahy.
- Anomálie ve skupině řad: filtrovat řady podle hodnot dimenzí. Nastavte konkrétní hodnoty pro některé dimenze. Anomálie budou zahrnuty do výstrahy pouze v případě, že řada odpovídá zadané hodnotě.
- Anomálie v oblíbených řadách: v této výstraze bude obsažena pouze řada označená jako oblíbená. |
- Anomálie v horní části N všech řad: Tento filtr je určen pro případ, že se o řadě nachází pouze v horní části n. Poradce pro metriky bude hledat předchozí časová razítka a zkontrolovat, zda jsou hodnoty řady v těchto časových razítkech v horní části n. Pokud je počet "v horním n" větší než zadané číslo, bude tato anomálie obsažena v upozornění. |
Možnost filtrovat anomálie jsou speciálním filtrem s následujícími možnostmi:
- Závažnost: anomálie bude zahrnutá jenom v případě, že závažnost anomálií spadá do zadaného rozsahu.
- Připomenout: dočasně zastavit výstrahy pro anomálie v dalších N bodech (tečka), když se aktivuje v rámci výstrahy.
- typ odložení: když se nastaví na řady, aktivovaná anomálie odsadí jenom svou řadu. V případě metriky bude jedna aktivovaná anomálií odložit všechny řady v této metrikě.
- číslo odložení: počet bodů (period), které se mají znovu připomenout.
- resetovat po neúspěšné: Pokud je vybraná, aktivovaná anomálie se odsadí jenom u dalších n úspěšných anomálií. Pokud jeden z následujících datových bodů není anomálií, odložení bude od tohoto bodu resetováno. Pokud není vybraná, jedna z aktivovaných anomálií bude připomenout další n bodů (tečka), a to i v případě, že po sobě jdoucí datové body neanomálií.
- hodnota (volitelné): filtrovat podle hodnoty. Budou zahrnuty pouze hodnoty bodů, které splňují podmínku, anomálie. Pokud použijete odpovídající hodnotu jiné metriky, názvy dimenzí obou metrik by měly být konzistentní.
Anomálie, které nejsou filtrovány, se odešlou v upozornění.
Přidat nastavení křížové metriky
Vyberte + Přidat nastavení křížové metriky na stránce nastavení výstrah a přidejte další oddíl.
Selektor operátoru je logický vztah jednotlivých sekcí, aby bylo možné určit, zda odesílají výstrahy.
| Operátor | Popis |
|---|---|
| A | Odeslat výstrahu pouze v případě, že řada odpovídá jednotlivým částem výstrahy a všechny datové body jsou anomálie. Pokud mají metriky různé názvy dimenzí, výstraha se nikdy neaktivuje. |
| NEBO | Odeslat výstrahu, pokud alespoň jedna část obsahuje anomálie. |