Erstellen von Activator-Benachrichtigungen aus einem KQL-Abfrageset in Echtzeitintelligenz

In diesem Artikel wird erläutert, wie Sie Fabric Activator-Benachrichtigungen aus einem KQL-Abfrageset erstellen. Weitere Informationen finden Sie unter Was ist Activator. Sie können Activator auf einem KQL-Abfrageset verwenden, um Benachrichtigungen in zwei Modi auszulösen:

• wenn eine geplante KQL-Abfrage Ergebnisse zurückgibt
• wenn eine geplante KQL-Abfrage Ergebnisse zurückgibt, die eine Visualisierung enthalten und einen definierten Satz von Bedingungen erfüllt.

Senden Sie entweder an sich selbst Benachrichtigungen oder an andere Personen in Ihrer Organisation. Benachrichtigungen können per E-Mail oder Microsoft Teams-Nachricht gesendet werden.

Beispielszenarios

Hier sind einige Möglichkeiten, wie Sie Activator-Benachrichtigungen mit KQL-Abfragen verwenden können:

• Angenommen, Sie haben eine KQL-Datenbank und speichern Anwendungsprotokolle.
  • Sie erhalten eine Benachrichtigung, wenn Datensätze aus den letzten 5 Minuten die Zeichenfolge authorization error in der Spalte Nachricht der Tabelle enthalten.
• In einem anderen Szenario haben Sie Streamingdaten für verfügbare Fahrräder in verschiedenen Stadtvierteln. Es wird eine KQL-Abfrage erstellt, um ein Kreisdiagramm für die Anzahl der verfügbaren Fahrräder pro Stadtviertel zu rendern.
  • Sie erhalten eine Benachrichtigung, wenn die Anzahl der verfügbaren Fahrräder in einem beliebigen Stadtviertel unter eine akzeptable Zahl fällt.

Voraussetzungen

• Ein Arbeitsbereich mit einer Microsoft Fabric-fähigen Kapazität
• Eine KQL-Datenbank mit Daten
• Ein KQL-Abfrageset, das mit der KQL-Datenbank verbunden ist. Weitere Informationen finden Sie unter Abfragen von Daten in einem KQL-Abfrageset.

Wichtig

Es werden nur Abfragen gegen KQL-Datenbanken in einem Eventhouse unterstützt. Wenn Ihr KQL-Abfrageset mit einem externen Azure Data Explorer-Cluster verbunden ist, wird das Erstellen einer Benachrichtigung nicht unterstützt.

Die folgenden Schritte zeigen, wie Sie eine Benachrichtigung für eine Abfrage erstellen, die eine Visualisierung erstellt, oder für eine Abfrage, die keine Visualisierung erstellt.

Wählen Sie die Registerkarte aus, die Ihrem gewünschten Workflow entspricht.

Mit Visualisierung

Festlegen einer Benachrichtigung für ein KQL-Abfrageset

Wichtig

Zeitdiagramm-Visualisierungen werden in diesem Szenario nicht unterstützt. Sie werden in Erstellen von Activator-Benachrichtigungen über ein Echtzeitdashboard unterstützt.

1. Navigieren Sie zu Ihrem KQL-Abfrageset.

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

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

   Die folgende Abfrage basiert beispielsweise auf den Beispieldaten für Fahrräder aus dem Lernprogramm „Echtzeitintelligenz“.

   TutorialTable
   | where Timestamp < ago(5m)
   | summarize NumberOfBikes=sum(No_Bikes) by Neighbourhood
   | render columnchart
   

   Die Abfrage gibt ein Säulendiagramm zurück, das die Anzahl der in jedem Stadtviertel verfügbaren Fahrräder anzeigt, und dieses Diagramm wird verwendet, um Benachrichtigungsbedingungen festzulegen.

Definieren Sie Warnungsbedingungen

1. Legen Sie die Häufigkeit fest, mit der die Abfrage ausgeführt werden soll. Die Standardeinstellung ist 5 Minuten.
2. Geben Sie unter Bedingungen Ihre Benachrichtigungsbedingungen 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.
   • Wenn Ihre Visualisierung Dimensionen enthält, können Sie die Bedingung Bei jedem Ereignis gruppiert nach auswählen, um Änderungen im Datenstrom zu überwachen, indem Sie ein Feld für die Gruppierung auswählen, das die Daten in unterschiedliche Gruppen aufteilt
   • 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 Wert den Wert fest, mit dem verglichen werden soll.
3. Geben Sie unter Aktion an, ob Sie Ihre Benachrichtigung per E-Mail oder Microsoft Teams erhalten wollen. Im Seitenbereich können Sie Benachrichtigungen konfigurieren, die an Sie selbst gesendet werden. Informationen zum Senden von Benachrichtigungen an andere Benutzenden finden Sie unter Optional: Bearbeiten der Regel in Activator.
4. 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.
5. Wählen Sie Erstellen aus, um Ihre Activator-Regel zu erstellen.

Ohne Visualisierung

Festlegen einer Benachrichtigung für ein KQL-Abfrageset

1. Navigieren Sie zu Ihrem KQL-Abfrageset.
2. 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.
3. 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 Benachrichtigung für alle Stadtviertel zu erhalten, in denen die Anzahl über dem Schwellenwert liegt, wird die Abfrage so erstellt, dass ein einzelner Datensatz zurückgegeben wird (d. h. eine einzelne Benachrichtigung). Dazu wird Operator make_list() verwendet. Weitere Informationen dazu, wie sie die Benachrichtigung so zu bearbeiten, dass sie die Liste der Stadtviertel enthält, die den Schwellenwert erreicht haben, finden Sie unter Optional: Bearbeiten der Regel in Activator.

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

Definieren Sie Warnungsbedingungen

Definieren Sie als Nächstes Ihre Warnungsbedingungen. Führen Sie im daraufhin angezeigten Dialogfeld Warnung festlegen die folgenden Schritte aus:

1. Legen Sie die Häufigkeit fest, mit der die Abfrage ausgeführt werden soll. Die Standardeinstellung ist 5 Minuten. Die einzige in diesem Szenario verfügbare Bedingung ist Bei jedem Ereignis, d. h., wenn ein Datensatz zurückgegeben wird, dann ist die Bedingung erfüllt.
2. Geben Sie unter Aktion an, ob Sie Ihre Benachrichtigung per E-Mail oder Microsoft Teams erhalten wollen. Im Seitenbereich können Sie Benachrichtigungen konfigurieren, die an Sie selbst gesendet werden. Informationen zum Senden von Benachrichtigungen an andere Benutzenden finden Sie unter Optional: Bearbeiten der Regel in Activator.
3. 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.
4. Wählen Sie Erstellen aus, um Ihre Activator-Regel zu erstellen.

Optional: Bearbeiten der Regel im Activator

Wenn der Activator gespeichert wird, zeigt der Seitenbereich eine Verknüpfung zu Ihrem Element an. Wählen Sie den Link aus, um in Activator weiter zu bearbeiten. Dieser Schritt kann nützlich sein, wenn Sie eine der folgenden Aktionen durchführen möchten:

• Fügen Sie Ihrer Warnung weitere Empfänger hinzu.
• Ändern Sie den Inhalt der Benachrichtigung so, dass sie die spezifischen Daten widerspiegelt, welche die Benachrichtigung ausgelöst haben.
• Definieren Sie eine komplexere Warnungsbedingung, als im Bereich Warnung festlegen möglich ist.

Informationen zum Bearbeiten von Regeln im Activator finden Sie unter Erstellen von Activator-Regeln.

Im Activator selbst können Sie auch den Verlauf der Abfrageergebnisse und den Verlauf der Regelaktivierungen anzeigen. Weitere Informationen finden Sie unter Erstellen von Activator-Regeln.

Zugehöriger Inhalt

• Abfragen von Daten in einem KQL-Abfrageset
• Erste Schritte mit Activator
• KQL-Kurzübersicht