Oktatóanyag: Anomáliával kapcsolatos értesítések engedélyezése a Metrics Advisorban

Fontos

2023. szeptember 20-tól nem hozhat létre új Metrics Advisor-erőforrásokat. A Metrics Advisor szolgáltatás 2026. október 1-jén megszűnik.

Ebben az oktatóanyagban az alábbiakkal fog megismerkedni:

• Horog létrehozása a Metrics Advisorban
• Értesítések küldése az Azure Logic Appsszel
• Értesítések küldése a Microsoft Teamsnek
• Értesítések küldése SMTP-kiszolgálón keresztül

Előfeltételek

Metrics Advisor-erőforrás létrehozása

A Metrics Advisor képességeinek megismeréséhez előfordulhat, hogy létre kell hoznia egy Metrics Advisor-erőforrást az Azure Portalon a Metrics Advisor-példány üzembe helyezéséhez.

Horog létrehozása a Metrics Advisorban

A Metrics Advisorban található horog egy híd, amely lehetővé teszi az ügyfél számára, hogy feliratkozzon a metrikák rendellenességeire, és értesítéseket küldjön különböző csatornákon keresztül. A Metrics Advisorban négyféle horogtípus létezik:

• E-mail-horog
• Webhook
• Teams-horog
• Azure DevOps-horog

Minden horogtípus egy adott csatornának felel meg, amelyen keresztül értesítést kap az anomáliáról.

Értesítések küldése az Azure Logic Apps, a Teams és az SMTP használatával

Logic Apps

E-mail-értesítés küldése az Azure Logic Apps használatával

A Metrics Advisor által támogatott e-mail-értesítések küldésének két gyakori lehetősége van. Az egyik a webhookok és az Azure Logic Apps használata az e-mail-riasztások küldéséhez, a másik pedig egy SMTP-kiszolgáló beállítása és közvetlen e-mail-riasztások küldése. Ez a szakasz az első lehetőségre összpontosít, amely egyszerűbb azoknak az ügyfeleknek, akik nem rendelkeznek elérhető SMTP-kiszolgálóval.

1. lépés: Webhook létrehozása a Metrics Advisorban

A webhook a Metrics Advisor szolgáltatásból elérhető összes információ belépési pontja, és egy felhasználó által megadott API-t hív meg a riasztás aktiválásakor. Minden riasztás elküldhető webhookon keresztül.

Válassza a Metrics Advisor munkaterület Horgok lapját, majd a Horog létrehozása gombot. Válasszon egy horog típusú webes horogot. Töltse ki a szükséges paramétereket, és válassza az OK gombot. A részletes lépésekért tekintse meg a webhookok létrehozását.

A végpontnak van egy további paramétere, amelyet ki kell tölteni, ezt az alábbi 3. lépés elvégzése után teheti meg.

2. lépés: Használati logikai alkalmazás erőforrásának létrehozása

Az Azure Portalon hozzon létre egy használatalapú logikai alkalmazás erőforrást üres munkafolyamattal a Használati példa logikai alkalmazás munkafolyamat létrehozása című témakör utasításait követve. Amikor megnyílik a munkafolyamat-tervező, térjen vissza ehhez az oktatóanyaghoz.

3. lépés: HTTP-kérés fogadásának eseményindítójának hozzáadása

• Az Azure Logic Apps különböző műveletekkel aktiválja a definiált munkafolyamatokat. Ebben a használati esetben a HTTP-kérés fogadásakor elnevezett eseményindítót használja.

• A HTTP-kérés fogadása párbeszédpanelen válassza a Minta hasznos adat használata séma létrehozásához lehetőséget.

  

  Másolja a következő JSON-mintafájlt a szövegmezőbe, és válassza a Kész lehetőséget.

  {
  "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álassza ki a metódust "POST" néven, és válassza a Mentés lehetőséget. Ekkor megjelenik a HTTP-kérelem eseményindítójának URL-címe. Jelölje ki a másolás ikont, és töltse ki újra az 1. lépés végpontjában .

  

4. lépés: Következő lépés hozzáadása HTTP-művelet használatával

A webhookon keresztül leküldéses jelek csak korlátozott információkat tartalmaznak, például időbélyeget, riasztásazonosítót, configurationID-t stb. A részletes információkat a jelben megadott visszahívási URL-cím használatával kell lekérdezni. Ez a lépés a riasztások részletes adatainak lekérdezése.

• Válasszon egy "GET" metódust

• Válassza a "callBackURL" lehetőséget az "URI" dinamikus tartalom listájából.

• Írja be a "Content-Type" kulcsát a Fejlécek mezőbe, és adjon meg egy "application/json" értéket

• Írja be az "x-api-key" kulcsát a "Fejlécek" mezőbe, és ezt a Metrics Advisor-munkaterület "API-kulcsok" fülére kattintva érheti el. Ez a lépés biztosítja, hogy a munkafolyamat megfelelő engedélyekkel rendelkezzen az API-hívásokhoz.

  

5. lépés: Következő lépés hozzáadása a "JSON elemzéséhez"

Az e-mail-tartalmak egyszerűbb formázásához elemeznie kell az API válaszát.

Feljegyzés

Ez az oktatóanyag csak egy gyors példát oszt meg, a végső e-mail formátumot tovább kell tervezni.

• Válassza a "Törzs" lehetőséget a "Dinamikus tartalom" listából a "Tartalom" listában
• válassza a Minta hasznos adat használata séma létrehozásához lehetőséget. Másolja a következő JSON-mintafájlt a szövegmezőbe, és válassza a Kész lehetőséget.

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

6. lépés: Következő lépés hozzáadása a "HTML-táblázat létrehozásához"

Az API-hívásból egy csomó információ lett visszaadva, azonban a forgatókönyvektől függően nem minden információ lehet hasznos. Válassza ki azokat az elemeket, amelyek érdeklik, és amelyeket fel szeretne venni a riasztási e-mailbe.

Az alábbiakban egy példa látható egy HTML-táblázatra, amely az "időbélyeget", a "metricGUID"-t és a "dimenziót" választja a riasztási e-mailben.

7. lépés: Adja hozzá az utolsó lépést az "e-mail elküldéséhez"

Az e-mailek küldésére számos lehetőség van, mind a Microsoft által üzemeltetett, mind a harmadik féltől származó ajánlatokra. Előfordulhat, hogy az ügyfélnek rendelkeznie kell egy bérlővel/fiókkal a választott lehetőséghez. Ha például az "Office 365 Outlook" kiszolgálót választja. A bejelentkezési folyamat ki lesz pumpálva a kapcsolat és az engedélyezés kiépítéséhez. Létrejön egy API-kapcsolat, amely e-mail-kiszolgálót használ a riasztások küldéséhez.

Töltse ki az e-mailben a "Törzs" és a "Tárgy" szöveghez felvenni kívánt tartalmat, és adjon meg egy e-mail-címet a "Címzett" gombra.

Teams-csatorna

Anomáliáról szóló értesítés küldése Microsoft Teams-csatornán keresztül

Ez a szakasz végigvezeti az anomáliával kapcsolatos értesítések Microsoft Teams-csatornán keresztüli küldésének gyakorlatán. Ez segíthet olyan forgatókönyvek engedélyezésében, amelyekben a csapattagok együttműködnek a Metrics Advisor által észlelt anomáliák elemzésében. A munkafolyamat egyszerűen konfigurálható, és nem rendelkezik sok előfeltételsel.

1. lépés: Bejövő webhook-összekötő hozzáadása a Teams-csatornához

• Lépjen arra a Teams-csatornára, amelyre értesítést szeretne küldeni, válassza a "••"(További lehetőségek) lehetőséget.

• A legördülő listában válassza a "Csatlakozás ors" elemet. Az új párbeszédpanelen keressen rá a "Bejövő webhook" kifejezésre, és kattintson a Hozzáadás gombra.

  

• Ha nem tudja megtekinteni a "Csatlakozás ors" lehetőséget, forduljon a Teams-csoport tulajdonosaihoz. Válassza a "Csapat kezelése", majd a felső "Gépház" fület, és ellenőrizze, hogy be van-e jelölve az "Összekötők létrehozásának, frissítésének és eltávolításának engedélyezése a tagok számára" beállítás.

  

• Adja meg az összekötő nevét, és feltölthet egy képet is, hogy avatarként legyen. Válassza a "Létrehozás" lehetőséget, majd a bejövő webhook-összekötőt sikeresen hozzáadja a csatornához. A párbeszédpanel alján létrejön egy URL-cím, válassza a Másolás lehetőséget, majd válassza a Kész lehetőséget.

  

2. lépés: Új Teams-horog létrehozása a Metrics Advisorban

• Válassza a bal oldali navigációs sáv "Horgok" lapját, majd a lap jobb felső sarkában található "Horog létrehozása" gombot.

• Válassza ki a "Teams" horogtípusát, majd adjon meg egy nevet, és illessze be a fenti lépésből kimásolt URL-címet.

• Válassza a Mentés lehetőséget.

  

3. lépés: A Teams-horog alkalmazása riasztáskonfigurációra

Válassza ki az előkészített adatcsatornák egyikét. Válasszon ki egy metrikát a hírcsatornán belül, és nyissa meg a metrikák részletes oldalát. Létrehozhat egy riasztási konfigurációt, amely feliratkozik az észlelt és a Teams-csatornán keresztül értesített anomáliákra.

Válassza a "+" gombot, és válassza ki a létrehozott horogot, töltse ki a többi mezőt, és válassza a "Mentés" lehetőséget. Ezután be van állítva egy Teams-horog alkalmazása riasztáskonfigurációra. Az új rendellenességeket a Teams csatornán keresztül értesítjük.

SMTP E-mail

E-mail-értesítés küldése SMTP-kiszolgáló konfigurálásával

Ez a szakasz azt a gyakorlatot ismerteti, hogy az SMTP-kiszolgálóval e-mail-értesítéseket küldhet az észlelt rendellenességekről. Győződjön meg arról, hogy rendelkezik használható SMTP-kiszolgálóval, és rendelkezik megfelelő engedéllyel olyan paraméterek lekéréséhez, mint a fióknév és a jelszó.

1. lépés: Fiók hozzárendelése "Cognitive Services Metrics Advisor Rendszergazda istrator" szerepkörként

• Az előfizetés-rendszergazdai vagy erőforráscsoport-rendszergazdai jogosultságokkal rendelkező felhasználóknak az Azure Portalon létrehozott Metrics Advisor-erőforrásra kell navigálniuk, és ki kell választaniuk a Hozzáférés-vezérlés (IAM) lapot.
• Válassza a "Szerepkör-hozzárendelések hozzáadása" lehetőséget.
• Válassza ki a "Cognitive Services Metrics Advisor Rendszergazda istrator" szerepkört, válassza ki a fiókját az alábbi képen látható módon.
• Válassza a Mentés gombot, majd sikeresen hozzáadtuk a Metrics Advisor-erőforrás rendszergazdájaként. A fenti műveleteket egy előfizetési rendszergazdának vagy egy erőforráscsoport-rendszergazdának kell végrehajtania. Az engedélyek propagálása akár egy percet is igénybe vehet.

2. lépés: SMTP-kiszolgáló konfigurálása a Metrics Advisor munkaterületen

Miután elvégezte a fenti lépéseket, és sikeresen hozzá lett adva a Metrics Advisor erőforrás rendszergazdájaként. Várjon néhány percet az engedélyek propagálására. Ezután jelentkezzen be a Metrics Advisor munkaterületre, és a bal oldali navigációs panelen meg tudja tekinteni az "E-mail-beállítás" nevű új lapot. Jelölje ki, és folytassa a konfigurációt.

Kitöltendő paraméterek:

• SMTP-kiszolgáló neve (kötelező): Adja meg az SMTP-kiszolgáló szolgáltatójának nevét, a legtöbb kiszolgálónév "smtp.domain.com" vagy "mail.domain.com" formátumban van megírva. Vegyük példaként az Office365-öt, és azt "smtp.office365.com" értékre kell állítani.
• SMTP-kiszolgáló portja (kötelező): Az 587-ös port az alapértelmezett port az SMTP-küldéshez a modern weben. Bár más portokat is használhat a beküldéshez (ezekről bővebben is olvashat), mindig az 587-as portot kell alapértelmezettként használnia, és csak akkor használjon másik portot, ha a körülmények diktálnak (például a gazdagép valamilyen okból blokkolja az 587-as portot).
• E-mail feladó(k)(kötelező): Ez a valódi e-mail fiók, amely felelősséget vállal az e-mailek küldéséért. Előfordulhat, hogy meg kell adnia a feladó fióknevét és jelszavát. Beállíthat egy kvótaküszöböt az egy fiókhoz egy percen belül küldendő riasztási e-mailek maximális számához. Több feladót is beállíthat, ha egy perc alatt nagy mennyiségű riasztás küldhető, de legalább egy fiókot be kell állítani.
• Küldés (nem kötelező): Ha több feladó van konfigurálva, de szeretné, hogy a riasztási e-mailek egy fiókból legyenek elküldve. Ezzel a mezővel igazíthatja őket. Vegye figyelembe azonban, hogy előfordulhat, hogy engedélyt kell adnia a feladóknak, hogy engedélyezzék az e-mailek küldését a fiókjuk nevében.
• Alapértelmezett másolatot kap (nem kötelező): Alapértelmezett e-mail-cím beállítása, amely minden e-mail-riasztásban másolatot kap.

Az alábbiakban egy példa egy konfigurált SMTP-kiszolgálóra:

3. lépés: E-mail-horog létrehozása a Metrics Advisorban

Miután sikeresen konfigurálta az SMTP-kiszolgálót, létre kell hoznia egy "e-mail horogot" a Metrics Advisor "Hooks" lapján. Az "e-mail-horog" létrehozásáról további információt a riasztásokról szóló cikkben talál, és kövesse a befejezéshez szükséges lépéseket.

4. lépés: Az e-mail-horog alkalmazása riasztási konfigurációra

Válassza ki az egyik beépített adatcsatornát, válasszon ki egy metrikát a hírcsatornán belül, és nyissa meg a metrikák részletes oldalát. Létrehozhat egy riasztási konfigurációt, amely feliratkozik az észlelt és e-mailben küldött anomáliákra.

Válassza a "+" gombot, és válassza ki a létrehozott horogot, töltse ki a többi mezőt, és válassza a "Mentés" lehetőséget. Ezzel sikeresen beállított egy egyéni riasztási konfigurációval rendelkező e-mail-horgot, és a rendszer az SMTP-kiszolgáló használatával eszkalálja az új rendellenességeket a horogon keresztül.

Következő lépések

A következő cikkből megtudhatja, hogyan hozhat létre.

Érvényes lekérdezés írása