Udostępnij przez

Tworzenie alertów aktywatora na podstawie zestawu zapytań KQL

W tym artykule wyjaśniono, jak utworzyć alerty Fabric Activator z zapytania KQL. Aktywator Fabric w Microsoft Fabric umożliwia podejmowanie akcji w przypadku wykrycia wzorców lub zdefiniowanych warunków w strumieniach danych. Aby uzyskać więcej informacji, zobacz Co to jest aktywacja.

Aktywacja można skonfigurować tak, aby wyzwalała powiadomienia na podstawie wyników zestawu zapytań KQL w dwóch scenariuszach:

  • Gdy zaplanowane zapytania KQL zwracają wyniki.
  • Kiedy zaplanowane zapytania KQL zwracają wyniki z wizualizacjami spełniającymi określone warunki.

Wysyłaj powiadomienia o alertach do siebie lub do innych osób w organizacji. Powiadomienia do wysłania można skonfigurować za pośrednictwem poczty e-mail lub wiadomości microsoft Teams.

Przykładowe scenariusze

Oto kilka przykładów użycia alertów aktywatora z zapytaniami KQL:

  • Monitorowanie dzienników aplikacji pod kątem błędów: załóżmy, że masz bazę danych KQL przechowującą dzienniki aplikacji. Alert można skonfigurować tak, aby powiadamiał o tym, czy jakiekolwiek rekordy z ostatnich pięciu minut zawierają ciąg authorization error w kolumnie komunikatu .

  • Śledź dostępne rowery w dzielnicach: Wyobraź sobie, że masz dane przesyłane strumieniowo dla dostępnych rowerów w różnych dzielnicach. Utworzysz zapytanie KQL w celu wyświetlenia wykresu kołowego pokazującego liczbę dostępnych rowerów w poszczególnych dzielnicach. Możesz skonfigurować alert, aby powiadomić Cię, gdy liczba dostępnych rowerów w dowolnej okolicy spadnie poniżej określonego progu.

Wymagania wstępne

  • Obszar roboczy z pojemnością obsługiwaną przez Microsoft Fabric.
  • Baza danych KQL z danymi.
  • Zestaw zapytań KQL połączony z bazą danych KQL. Aby uzyskać więcej informacji, zobacz Query data in a KQL queryset (Wykonywanie zapytań w zestawie zapytań KQL).

Ważne

  • Obsługiwane są tylko zapytania dotyczące baz danych KQL w usłudze Eventhouse. Jeśli zestaw zapytań KQL jest połączony z zewnętrznym klastrem usługi Azure Data Explorer, tworzenie alertu nie jest obsługiwane.
  • Wpływ reguły alertu na usługę Eventhouse zależy od złożoności zapytania. Proste zapytania i agregacje są lekkie, a sprzężenia, przekształcenia i sortowanie są bardziej intensywnie obciążane zasobami. Jeśli zapytanie jest uruchamiane co 1 lub 5 minut, efektywnie utrzymuje Eventhouse w trybie zawsze aktywnym. Bez zapytań ani pozyskiwania przez ponad 5 minut usługa Eventhouse może przejść bezczynnie, co zmniejsza koszty. Aby uzyskać więcej informacji, zobacz Eventhouse Uptime (Czas działania usługi Eventhouse).

W poniższych krokach pokazano, jak utworzyć alert dla zapytania, które tworzy wizualizację lub w zapytaniu, które nie tworzy wizualizacji.

Wybierz kartę odpowiadającą żądanemu przepływowi pracy.

Ustawianie alertu w zestawie zapytań KQL

Ważne

Wizualizacje schematu czasowego nie są obsługiwane w tym scenariuszu. Są one obsługiwane w Tworzeniu alertów aktywatora z pulpitu nawigacyjnego Real-Time.

  1. Otwórz obszar roboczy zawierający zestaw zapytań KQL.

  2. Przejdź do zestawu zapytań KQL i wybierz go, aby go otworzyć.

  3. Uruchom zapytanie zwracające wizualizację.

  4. Gdy zapytanie zwróci wyniki, wybierz pozycję Ustaw alert na górnej wstążce.

    Zrzut ekranu przedstawiający przycisk Ustaw alert na górnej wstążce.

Definiowanie warunków alertu

W okienku bocznym Dodawanie reguły, które się pojawi, wykonaj następujące kroki, aby zdefiniować warunki alertu:

  1. W sekcji Szczegóły podaj nazwę reguły alertu aktywatora.

    Zrzut ekranu sekcji Szczegóły w bocznym panelu Dodaj regułę.

  2. W sekcji Monitorowanie ustaw częstotliwość czasu uruchamiania zapytania. Wartość domyślna to 5 minut.

    Zrzut ekranu sekcji Monitora w bocznym panelu Dodawanie reguły.

  3. W sekcji Warunek określ warunki alertu w następujący sposób:

    Zrzut ekranu przedstawiający sekcję 'Warunek' w okienku bocznym 'Dodawanie reguły'.

    • Jeśli wizualizacja nie ma wymiarów, możesz wybrać opcję W każdym zdarzeń, gdy warunek będzie monitorować zmiany w strumieniu danych, wybierając określone pole do monitorowania.
    • Na liście rozwijanej When (Kiedy) ustaw wartość, która ma zostać obliczona.
    • Na liście rozwijanej Warunek ustaw warunek, który ma zostać oceniony. Aby uzyskać więcej informacji, zobacz Warunki.
    • W polu Wystąpienie ustaw liczbę przypadków spełnienia warunku przed wyzwoleniem alertu.

  4. W sekcji Akcja wybierz jedną z następujących akcji:

    • Wyślij powiadomienie e-mail:

      1. W obszarze Wybierz akcję wybierz pozycję Wyślij wiadomość e-mail.
      2. W polu Do wprowadź adres e-mail odbiorcy lub użyj listy rozwijanej, aby wybrać właściwość, której wartością jest adres e-mail. Domyślnie adres e-mail jest wypełniany tutaj.
      3. W polu Temat wprowadź temat powiadomienia e-mail.
      4. W polu Nagłówek wprowadź nagłówek powiadomienia e-mail.
      5. W obszarze Uwagi wprowadź notatki dotyczące powiadomienia e-mail.

        Uwaga / Notatka

        Podczas wprowadzania tematu, nagłówka lub notatek można odwoływać się do właściwości w danych, wpisując @ lub wybierając przycisk obok pól tekstowych. Na przykład @BikepointID.

      6. W polu Kontekst wybierz wartości z listy rozwijanej, którą chcesz uwzględnić w powiadomieniu e-mail.

      Zrzut ekranu przedstawiający sekcję Wyślij powiadomienie e-mail w okienku bocznym Dodaj regułę.

    • Wyślij powiadomienie Microsoft Teams: wysyła wiadomość Microsoft Teams do ciebie samego. Możesz dostosować tytuł i zawartość wiadomości.

      1. W obszarze Wybierz akcję wybierz pozycję Teams; wiadomość do indywidualnych osób lub wiadomość czatu grupowego lub wpis w kanale.
      2. Wykonaj jedną z następujących czynności w zależności od wybranego wyboru:
        • W przypadku wybrania opcji Wiadomość do osób wprowadź adresy e-mail odbiorników lub użyj listy rozwijanej, aby wybrać właściwość, której wartość jest adresem e-mail. Po spełnieniu warunku wiadomość e-mail jest wysyłana do określonych osób.
        • Jeśli wybierzesz opcję Wiadomość na czacie grupowym, wybierz czat grupowy z listy rozwijanej. Po spełnieniu warunku zostanie wysłana wiadomość do czatu grupowego.
        • W przypadku wybrania opcji Wpis w kanale wybierz zespół i kanał z list rozwijanych. Po spełnieniu warunku zostanie wysłana wiadomość do wybranego kanału.
      3. W polu Nagłówek wprowadź nagłówek powiadomienia usługi Teams.
      4. W obszarze Uwagi wprowadź notatki dla powiadomienia Teams.

        Uwaga / Notatka

        Podczas wprowadzania tematu, nagłówka lub notatek można odwoływać się do właściwości w danych, wpisując @ lub wybierając przycisk obok pól tekstowych. Na przykład @BikepointID.

      5. W polu Kontekst wybierz wartości z listy rozwijanej, którą chcesz uwzględnić w powiadomieniu usługi Teams.

      Zrzut ekranu sekcji Wyślij powiadomienie Microsoft Teams w panelu dodawania reguły.

    • Uruchom działania Fabric: aby skonfigurować alert w celu uruchomienia potoku Fabric, zadania Spark lub notesu po spełnieniu odpowiedniego warunku, wykonaj następujące kroki:

      1. W obszarze Wybierz akcję wybierz pozycję Uruchom potok, Uruchom zadanie Spark, Uruchom notatnik lub Uruchom funkcję (wersja preview).
      2. Aby wybrać element Fabric do uruchomienia, wybierz element Fabric (potok, notatnik, zadanie Spark lub funkcja) z listy.
      3. Wybierz opcję Dodaj parametr i określ nazwę parametru dla elementu Fabric oraz jego wartość. Można dodać więcej niż jeden parametr. Parametry można przekazać z danych alertu, wpisując @ lub wybierając przycisk obok pola tekstowego. Na przykład @BikepointID. Zrzut ekranu przedstawiający sekcję Aktywności Fabric w okienku bocznym Dodawanie reguły.

    • Akcje niestandardowe: Aby skonfigurować alert w celu wywołania akcji niestandardowej po spełnieniu warunku, wykonaj następujące kroki:

      1. W obszarze Wybierz akcję wybierz pozycję Utwórz akcję niestandardową.

        Zrzut ekranu przedstawiający sekcję Tworzenie akcji niestandardowej w bocznym panelu Dodawanie reguły.

      2. Jak wspomniano w sekcji Działania, najpierw utwórz regułę, a następnie wykonaj konfigurację akcji niestandardowej, wykonując kroki z sekcji Wyzwalanie akcji niestandardowych (przepływy usługi Power Automate)

      3. Po utworzeniu akcji niestandardowej w okienku Definicja reguły wybierz akcję niestandardową utworzoną z listy rozwijanej Akcja .

  5. W obszarze Zapisz lokalizację określ miejsce zapisania alertu aktywatora. Wybierz istniejący obszar roboczy i zapisz go w istniejącym aktywatorze lub nowym.

    Zrzut ekranu przedstawiający sekcję Lokalizacja zapisu w bocznym panelu Dodaj regułę.

  6. Wybierz pozycję Utwórz , aby utworzyć regułę aktywatora.

Opcjonalnie: Edytuj regułę w aktywatorze

Po zapisaniu aktywatora w okienku bocznym zostanie wyświetlony link do elementu. Wybierz link, aby kontynuować edycję w module Aktywator. Ten krok może być przydatny, jeśli chcesz wykonać jedną z następujących akcji:

  • Dodaj innych adresatów do alertu.
  • Zmień zawartość alertu, aby odzwierciedlić określone dane, które wyzwoliły alert.
  • Zdefiniuj bardziej złożony warunek alertu niż jest to możliwe w okienku Ustawianie alertu.

Aby uzyskać informacje na temat edytowania reguł w aktywatorze, zobacz Create Activator rules (Tworzenie reguł aktywatora).

W samym aktywatorze można również wyświetlić historię wyników zapytania i historię aktywacji reguł. Aby uzyskać więcej informacji, zobacz Tworzenie reguł aktywatora.

Powiązana zawartość

  • Last updated on