Samouczek: włączanie powiadomienia o anomalii w usłudze Metrics Advisor

Ważne

Od 20 września 2023 r. nie będzie można tworzyć nowych zasobów usługi Metrics Advisor. Usługa Metrics Advisor jest wycofywana 1 października 2026 r.

Z tego samouczka dowiesz się, jak wykonywać następujące czynności:

• Tworzenie haka w usłudze Metrics Advisor
• Wysyłanie powiadomień za pomocą usługi Azure Logic Apps
• Wysyłanie powiadomień do usługi Microsoft Teams
• Wysyłanie powiadomień za pośrednictwem serwera SMTP

Wymagania wstępne

Tworzenie zasobu klasyfikatora metryk

Aby zapoznać się z możliwościami usługi Metrics Advisor, może być konieczne utworzenie zasobu klasyfikatora metryk w witrynie Azure Portal w celu wdrożenia wystąpienia usługi Metrics Advisor.

Tworzenie haka w usłudze Metrics Advisor

Element zaczepienia w usłudze Metrics Advisor to most, który umożliwia klientowi subskrybowanie anomalii metryk i wysyłanie powiadomień za pośrednictwem różnych kanałów. W usłudze Metrics Advisor istnieją cztery typy punktów zaczepienia:

• Punkt zaczepienia wiadomości e-mail
• Webhook
• Punkt zaczepienia w aplikacji Teams
• Punkt zaczepienia usługi Azure DevOps

Każdy typ haka odpowiada określonemu kanałowi, za pomocą którego anomalia zostanie powiadomiona.

Wysyłanie powiadomień za pomocą usług Azure Logic Apps, Teams i SMTP

Logic Apps

Wysyłanie powiadomień e-mail przy użyciu usługi Azure Logic Apps

Istnieją dwie typowe opcje wysyłania powiadomień e-mail obsługiwanych w usłudze Metrics Advisor. Jednym z nich jest użycie elementów webhook i usługi Azure Logic Apps do wysyłania alertów e-mail, a drugi to skonfigurowanie serwera SMTP i użycie go do bezpośredniego wysyłania alertów e-mail. Ta sekcja koncentruje się na pierwszej opcji, która jest łatwiejsza dla klientów, którzy nie mają dostępnego serwera SMTP.

Krok 1. Tworzenie elementu webhook w usłudze Metrics Advisor

Element webhook to punkt wejścia dla wszystkich informacji dostępnych w usłudze Metrics Advisor i wywołuje interfejs API udostępniany przez użytkownika po wyzwoleniu alertu. Wszystkie alerty można wysyłać za pośrednictwem elementu webhook.

Wybierz kartę Haki w obszarze roboczym Metrics Advisor i wybierz przycisk Utwórz punkt zaczepienia . Wybierz typ haka webhook. Wypełnij wymagane parametry i wybierz przycisk OK. Aby uzyskać szczegółowe instrukcje, zobacz tworzenie elementu webhook.

Istnieje jeden dodatkowy parametr punktu końcowego, który należy wypełnić. Można to zrobić po wykonaniu kroku 3 poniżej.

Krok 2. Tworzenie zasobu aplikacji logiki Zużycie

W witrynie Azure Portal utwórz zasób aplikacji logiki Zużycie z pustym przepływem pracy, postępując zgodnie z instrukcjami w temacie Tworzenie przykładowego przepływu pracy aplikacji logiki Zużycie. Po otwarciu projektanta przepływu pracy wróć do tego samouczka.

Krok 3. Dodawanie wyzwalacza po odebraniu żądania HTTP

• Usługa Azure Logic Apps używa różnych akcji do wyzwalania zdefiniowanych przepływów pracy. W tym przypadku użycia jest używany wyzwalacz o nazwie Po odebraniu żądania HTTP.

• W oknie dialogowym Po odebraniu żądania HTTP wybierz pozycję Użyj przykładowego ładunku do wygenerowania schematu.

  

  Skopiuj następujący przykładowy kod JSON do pola tekstowego i wybierz pozycję Gotowe.

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

• Wybierz metodę "POST", a następnie wybierz pozycję Zapisz. Teraz możesz zobaczyć adres URL wyzwalacza żądania HTTP. Wybierz ikonę kopiowania, aby ją skopiować i wypełnij ją z powrotem w punkcie końcowym w kroku 1.

  

Krok 4. Dodawanie następnego kroku przy użyciu akcji "HTTP"

Sygnały wypychane przez element webhook zawierają tylko ograniczone informacje, takie jak sygnatura czasowa, identyfikator alertu, identyfikator konfiguracji itp. Szczegółowe informacje muszą być odpytywane przy użyciu adresu URL wywołania zwrotnego podanego w sygnałie. Ten krok polega na wysyłaniu zapytań dotyczących szczegółowych informacji o alertach.

• Wybierz metodę "GET"

• Wybierz pozycję "callBackURL" z listy "Zawartość dynamiczna" w polu "URI".

• Wprowadź klucz "Content-Type" w nagłówkach i wprowadź wartość "application/json"

• Wprowadź klucz "x-api-key" w obszarze "Nagłówki" i pobierz go, klikając kartę "Klucze interfejsu API" w obszarze roboczym Usługi Metrics Advisor. Ten krok polega na upewnieniu się, że przepływ pracy ma wystarczające uprawnienia do wywołań interfejsu API.

  

Krok 5. Dodawanie następnego kroku do analizy kodu JSON

Aby ułatwić formatowanie zawartości wiadomości e-mail, należy przeanalizować odpowiedź interfejsu API.

Uwaga

Ten samouczek udostępnia tylko szybki przykład. Ostateczny format wiadomości e-mail musi być jeszcze bardziej zaprojektowany.

• Wybierz pozycję "Treść" z listy "Zawartość dynamiczna" w obszarze "Zawartość"
• wybierz pozycję Użyj przykładowego ładunku, aby wygenerować schemat. Skopiuj następujący przykładowy kod JSON do pola tekstowego i wybierz pozycję Gotowe.

{
    "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. Dodawanie następnego kroku w celu utworzenia tabeli HTML

Wiele informacji zostało zwróconych z wywołania interfejsu API, jednak w zależności od scenariuszy nie wszystkie informacje mogą być przydatne. Wybierz elementy, które chcesz uwzględnić w wiadomości e-mail z alertami.

Poniżej znajduje się przykład tabeli HTML, która wybiera znacznik czasu, "metricGUID" i "wymiar", które mają zostać uwzględnione w wiadomości e-mail z alertami.

Krok 7. Dodawanie ostatniego kroku w celu wysłania wiadomości e-mail

Istnieje kilka opcji wysyłania wiadomości e-mail, zarówno hostowanych przez firmę Microsoft, jak i ofert innych firm. Klient może potrzebować dzierżawy/konta dla wybranej opcji. Na przykład podczas wybierania opcji "Office 365 Outlook" jako serwera. Proces logowania zostanie pompowany na potrzeby tworzenia połączenia i autoryzacji. Zostanie nawiązane połączenie interfejsu API w celu wysyłania alertu przy użyciu serwera poczty e-mail.

Wypełnij zawartość, którą chcesz dołączyć do treści, tematu w wiadomości e-mail i wprowadź adres e-mail w polu "Do".

Kanał usługi Teams

Wysyłanie powiadomień o anomalii za pośrednictwem kanału usługi Microsoft Teams

W tej sekcji przedstawiono praktykę wysyłania powiadomień o anomalii za pośrednictwem kanału usługi Microsoft Teams. Może to pomóc w scenariuszach, w których członkowie zespołu współpracują nad analizowaniem anomalii wykrytych przez doradcę metryk. Przepływ pracy jest łatwy do skonfigurowania i nie ma dużej liczby wymagań wstępnych.

Krok 1. Dodawanie łącznika "Przychodzące elementy webhook" do kanału usługi Teams

• Przejdź do kanału usługi Teams, do którego chcesz wysłać powiadomienie, wybierz pozycję "••"(Więcej opcji).

• Z listy rozwijanej wybierz pozycję "Łączniki". W nowym oknie dialogowym wyszukaj ciąg "Przychodzący element webhook" i kliknij pozycję "Dodaj".

  

• Jeśli nie możesz wyświetlić opcji "Łączniki", skontaktuj się z właścicielami grup usługi Teams. Wybierz pozycję "Zarządzaj zespołem", a następnie wybierz kartę "Ustawienia" u góry i sprawdź, czy zaznaczono ustawienie "Zezwalaj członkom na tworzenie, aktualizowanie i usuwanie łączników".

  

• Wprowadź nazwę łącznika i możesz również przekazać obraz, aby go ustawić jako awatar. Wybierz pozycję "Utwórz", a następnie łącznik przychodzącego elementu webhook zostanie pomyślnie dodany do kanału. W dolnej części okna dialogowego zostanie wygenerowany adres URL, wybierz pozycję "Kopiuj", a następnie wybierz pozycję "Gotowe".

  

Krok 2. Tworzenie nowego elementu zaczepienia "Teams" w usłudze Metrics Advisor

• Wybierz kartę "Haki" na lewym pasku nawigacyjnym, a następnie wybierz przycisk "Utwórz punkt zaczepienia" w prawym górnym rogu strony.

• Wybierz typ punktu zaczepienia "Teams", a następnie wprowadź nazwę i wklej adres URL skopiowany z powyższego kroku.

• Wybierz pozycję "Zapisz".

  

Krok 3. Zastosowanie elementu zaczepienia usługi Teams do konfiguracji alertu

Przejdź i wybierz jeden ze źródeł danych, które zostały dołączone. Wybierz metrykę w kanale informacyjnym i otwórz stronę szczegółów metryk. Możesz utworzyć "konfigurację alertów", aby subskrybować anomalie, które są wykrywane i powiadamiane za pośrednictwem kanału usługi Teams.

Wybierz przycisk "+", a następnie wybierz utworzony punkt zaczepienia, wypełnij inne pola i wybierz pozycję "Zapisz". Następnie ustawisz opcję stosowania elementu zaczepienia usługi Teams do konfiguracji alertu. Wszelkie nowe anomalie będą powiadamiane za pośrednictwem kanału usługi Teams.

SMTP E-mail

Wysyłanie powiadomień e-mail przez skonfigurowanie serwera SMTP

W tej sekcji opisano używanie serwera SMTP do wysyłania powiadomień e-mail dotyczących wykrytych anomalii. Upewnij się, że masz dostępny serwer SMTP i masz wystarczające uprawnienia do pobierania parametrów, takich jak nazwa konta i hasło.

Krok 1. Przypisanie konta jako roli "Administrator doradcy metryk usług Cognitive Services"

• Użytkownik z uprawnieniami administratora subskrypcji lub administratora grupy zasobów musi przejść do zasobu Metrics Advisor utworzonego w witrynie Azure Portal i wybrać kartę Kontrola dostępu (IAM).
• Wybierz pozycję "Dodaj przypisania ról".
• Wybierz rolę "Administrator doradcy metryk usług Cognitive Services", wybierz swoje konto, jak na poniższej ilustracji.
• Wybierz przycisk "Zapisz", a następnie został pomyślnie dodany jako administrator zasobu usługi Metrics Advisor. Wszystkie powyższe akcje muszą być wykonywane przez administratora subskrypcji lub administratora grupy zasobów. Propagacja uprawnień może potrwać do jednej minuty.

Krok 2. Konfigurowanie serwera SMTP w obszarze roboczym Usługi Metrics Advisor

Po wykonaniu powyższych kroków i pomyślnym dodaniu go jako administratora zasobu Usługi Metrics Advisor. Poczekaj kilka minut na propagację uprawnień. Następnie zaloguj się do obszaru roboczego Usługi Metrics Advisor, aby wyświetlić nową kartę o nazwie "Ustawienie poczty e-mail" na panelu nawigacyjnym po lewej stronie. Wybierz ją i kontynuuj konfigurację.

Parametry do wypełnienia:

• Nazwa serwera SMTP (wymagana): podaj nazwę dostawcy serwera SMTP, większość nazw serwerów jest zapisywana w postaci "smtp.domain.com" lub "mail.domain.com". Jako przykład należy ustawić usługę Office365 jako "smtp.office365.com".
• Port serwera SMTP (wymagany): port 587 jest domyślnym portem przesyłania protokołu SMTP w nowoczesnej sieci Web. Chociaż możesz użyć innych portów do przesłania (więcej na ten temat dalej), zawsze należy zacząć od portu 587 jako domyślnego i używać tylko innego portu, jeśli okoliczności dyktują (na przykład host blokuje port 587 z jakiegoś powodu).
• Nadawcy wiadomości e-mail (wymagane): jest to prawdziwe konto e-mail, które ponosi odpowiedzialność za wysyłanie wiadomości e-mail. Może być konieczne wypełnienie nazwy konta i hasła nadawcy. Możesz ustawić próg przydziału dla maksymalnej liczby wiadomości e-mail z alertami, które mają być wysyłane w ciągu jednej minuty dla jednego konta. Można ustawić wielu nadawców, jeśli istnieje możliwość wysłania dużej liczby alertów w ciągu jednej minuty, ale należy ustawić co najmniej jedno konto.
• Wyślij w imieniu (opcjonalnie): jeśli masz skonfigurowanych wielu nadawców, ale chcesz, aby wiadomości e-mail z alertami wydawały się być wysyłane z jednego konta. Możesz użyć tego pola, aby je wyrównać. Należy jednak pamiętać, że może być konieczne przyznanie nadawcom uprawnień do zezwalania na wysyłanie wiadomości e-mail w imieniu konta.
• Wartość domyślna CC (opcjonalnie): aby ustawić domyślny adres e-mail, który będzie mieć wartość cc'd we wszystkich alertach e-mail.

Poniżej przedstawiono przykład skonfigurowanego serwera SMTP:

Krok 3. Tworzenie elementu zaczepienia wiadomości e-mail w usłudze Metrics Advisor

Po pomyślnym skonfigurowaniu serwera SMTP należy utworzyć "punkt zaczepienia poczty e-mail" na karcie "Haki" w usłudze Metrics Advisor. Aby uzyskać więcej informacji na temat tworzenia elementu "e-mail hook", zapoznaj się z artykułem dotyczącym alertów i wykonaj kroki do ukończenia.

Krok 4. Zastosowanie elementu zaczepienia wiadomości e-mail do konfiguracji alertu

Przejdź i wybierz jeden ze źródeł danych, które zostały włączone, wybierz metrykę w kanale informacyjnym i otwórz stronę szczegółów metryk. Możesz utworzyć "konfigurację alertów", aby zasubskrybować anomalie, które zostały wykryte i wysłane za pośrednictwem wiadomości e-mail.

Wybierz przycisk "+", a następnie wybierz utworzony punkt zaczepienia, wypełnij inne pola i wybierz pozycję "Zapisz". Teraz pomyślnie skonfigurowano punkt zaczepienia poczty e-mail z niestandardową konfiguracją alertu, a wszystkie nowe anomalie będą eskalowane za pośrednictwem haka przy użyciu serwera SMTP.

Następne kroki

Przejdź do następnego artykułu, aby dowiedzieć się, jak utworzyć.

Pisanie prawidłowego zapytania