Activator-waarschuwingen maken op basis van een KQL-queryset

In dit artikel wordt uitgelegd hoe u Fabric Activator-waarschuwingen maakt op basis van een KQL-queryset. Zie Wat is Activator voor meer informatie. U kunt Activator op een KQL-queryset gebruiken om meldingen in twee modi te activeren:

• wanneer een geplande KQL-query resultaten retourneert
• wanneer een geplande KQL-query resultaten retourneert die een visualisatie bevatten die voldoet aan een gedefinieerde set voorwaarden.

Verzend waarschuwingsmeldingen naar uzelf of naar anderen in uw organisatie. Meldingen kunnen per e-mail of Microsoft Teams-bericht worden verzonden.

Voorbeeldscenario's

Hier volgen enkele manieren waarop u Activator-waarschuwingen kunt gebruiken met KQL-query's:

• Stel dat u een KQL-database hebt en toepassingslogboeken opslaat.
  • U ontvangt een waarschuwing wanneer records uit de afgelopen vijf minuten de tekenreeks bevatten in de kolom van het bericht van de tabel.
• In een ander scenario hebt u streaminggegevens voor beschikbare fietsen in verschillende buurten. Er wordt een KQL-query gemaakt om een cirkeldiagram weer te geven voor het aantal beschikbare fietsen per buurt.
  • U ontvangt een waarschuwing wanneer het aantal beschikbare fietsen in elke buurt onder een acceptabel aantal valt.

Vereisten

• Een werkruimte met een Capaciteit met Microsoft Fabric
• Een KQL-database met gegevens
• Een KQL-queryset die is verbonden met de KQL-database. Zie Querygegevens in een KQL-queryset voor meer informatie.

Belangrijk

Alleen query's op KQL-databases binnen een Eventhouse worden ondersteund. Als uw KQL-queryset is verbonden met een extern Azure Data Explorer-cluster, wordt het maken van een waarschuwing niet ondersteund.

In de volgende stappen ziet u hoe u een waarschuwing maakt voor een query waarmee een visualisatie wordt gemaakt of op een query die geen visualisatie maakt.

Kies het tabblad dat overeenkomt met de gewenste werkstroom.

Met visualisatie

Waarschuwing instellen voor een KQL-queryset

Belangrijk

Visualisaties van tijddiagrammen worden in dit scenario niet ondersteund. Ze worden ondersteund in Activator-waarschuwingen maken vanuit een realtime dashboard.

1. Open de werkruimte die uw KQL-queryset bevat.

2. Blader naar uw KQL-queryset en selecteer deze om te openen.

3. Voer een query uit die een visualisatie retourneert.

4. Zodra de query resultaten retourneert, selecteert u Waarschuwing instellen op het bovenste lint.

   De volgende query is bijvoorbeeld gebaseerd op de voorbeeldgegevens van fietsen uit de zelfstudie Realtime intelligence.

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

   De query retourneert een kolomdiagram met het aantal fietsen dat beschikbaar is in elke buurt. Gebruik deze grafiek om waarschuwingsvoorwaarden in te stellen.

Waarschuwingsvoorwaarden definiëren

1. Stel een tijdsfrequentie in voor hoe vaak de query wordt uitgevoerd. De standaardwaarde is vijf minuten.

2. Geef in voorwaardende waarschuwingsvoorwaarden als volgt op:

   • Als uw visualisatie geen dimensies heeft, kunt u de gebeurtenis Bij elke gebeurtenis selecteren wanneer u de wijzigingen in de gegevensstroom wilt bewaken door een specifiek veld te kiezen dat u wilt bewaken.
   • Als uw visualisatie dimensies bevat, kunt u de voor elke gebeurtenis gegroepeerd op voorwaarde selecteren om wijzigingen in de gegevensstroom te controleren door een veld te selecteren voor groeperen, waarmee de gegevens in afzonderlijke groepen worden verdeeld
   • Stel in de vervolgkeuzelijst Wanneer de waarde in die moet worden geëvalueerd.
   • Stel in de vervolgkeuzelijst Voorwaarde de voorwaarde in die moet worden geëvalueerd. Zie Voorwaarden voor meer informatie.
   • Stel in het veld Waarde de waarde in die u wilt vergelijken.

3. Geef in Actie op of u uw waarschuwing via e-mail of Microsoft Teams wilt ontvangen. In het zijvenster kunt u meldingen configureren die naar uzelf worden verzonden. Als u meldingen naar een andere gebruiker wilt verzenden, raadpleegt u Optioneel: Bewerk uw regel in Activator.

4. Geef op De locatie Opslaan op waar u de Activator-waarschuwing wilt opslaan. Kies een bestaande werkruimte en sla deze op in een bestaande activator of een nieuwe.

5. Selecteer Maken om uw Activator-regel te maken.

   

Zonder visualisatie

Waarschuwing instellen voor een KQL-queryset

1. Open de werkruimte die uw KQL-queryset bevat.
2. Blader naar uw KQL-queryset en selecteer deze om te openen.
3. Voer een query uit. Activator controleert de resultaten van deze query op basis van de tijdsfrequentie die in een latere stap is ingesteld en verzendt een waarschuwing voor elke record die wordt geretourneerd in de resultatenset. Als een geplande query bijvoorbeeld vijf records retourneert, verzendt Activator vijf waarschuwingen.
4. Zodra de query is uitgevoerd, selecteert u Waarschuwing instellen op het bovenste lint.

Voorbeeld 1: Eén resultaat wanneer het aantal groter is dan de drempelwaarde

De volgende query retourneert bijvoorbeeld een waarschuwing als er meer dan drempelwaarderecords in de tabel zijn van de afgelopen 5 minuten. De laatste twee regels van de query zijn sleutel, waarbij het aantal records dat overeenkomt met de filters wordt gemaakt, en een resultaat wordt alleen geretourneerd als het aantal groter is dan de drempelwaarde.

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

Voorbeeld 2: een enkel resultaat maken met een matrix met verschillende waarden

In het volgende voorbeeld retourneert de query een waarschuwing als het aantal fietsen in een buurt boven de opgegeven drempelwaarde ligt. Als u één waarschuwing wilt ontvangen voor alle buurten waarvoor het getal boven de drempelwaarde ligt, wordt de query gebouwd om één record te retourneren (wat betekent één waarschuwing). Dit wordt gedaan met behulp van de operator make_list() Om de waarschuwing te bewerken zodat deze de lijst bevat met de buurten die de drempelwaarde hebben bereikt, raadpleegt u Optioneel: Uw regel bewerken in Activator.

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

Waarschuwingsvoorwaarden definiëren

Definieer vervolgens uw waarschuwingsvoorwaarden. Voer in het deelvenster Waarschuwing instellen dat wordt weergegeven de volgende stappen uit:

1. Stel een tijdsfrequentie in voor hoe vaak de query wordt uitgevoerd. De standaardwaarde is vijf minuten. De enige voorwaarde die beschikbaar is in dit scenario is Bij elke gebeurtenis, wat betekent dat wanneer een record wordt geretourneerd, aan de voorwaarde wordt voldaan.
2. Geef in Actie op of u uw waarschuwing via e-mail of Microsoft Teams wilt ontvangen. In het zijvenster kunt u meldingen configureren die naar uzelf worden verzonden. Als u meldingen naar een andere gebruiker wilt verzenden, raadpleegt u Optioneel: Bewerk uw regel in Activator.
3. Geef op De locatie Opslaan op waar u de Activator-waarschuwing wilt opslaan. Kies een bestaande werkruimte en sla deze op in een bestaande activator of een nieuwe.
4. Selecteer Maken om uw Activator-regel te maken.

Optioneel: Uw regel bewerken in Activator

Wanneer uw activator is opgeslagen, wordt in het zijvenster een koppeling naar uw item weergegeven. Selecteer de koppeling om verder te bewerken in Activator. Deze stap kan handig zijn als u een van de volgende acties wilt uitvoeren:

• Voeg andere geadresseerden toe aan uw waarschuwing.
• Wijzig de inhoud van de waarschuwing zodat deze overeenkomt met de specifieke gegevens die de waarschuwing hebben geactiveerd.
• Definieer een complexere waarschuwingsvoorwaarde dan mogelijk is in het deelvenster Waarschuwing instellen.

Zie Activator-regels maken voor meer informatie over het bewerken van regels in Activator.

In de activator zelf kunt u ook de geschiedenis van de queryresultaten en de geschiedenis van de regelactivering bekijken. Zie Activator-regels maken voor meer informatie.

Gerelateerde inhoud

• Query's uitvoeren op gegevens in een KQL-queryset
• Aan de slag met Activator
• Snelzoekgids voor KQL