Kurz: Povolení oznámení o anomáliích v Advisoru pro metriky

Důležité

Od 20. září 2023 nebudete moct vytvářet nové prostředky Advisoru pro metriky. Služba Metrics Advisor se 1. října 2026 vyřadí z provozu.

V tomto kurzu se naučíte:

• Vytvoření háku v Advisoru pro metriky
• Odesílání oznámení pomocí Azure Logic Apps
• Odesílání oznámení do Microsoft Teams
• Odesílání oznámení přes server SMTP

Požadavky

Vytvoření prostředku Advisoru pro metriky

Pokud chcete prozkoumat možnosti Advisoru pro metriky, možná budete muset vytvořit prostředek Advisoru metrik na webu Azure Portal, abyste mohli nasadit instanci Metrics Advisoru.

Vytvoření háku v Advisoru pro metriky

Hook v Metrics Advisoru je most, který zákazníkům umožňuje přihlásit se k odběru anomálií metrik a odesílat oznámení prostřednictvím různých kanálů. V Advisoru pro metriky existují čtyři typy háků:

• E-mailový háček
• Webhook
• Háček Teams
• Háček Azure DevOps

Každý typ háku odpovídá určitému kanálu, prostřednictvím kterého bude anomálie upozorněna.

Odesílání oznámení pomocí Azure Logic Apps, Teams a SMTP

Logic Apps

Odesílání e-mailových oznámení pomocí Azure Logic Apps

Existují dvě běžné možnosti odesílání e-mailových oznámení, která jsou podporována v Advisoru pro metriky. Jedním z nich je použití webhooků a Azure Logic Apps k odesílání e-mailových upozornění, druhý je nastavit server SMTP a použít ho k přímému odesílání e-mailových upozornění. Tato část se zaměří na první možnost, která je pro zákazníky, kteří nemají dostupný server SMTP, jednodušší.

Krok 1: Vytvoření webhooku v Advisoru pro metriky

Webhook je vstupním bodem všech informací dostupných ze služby Metrics Advisor a při aktivaci výstrahy volá rozhraní API poskytované uživatelem. Všechna upozornění se dají odesílat prostřednictvím webhooku.

V pracovním prostoru Poradce pro metriky vyberte kartu Hooks a vyberte tlačítko Vytvořit háček. Zvolte typ háku webhoku. Vyplňte požadované parametry a vyberte OK. Podrobný postup najdete v tématu vytvoření webhooku.

Je tu ještě jeden další parametr koncového bodu , který je potřeba vyplnit, můžete to udělat po dokončení kroku 3 níže.

Krok 2: Vytvoření prostředku aplikace logiky Consumption

Na webu Azure Portal vytvořte prostředek aplikace logiky Consumption s prázdným pracovním postupem podle pokynů v části Vytvoření ukázkového pracovního postupu aplikace logiky Consumption. Až se otevře návrhář pracovního postupu, vraťte se do tohoto kurzu.

Krok 3: Přidání triggeru při přijetí požadavku HTTP

• Azure Logic Apps používá k aktivaci definovaných pracovních postupů různé akce. V tomto případě použití používá trigger s názvem Při přijetí požadavku HTTP.

• V dialogovém okně Při přijetí požadavku HTTP vyberte Použít ukázkovou datovou část k vygenerování schématu.

  

  Zkopírujte následující ukázkový KÓD JSON do textového pole a vyberte Hotovo.

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

• Zvolte metodu POST a vyberte Uložit. Teď můžete vidět adresu URL triggeru požadavku HTTP. Výběrem ikony kopírování ho zkopírujte a v kroku 1 ho znovu vyplňte do koncového bodu .

  

Krok 4: Přidání dalšího kroku pomocí akce HTTP

Signály, které jsou nabízeny prostřednictvím webhooku, obsahují pouze omezené informace, jako je časové razítko, id výstrahy, id konfigurace atd. Podrobné informace je potřeba dotazovat pomocí adresy URL zpětného volání zadané v signálu. Tento krok slouží k dotazování podrobných informací o upozorněních.

• Volba metody GET

• V seznamu Dynamický obsah v identifikátoru URI vyberte callBackURL.

• Zadejte klíč content-type do záhlaví a zadejte hodnotu application/json.

• Do záhlaví zadejte klíč x-api-key a získejte ho kliknutím na tlačítko Klíče rozhraní API v pracovním prostoru Advisoru pro metriky. Tento krok spočívá v tom, že pracovní postup má dostatečná oprávnění pro volání rozhraní API.

  

Krok 5: Přidání dalšího kroku k analýze JSON

Pro snadnější formátování e-mailového obsahu je potřeba analyzovat odpověď rozhraní API.

Poznámka:

Tento kurz sdílí jenom rychlý příklad, konečný formát e-mailu je potřeba dále navrhnout.

• V seznamu Dynamický obsah v části Obsah vyberte Text.
• Výběr možnosti Použít ukázkovou datovou část k vygenerování schématu Zkopírujte následující ukázkový KÓD JSON do textového pole a vyberte Hotovo.

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

Krok 6: Přidání dalšího kroku k vytvoření tabulky HTML

Z volání rozhraní API se vrátila spousta informací, ale v závislosti na vašich scénářích nemusí být všechny informace užitečné. Zvolte položky, o které vám záleží, a chcete je zahrnout do e-mailu s upozorněním.

Níže je příklad tabulky HTML, která zvolí časové razítko, metricGUID a dimension, které se mají zahrnout do e-mailu s upozorněním.

Krok 7: Přidání posledního kroku k odeslání e-mailu

Existuje několik možností, jak odesílat e-maily, a to jak nabídky Microsoftu hostované, tak nabídky třetích stran. Zákazník může pro zvolenou možnost potřebovat tenanta nebo účet. Když například jako server zvolíte Office 365 Outlook. Proces přihlášení se načerpá pro sestavení připojení a autorizaci. Vytvoří se připojení rozhraní API pro odesílání výstrah pomocí e-mailového serveru.

Vyplňte obsah, který chcete zahrnout do textu, Předmět v e-mailu a vyplňte e-mailovou adresu v části To.

Kanál Teams

Odeslání oznámení o anomálii prostřednictvím kanálu Microsoft Teams

Tato část vám ukáže postup odesílání oznámení anomálií prostřednictvím kanálu Microsoft Teams. To může pomoct povolit scénáře, ve kterých členové týmu spolupracují na analýze anomálií zjištěných advisorem pro metriky. Pracovní postup se snadno konfiguruje a nemá velký počet požadavků.

Krok 1: Přidání konektoru Příchozí webhook do kanálu Teams

• Přejděte na kanál Teams, na který chcete odeslat oznámení, vyberte •••(Další možnosti).

• V rozevíracím seznamu vyberte Konektory. V novém dialogovém okně vyhledejte příchozí webhook a klikněte na Přidat.

  

• Pokud nemůžete zobrazit možnost Konektory, obraťte se na vlastníky skupin Teams. Vyberte Spravovat tým, pak nahoře vyberte kartu Nastavení a zkontrolujte, jestli je zaškrtnuté nastavení Povolit členům vytvářet, aktualizovat a odebírat konektory.

  

• Zadejte název konektoru a můžete také nahrát obrázek, aby byl jako avatar. Vyberte Vytvořit a konektor Příchozí webhook se úspěšně přidá do kanálu. V dolní části dialogového okna se vygeneruje adresa URL, nezapomeňte vybrat Kopírovat a pak vybrat Hotovo.

  

Krok 2: Vytvoření nového háku Teams v Advisoru pro metriky

• V levém navigačním panelu vyberte kartu Hooks a v pravém horním rohu stránky vyberte tlačítko Vytvořit háček.

• Zvolte typ háku Teams, zadejte název a vložte adresu URL, kterou jste zkopírovali z předchozího kroku.

• Vyberte Uložit.

  

Krok 3: Použití háku Teams na konfiguraci upozornění

Přejděte a vyberte jeden z datových kanálů, které jste onboardovali. Vyberte metriku v informačním kanálu a otevřete stránku s podrobnostmi metrik. Můžete vytvořit "konfiguraci upozorňování" pro přihlášení k odběru anomálií, které se detekují a upozorňují prostřednictvím kanálu Teams.

Vyberte tlačítko + a zvolte háček, který jste vytvořili, vyplňte další pole a vyberte Uložit. Pak nastavíte pro použití háku Teams na konfiguraci upozornění. Všechny nové anomálie se budou informovat prostřednictvím kanálu Teams.

SMTP E-mail

Odeslání e-mailového oznámení konfigurací serveru SMTP

V této části se dozvíte, jak používat server SMTP k odesílání e-mailových oznámení o zjištěných anomáliích. Ujistěte se, že máte použitelný server SMTP a máte dostatečná oprávnění k získání parametrů, jako je název účtu a heslo.

Krok 1: Přiřazení účtu jako role Správce poradce pro metriky služeb Cognitive Services

• Uživatel s oprávněními správce předplatného nebo správce skupiny prostředků musí přejít k prostředku Advisoru pro metriky, který byl vytvořen na webu Azure Portal, a vybrat kartu Řízení přístupu (IAM).
• Vyberte Přidat přiřazení rolí.
• Vyberte roli správce Poradce pro metriky služeb Cognitive Services a vyberte svůj účet jako na následujícím obrázku.
• Vyberte tlačítko Uložit a pak jste byli úspěšně přidáni jako správce prostředku Metrics Advisor. Všechny výše uvedené akce musí provést správce předplatného nebo správce skupiny prostředků. Rozšíření oprávnění může trvat až jednu minutu.

Krok 2: Konfigurace serveru SMTP v pracovním prostoru Metrics Advisor

Po dokončení výše uvedených kroků a úspěšné přidání jako správce prostředku Metrics Advisor. Počkejte několik minut, než se oprávnění rozšíří. Pak se přihlaste k pracovnímu prostoru Metrics Advisor, měli byste být schopni zobrazit novou kartu s názvem Nastavení e-mailu na levém navigačním panelu. Vyberte ho a pokračujte v konfiguraci.

Parametry, které se mají vyplnit:

• Název serveru SMTP (povinný): Vyplňte název poskytovatele serveru SMTP, většina názvů serverů se zapisuje ve formátu "smtp.domain.com" nebo "mail.domain.com". Jako příklad vezměte Office365, měl by být nastavený jako "smtp.office365.com".
• Port serveru SMTP (povinný): Port 587 je výchozím portem pro odesílání smtp na moderním webu. I když pro odesílání můžete použít jiné porty (další na těchto dalších), měli byste vždy začít s portem 587 jako výchozím a používat jiný port pouze v případě, že okolnosti diktují (například váš hostitel blokující port 587 z nějakého důvodu).
• Požadované odesílatele e-mailů: Jedná se o skutečný e-mailový účet, který zodpovídá za posílání e-mailů. Možná budete muset vyplnit název účtu a heslo odesílatele. Můžete nastavit prahovou hodnotu kvóty pro maximální počet e-mailů s upozorněními, které se mají odesílat do jedné minuty pro jeden účet. Pokud existuje možnost odeslání velkého objemu upozornění za jednu minutu, můžete nastavit několik odesílatelů, ale měli byste nastavit aspoň jeden účet.
• Odeslat jménem (volitelné): Pokud máte nakonfigurovaných více odesílatelů, ale chcete, aby se e-maily s upozorněními zobrazovaly tak, aby se odesílaly z jednoho účtu. Toto pole můžete použít k zarovnání. Upozorňujeme, že možná budete muset odesílatelům udělit oprávnění, aby mohli odesílat e-maily jménem svého účtu.
• Výchozí kopie (volitelné): Chcete-li nastavit výchozí e-mailovou adresu, která bude ve všech e-mailových upozorněních kopie.

Níže je příklad nakonfigurovaného serveru SMTP:

Krok 3: Vytvoření e-mailového háku v Advisoru pro metriky

Po úspěšné konfiguraci serveru SMTP jste na kartě Hooks v Advisoru pro metriky nastavili vytvoření e-mailového háku. Další informace o vytvoření e-mailového háku najdete v článku o upozorněních a provedení kroků k dokončení.

Krok 4: Použití e-mailového háku na konfiguraci upozornění

Přejděte a vyberte jeden z datových kanálů, které jste na palubě, vyberte metriku v informačním kanálu a otevřete stránku s podrobnostmi metrik. Můžete vytvořit "konfiguraci upozorňování" pro přihlášení k odběru anomálií, které byly zjištěny a odeslány prostřednictvím e-mailů.

Vyberte tlačítko + a zvolte háček, který jste vytvořili, vyplňte další pole a vyberte Uložit. Nyní jste úspěšně nastavili e-mailový háček s vlastní konfigurací upozornění a všechny nové anomálie budou eskalovány prostřednictvím háku pomocí serveru SMTP.

Další kroky

V dalším článku se dozvíte, jak vytvořit.

Zápis platného dotazu