Erstellen von Activator-Benachrichtigungen aus einem KQL-Abfrageset

Festlegen einer Benachrichtigung für ein KQL-Abfrageset

1. Öffnen Sie den Arbeitsbereich, der Ihr KQL-Abfrageset enthält.

2. Navigieren Sie zu Ihrem KQL Queryset, und wählen Sie es aus, um es zu öffnen.

3. Führen Sie eine Abfrage aus, die eine Visualisierung zurückgibt.

4. Sobald die Abfrage Ergebnisse zurückgibt, wählen Sie im oberen Menüband Benachrichtigung festlegen aus.

   

Definieren Sie Warnungsbedingungen

Führen Sie im daraufhin angezeigten Bereich " Regel hinzufügen " die folgenden Schritte aus, um Ihre Warnungsbedingungen zu definieren:

1. Geben Sie im Abschnitt "Details " einen Namen für Ihre Aktivatorbenachrichtigungsregel an.

   

2. Legen Sie im Abschnitt "Monitor " eine Zeithäufigkeit für die Ausführung der Abfrage fest. Die Standardeinstellung ist 5 Minuten.

   

3. Geben Sie im Abschnitt "Bedingung " Die Warnungsbedingungen wie folgt an:

   

   • Wenn Ihre Visualisierung keine Dimensionen aufweist, können Sie die Bedingung Bei jedem Ereignis, wenn zum Überwachen von Änderungen im Datenstrom auswählen, indem Sie ein bestimmtes zu überwachendes Feld auswählen.
   • Legen Sie in der Dropdownliste Wenn den auszuwertenden Wert fest.
   • Legen Sie in der Dropdownliste Bedingung die auszuwertende Bedingung fest. Weitere Informationen finden Sie unter Conditions (MSBuild-Bedingungen).
   • Legen Sie im Feld "Vorkommen " fest, wie oft die Bedingung erfüllt werden muss, bevor eine Warnung ausgelöst wird.

4. Wählen Sie im Abschnitt "Aktion " eine der folgenden Aktionen aus:

   • E-Mail-Benachrichtigung senden:

     1. Um die Aktion auswählen, wählen Sie E-Mail senden aus.
     2. Geben Sie für "An" die E-Mail-Adresse des Empfängers ein, oder verwenden Sie die Dropdownliste, um eine Eigenschaft auszuwählen, deren Wert eine E-Mail-Adresse ist. Standardmäßig wird Ihre E-Mail-Adresse hier aufgefüllt.
     3. Geben Sie für "Betreff" den Betreff der E-Mail-Benachrichtigung ein.
     4. Geben Sie für Überschrift die Überschrift der E-Mail-Benachrichtigung ein.
     5. Geben Sie Notizen für die E-Mail-Benachrichtigung ein.

        Hinweis

        Wenn Sie den Betreff, die Überschrift oder Notizen eingeben, können Sie sich auf die Eigenschaften in den Daten beziehen, indem Sie @ eingeben oder die Schaltfläche neben den Textfeldern auswählen. Beispiel: @BikepointID.

     6. Wählen Sie für "Kontext" die Werte aus der Dropdownliste aus, die Sie in die E-Mail-Benachrichtigung aufnehmen möchten.

     

   • Microsoft Teams-Benachrichtigung senden: Sendet eine Microsoft Teams-Nachricht an sich selbst. Sie können den Titel und den Nachrichteninhalt anpassen.

     1. Für Aktion auswählen wählen Sie Teams -->Nachricht an einzelne oder Gruppenchatnachricht oder Kanalbeitrag.
     2. Führen Sie je nach Auswahl eine der folgenden Schritte aus:
        • Wenn Sie die Option "Nachricht an Einzelpersonen " ausgewählt haben, geben Sie E-Mail-Adressen von Empfängern ein, oder verwenden Sie die Dropdownliste, um eine Eigenschaft auszuwählen, deren Wert eine E-Mail-Adresse ist. Wenn die Bedingung erfüllt ist, wird eine E-Mail an bestimmte Personen gesendet.
        • Wenn Sie die Option " Gruppenchatnachricht " ausgewählt haben, wählen Sie in der Dropdownliste einen Gruppenchat aus. Wenn die Bedingung erfüllt ist, wird eine Nachricht in den Gruppenchat gepostet.
        • Wenn Sie die Option "Kanalbeitrag " ausgewählt haben, wählen Sie in den Dropdownlisten ein Team und einen Kanal aus. Wenn die Bedingung erfüllt ist, wird eine Nachricht in den ausgewählten Kanal gepostet.
     3. Geben Sie für Überschrift die Überschrift der Teams-Benachrichtigung ein.
     4. Geben Sie unter Notizen Hinweise zur Teams-Benachrichtigung ein.

        Hinweis

        Wenn Sie den Betreff, die Überschrift oder Notizen eingeben, können Sie sich auf die Eigenschaften in den Daten beziehen, indem Sie @ eingeben oder die Schaltfläche neben den Textfeldern auswählen. Beispiel: @BikepointID.

     5. Wählen Sie für "Kontext" die Werte aus der Dropdownliste aus, die Sie in die Teams-Benachrichtigung aufnehmen möchten.

     

   • Ausführen von Fabric-Aktivitäten: Führen Sie die folgenden Schritte aus, um die Warnung zum Starten einer Fabric-Pipeline, eines Spark-Auftrags oder eines Notizbuchs zu konfigurieren, wenn die Bedingung erfüllt ist:

     1. Wählen Sie für "Auswählen"-Aktion "Pipeline ausführen", "Spark-Auftrag ausführen", "Notizbuch ausführen" oder "Funktion ausführen" (Vorschau) aus.
     2. Um ein Fabric-Element zum Ausführen auszuwählen, wählen Sie das Fabric-Element (Pipeline, Notizbuch, Spark-Auftrag oder Funktion) aus der Liste aus.
     3. Wählen Sie "Parameter hinzufügen" aus, und geben Sie den Namen des Parameters für das Fabric-Element und einen Wert dafür an. Sie können mehrere Parameter hinzufügen. Sie können Parameter aus den Alarmdaten übergeben, indem Sie @ eingeben oder die Schaltfläche neben dem Textfeld auswählen. Beispiel: @BikepointID.

   • Benutzerdefinierte Aktionen: Führen Sie die folgenden Schritte aus, um die Warnung so zu konfigurieren, dass eine benutzerdefinierte Aktion aufgerufen wird, wenn die Bedingung erfüllt ist:

     1. Für "Aktion auswählen" wählen Sie "Benutzerdefinierte Aktion erstellen" aus.

        

     2. Wie im Abschnitt "Aktion" erwähnt, erstellen Sie zuerst die Regel, und führen Sie dann das Setup der benutzerdefinierten Aktion aus, indem Sie die Schritte aus "Benutzerdefinierte Aktionen auslösen" (Power Automate-Flüsse) ausführen.

     3. Nachdem Sie die benutzerdefinierte Aktion erstellt haben, wählen Sie im Definitionsbereich der Regel die benutzerdefinierte Aktion aus, die Sie in der Dropdownliste "Aktion " erstellt haben.

5. Geben Sie unter Speicherort an, wo die Activator-Benachrichtigung gespeichert werden soll. Wählen Sie einen vorhandenen Arbeitsbereich aus, und speichern Sie entweder in einem vorhandenen Activator oder in einem neuen.

   

6. Wählen Sie Erstellen aus, um Ihre Activator-Regel zu erstellen.

Festlegen einer Benachrichtigung für ein KQL-Abfrageset

1. Öffnen Sie den Arbeitsbereich, der Ihr KQL-Abfrageset enthält.
2. Navigieren Sie zu Ihrem KQL Queryset, und wählen Sie es aus, um es zu öffnen.
3. Führen Sie eine -Abfrage aus. Activator überprüft die Ergebnisse dieser Abfrage entsprechend der in einem späteren Schritt festgelegten Häufigkeit und sendet eine Benachrichtigung für jeden Datensatz, der im Resultset zurückgegeben wird. Wenn beispielsweise eine geplante Abfrage fünf Datensätze zurückgibt, sendet Activator fünf Benachrichtigungen.
4. Sobald die Abfrage abgeschlossen ist, wählen Sie im oberen Menüband die Option Benachrichtigung festlegen aus.

Beispiel 1 – Einzelnes Ergebnis, wenn die Anzahl größer als der Schwellenwert ist

Die folgende Abfrage gibt beispielsweise eine Benachrichtigung zurück, wenn in der Tabelle aus den letzten 5 Minuten mehr Datensätze als im Schwellenwert definiert vorhanden sind. Die letzten beiden Zeilen der Abfrage sind Schlüssel, in denen die Anzahl der Datensätze, die den Filtern entsprechen, erstellt wird, und ein Ergebnis wird nur zurückgegeben, wenn die Anzahl größer als der Schwellenwert ist.

SampleTable 
| where ingestion_time() > ago (5min)
// Add any other optional filters
| count 
| where Count > threshold

Beispiel 2 : Erstellen eines einzelnen Ergebnisses mit einem Array mit mehreren Werten

Im folgenden Beispiel gibt die Abfrage eine Benachrichtigung zurück, wenn die Anzahl der Fahrräder in einem beliebigen Stadtviertel über dem angegebenen Schwellenwert liegt. Um eine einzelne Warnung für alle Viertel zu erhalten, für die die Zahl über dem Schwellenwert liegt, wird die Abfrage so erstellt, dass ein einzelner Datensatz (d. h. eine einzelne Warnung) zurückgegeben wird, die mit dem Operator make_list() durchgeführt wird. Informationen zum Bearbeiten der Warnung, die die Liste der Nachbarschaften enthält, die den Schwellenwert erreicht haben, finden Sie unter Optional: Bearbeiten Der Regel im Aktivator.

TableForReflex
| where ingestion_time() > ago (5min)
| summarize NeighborhoodCount = count() by Neighbourhood
| where NeighborhoodCount > threshold
| summarize NeighbourhoodList = make_list(Neighbourhood)

Definieren Sie Warnungsbedingungen

Führen Sie im daraufhin angezeigten Bereich " Regel hinzufügen " die folgenden Schritte aus, um Ihre Warnungsbedingungen zu definieren:

1. Geben Sie im Abschnitt "Details " einen Namen für Ihre Aktivatorbenachrichtigungsregel an.

   

2. Legen Sie im Abschnitt "Monitor " eine Zeithäufigkeit für die Ausführung der Abfrage fest. Die Standardeinstellung ist 5 Minuten.

   

3. Geben Sie im Abschnitt "Bedingung " Die Warnungsbedingungen wie folgt an:

   

   • Wenn Ihre Visualisierung keine Dimensionen aufweist, können Sie die Bedingung Bei jedem Ereignis, wenn zum Überwachen von Änderungen im Datenstrom auswählen, indem Sie ein bestimmtes zu überwachendes Feld auswählen.
   • Legen Sie in der Dropdownliste Wenn den auszuwertenden Wert fest.
   • Legen Sie in der Dropdownliste Bedingung die auszuwertende Bedingung fest. Weitere Informationen finden Sie unter Conditions (MSBuild-Bedingungen).
   • Legen Sie im Feld "Vorkommen " fest, wie oft die Bedingung erfüllt werden muss, bevor eine Warnung ausgelöst wird.

4. Wählen Sie im Abschnitt "Aktion " eine der folgenden Aktionen aus:

   • E-Mail-Benachrichtigung senden:

     1. Um die Aktion auswählen, wählen Sie E-Mail senden aus.
     2. Geben Sie für "An" die E-Mail-Adresse des Empfängers ein, oder verwenden Sie die Dropdownliste, um eine Eigenschaft auszuwählen, deren Wert eine E-Mail-Adresse ist. Standardmäßig wird Ihre E-Mail-Adresse hier aufgefüllt.
     3. Geben Sie für "Betreff" den Betreff der E-Mail-Benachrichtigung ein.
     4. Geben Sie für Überschrift die Überschrift der E-Mail-Benachrichtigung ein.
     5. Geben Sie Notizen für die E-Mail-Benachrichtigung ein.

        Hinweis

        Wenn Sie den Betreff, die Überschrift oder Notizen eingeben, können Sie sich auf die Eigenschaften in den Daten beziehen, indem Sie @ eingeben oder die Schaltfläche neben den Textfeldern auswählen. Beispiel: @BikepointID.

     6. Wählen Sie für "Kontext" die Werte aus der Dropdownliste aus, die Sie in die E-Mail-Benachrichtigung aufnehmen möchten.

     

   • Microsoft Teams-Benachrichtigung senden: Sendet eine Microsoft Teams-Nachricht an sich selbst. Sie können den Titel und den Nachrichteninhalt anpassen.

     1. Für Aktion auswählen wählen Sie Teams -->Nachricht an einzelne oder Gruppenchatnachricht oder Kanalbeitrag.
     2. Führen Sie je nach Auswahl eine der folgenden Schritte aus:
        • Wenn Sie die Option "Nachricht an Einzelpersonen " ausgewählt haben, geben Sie E-Mail-Adressen von Empfängern ein, oder verwenden Sie die Dropdownliste, um eine Eigenschaft auszuwählen, deren Wert eine E-Mail-Adresse ist. Wenn die Bedingung erfüllt ist, wird eine E-Mail an bestimmte Personen gesendet.
        • Wenn Sie die Option " Gruppenchatnachricht " ausgewählt haben, wählen Sie in der Dropdownliste einen Gruppenchat aus. Wenn die Bedingung erfüllt ist, wird eine Nachricht in den Gruppenchat gepostet.
        • Wenn Sie die Option "Kanalbeitrag " ausgewählt haben, wählen Sie in den Dropdownlisten ein Team und einen Kanal aus. Wenn die Bedingung erfüllt ist, wird eine Nachricht in den ausgewählten Kanal gepostet.
     3. Geben Sie für Überschrift die Überschrift der Teams-Benachrichtigung ein.
     4. Geben Sie unter Notizen Hinweise zur Teams-Benachrichtigung ein.

        Hinweis

        Wenn Sie den Betreff, die Überschrift oder Notizen eingeben, können Sie sich auf die Eigenschaften in den Daten beziehen, indem Sie @ eingeben oder die Schaltfläche neben den Textfeldern auswählen. Beispiel: @BikepointID.

     5. Wählen Sie für "Kontext" die Werte aus der Dropdownliste aus, die Sie in die Teams-Benachrichtigung aufnehmen möchten.

     

   • Ausführen von Fabric-Aktivitäten: Führen Sie die folgenden Schritte aus, um die Warnung zum Starten einer Fabric-Pipeline, eines Spark-Auftrags oder eines Notizbuchs zu konfigurieren, wenn die Bedingung erfüllt ist:

     1. Wählen Sie für "Auswählen"-Aktion "Pipeline ausführen", "Spark-Auftrag ausführen", "Notizbuch ausführen" oder "Funktion ausführen" (Vorschau) aus.
     2. Um ein Fabric-Element zum Ausführen auszuwählen, wählen Sie das Fabric-Element (Pipeline, Notizbuch, Spark-Auftrag oder Funktion) aus der Liste aus.
     3. Wählen Sie "Parameter hinzufügen" aus, und geben Sie den Namen des Parameters für das Fabric-Element und einen Wert dafür an. Sie können mehrere Parameter hinzufügen. Sie können Parameter aus den Alarmdaten übergeben, indem Sie @ eingeben oder die Schaltfläche neben dem Textfeld auswählen. Beispiel: @BikepointID.

   • Benutzerdefinierte Aktionen: Führen Sie die folgenden Schritte aus, um die Warnung so zu konfigurieren, dass eine benutzerdefinierte Aktion aufgerufen wird, wenn die Bedingung erfüllt ist:

     1. Für "Aktion auswählen" wählen Sie "Benutzerdefinierte Aktion erstellen" aus.

        

     2. Wie im Abschnitt "Aktion" erwähnt, erstellen Sie zuerst die Regel, und führen Sie dann das Setup der benutzerdefinierten Aktion aus, indem Sie die Schritte aus "Benutzerdefinierte Aktionen auslösen" (Power Automate-Flüsse) ausführen.

     3. Nachdem Sie die benutzerdefinierte Aktion erstellt haben, wählen Sie im Definitionsbereich der Regel die benutzerdefinierte Aktion aus, die Sie in der Dropdownliste "Aktion " erstellt haben.

5. Geben Sie unter Speicherort an, wo die Activator-Benachrichtigung gespeichert werden soll. Wählen Sie einen vorhandenen Arbeitsbereich aus, und speichern Sie entweder in einem vorhandenen Activator oder in einem neuen.

1. Wählen Sie Erstellen aus, um Ihre Activator-Regel zu erstellen.