Opret aktiveringsbeskeder fra et KQL-forespørgselssæt

Angiv besked på et KQL-forespørgselssæt

1. Åbn det arbejdsområde, der indeholder dit KQL-forespørgselssæt.

2. Gå til dit KQL-forespørgselssæt, og vælg det for at åbne det.

3. Kør en forespørgsel, der returnerer en visualisering.

4. Når forespørgslen returnerer resultater, skal du vælge Angiv besked på det øverste bånd.

   

Definer beskedbetingelser

I sidepanelet Tilføj Regel følger du disse trin for at definere dine alarmbetingelser:

1. I Details-sektionen indtaster du et navn til din Activator-alarmregel.

   

2. I afsnittet Overvågning skal du sætte en tidsfrekvens for, hvor ofte forespørgslen kører. Standardværdien er 5 minutter.

   

3. I afsnittet Tilstand skal du angive dine alarmbetingelser som følger:

   

   • Hvis din visualisering ikke har dimensioner, vælg On every event wh-tilstanden for at overvåge ændringer i datastrømmen ved at vælge et specifikt felt at overvåge.
   • I dropdown-menuen Hvornår skal du sætte værdien til evaluering.
   • I dropdown-menuen Betingelse skal du sætte betingelsen til evaluering. Du kan få flere oplysninger under Betingelser.
   • I feltet Forekomst skal man sætte antallet af gange, betingelsen skal opfyldes, før en alarm udløses.

4. Vælg en af følgende handlinger i sektionen Handling :

   • Send e-mail-notifikation:

     1. For Vælg handling skal du vælge Send mail.
     2. For Til indtastes modtagerens e-mailadresse eller bruges dropdown-listen til at vælge en egenskab, hvis værdi er en e-mailadresse. Som standard er din e-mailadresse angivet her.
     3. For Emne indtast emnet for e-mailnotifikationen.
     4. For overskrift, indtast overskriften på e-mailnotifikationen.
     5. For Noter indtast noter til e-mailnotifikationen.

        Notat

        Når du indtaster emne, overskrift eller noter, kan du referere til egenskaber i dataene ved at skrive @ eller ved at vælge knappen ud for tekstfelterne. Det kunne f.eks. være @BikepointID.

     6. Til kontekst vælger du de værdier fra dropdown-listen, du vil inkludere i e-mailnotifikationen.

     

   • Send Microsoft Teams notifikation: Sender en Microsoft Teams notifikation til enkeltpersoner, en gruppechat eller en kanal. Du kan tilpasse titlen og indholdet af beskeden.

     1. For Select-handlingen vælg Teams –>Besked til enkeltpersoner, gruppechatbesked eller kanalindlæg.
     2. Følg et af disse trin afhængigt af dit valg:
        • Hvis du vælger muligheden Besked til enkeltpersoner , indtaster modtagernes e-mailadresser eller bruger rullemenuen til at vælge en ejendom, hvis værdi er en e-mailadresse. Når betingelsen er opfyldt, sendes en Teams-besked til de angivne personer.
        • Hvis du vælger gruppechat-beskedmuligheden , vælg en gruppechat fra rullemenuen. Når betingelsen er opfyldt, sendes der en besked til gruppechatten.
        • Hvis du vælger muligheden Kanalpost , vælg et hold og en kanal fra dropdown-listerne. Når betingelsen er opfyldt, postes en besked på den valgte kanal.
     3. For Overskrift indtast overskriften i Teams-notifikationen.
     4. For Noter indtaster du noter til Teams-notifikationen.

        Notat

        Når du indtaster emne, overskrift eller noter, kan du referere til egenskaber i dataene ved at skrive @ eller ved at vælge knappen ud for tekstfelterne. Det kunne f.eks. være @BikepointID.

     5. Til kontekst vælger du værdierne fra dropdown-listen, du vil inkludere i Teams-notifikationen.

     

   • Kør Fabric aktiviteter: For at konfigurere advarslen til at starte en Fabric pipeline, Dataflow, Spark-job, notesbog eller User Data Function, når betingelsen er opfyldt, følg disse trin:

     1. For Vælg handling vælg den passende Fabric elementtype i sektionen Kør Fabric aktiviteter.
     2. På Vælg Fabric element at køre vælg det Fabric element fra listen.
     3. Vælg Tilføj parameter og angiv navnet på parameteren for det Fabric element samt en værdi for det. Du kan tilføje mere end én parameter. Du kan sende parametre fra alarmdataene ved at skrive @ eller vælge knappen ved siden af tekstboksen. Det kunne f.eks. være @BikepointID.

   • Brugerdefinerede handlinger: For at konfigurere advarslen til at kalde en brugerdefineret handling, når betingelsen er opfyldt, følger du disse trin:

     1. For Vælg handling, vælg Opret brugerdefineret handling.

        

     2. Som nævnt i handlingsafsnittet , lav reglen først. Derefter fuldfører du opsætningen af brugerdefinerede handlinger ved at følge trinene fra Trigger brugerdefinerede handlinger (Power Automate flows).

     3. Efter du har oprettet den brugerdefinerede handling, vælger du i definitionspanelet i reglen den brugerdefinerede handling, du har oprettet, fra handlingsrullemenuen.

5. Angiv , hvor aktiveringsbeskeden skal gemmes, på lagringsplaceringen. Vælg et eksisterende arbejdsområde, og gem enten i en eksisterende aktivator eller et nyt.

   

6. Vælg Opret for at oprette din Activator-regel.

Angiv besked på et KQL-forespørgselssæt

1. Åbn det arbejdsområde, der indeholder dit KQL-forespørgselssæt.
2. Gå til dit KQL-forespørgselssæt, og vælg det for at åbne det.
3. Kør en forespørgsel. Aktivator kontrollerer resultaterne af denne forespørgsel i henhold til den tidshyppighed, der er angivet i et senere trin, og sender en besked for hver post, der returneres i resultatsættet. Hvis en planlagt forespørgsel f.eks. returnerer fem poster, sender Activator fem beskeder.
4. Når forespørgslen er færdig med at køre, skal du vælge Angiv besked på det øverste bånd.

Eksempel 1 – Enkelt resultat, når antallet er større end tærsklen

Følgende forespørgsel returnerer f.eks. en besked, hvis der er mere end tærskelposter i tabellen fra de sidste 5 minutter. De sidste to linjer i forespørgslen er nøglen, hvor antallet af poster, der svarer til filtrene, oprettes, og et resultat returneres kun, hvis antallet er større end grænsen.

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

Eksempel 2 – Opret et enkelt resultat med en matrix med flere værdier

I følgende eksempel returnerer forespørgslen en besked, hvis antallet af cykler i et nabolag er over den angivne grænse. For at få en enkelt advarsel for alle nabolag, hvor tallet er over tærsklen, returnerer forespørgslen en enkelt post (dvs. en enkelt advarsel) ved at bruge operatoren make_list(). Hvis du vil redigere beskeden, så den indeholder listen over de nabolag, der har nået grænsen, skal du se Valgfrit: Rediger din regel i Activator.

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

Definer beskedbetingelser

I sidepanelet Tilføj Regel følger du disse trin for at definere dine alarmbetingelser:

1. I Details-sektionen indtaster du et navn til din Activator-alarmregel.

   

2. I afsnittet Overvågning skal du sætte en tidsfrekvens for, hvor ofte forespørgslen kører. Standardværdien er 5 minutter.

   

3. I afsnittet Tilstand skal du angive dine alarmbetingelser som følger:

   

   • Hvis din visualisering ikke har dimensioner, vælg On every event wh-tilstanden for at overvåge ændringer i datastrømmen ved at vælge et specifikt felt at overvåge.
   • I dropdown-menuen Hvornår skal du sætte værdien til evaluering.
   • I dropdown-menuen Betingelse skal du sætte betingelsen til evaluering. Du kan få flere oplysninger under Betingelser.
   • I feltet Forekomst skal man sætte antallet af gange, betingelsen skal opfyldes, før en alarm udløses.

4. Vælg en af følgende handlinger i sektionen Handling :

   • Send e-mail-notifikation:

     1. For Vælg handling skal du vælge Send mail.
     2. For Til indtastes modtagerens e-mailadresse eller bruges dropdown-listen til at vælge en egenskab, hvis værdi er en e-mailadresse. Som standard er din e-mailadresse angivet her.
     3. For Emne indtast emnet for e-mailnotifikationen.
     4. For overskrift, indtast overskriften på e-mailnotifikationen.
     5. For Noter indtast noter til e-mailnotifikationen.

        Notat

        Når du indtaster emne, overskrift eller noter, kan du referere til egenskaber i dataene ved at skrive @ eller ved at vælge knappen ud for tekstfelterne. Det kunne f.eks. være @BikepointID.

     6. Til kontekst vælger du de værdier fra dropdown-listen, du vil inkludere i e-mailnotifikationen.

     

   • Send Microsoft Teams notifikation: Sender en Microsoft Teams notifikation til enkeltpersoner, en gruppechat eller en kanal. Du kan tilpasse titlen og indholdet af beskeden.

     1. For Select-handlingen vælg Teams –>Besked til enkeltpersoner, gruppechatbesked eller kanalindlæg.
     2. Følg et af disse trin afhængigt af dit valg:
        • Hvis du vælger muligheden Besked til enkeltpersoner , indtaster modtagernes e-mailadresser eller bruger rullemenuen til at vælge en ejendom, hvis værdi er en e-mailadresse. Når betingelsen er opfyldt, sendes en Teams-besked til de angivne personer.
        • Hvis du vælger gruppechat-beskedmuligheden , vælg en gruppechat fra rullemenuen. Når betingelsen er opfyldt, sendes der en besked til gruppechatten.
        • Hvis du vælger muligheden Kanalpost , vælg et hold og en kanal fra dropdown-listerne. Når betingelsen er opfyldt, postes en besked på den valgte kanal.
     3. For Overskrift indtast overskriften i Teams-notifikationen.
     4. For Noter indtaster du noter til Teams-notifikationen.

        Notat

        Når du indtaster emne, overskrift eller noter, kan du referere til egenskaber i dataene ved at skrive @ eller ved at vælge knappen ud for tekstfelterne. Det kunne f.eks. være @BikepointID.

     5. Til kontekst vælger du værdierne fra dropdown-listen, du vil inkludere i Teams-notifikationen.

     

   • Kør Fabric aktiviteter: For at konfigurere advarslen til at starte en Fabric pipeline, Dataflow, Spark-job, notesbog eller User Data Function (forhåndsvisning), når betingelsen er opfyldt, følg disse trin:

     1. For Vælg handling vælg den passende Fabric elementtype i sektionen Kør Fabric aktiviteter.
     2. På Vælg Fabric element at køre vælg det Fabric element fra listen.
     3. Vælg Tilføj parameter og angiv navnet på parameteren for det Fabric element samt en værdi for det. Du kan tilføje mere end én parameter. Du kan sende parametre fra alarmdataene ved at skrive @ eller vælge knappen ved siden af tekstboksen. Det kunne f.eks. være @BikepointID.

   • Brugerdefinerede handlinger: For at konfigurere advarslen til at kalde en brugerdefineret handling, når betingelsen er opfyldt, følger du disse trin:

     1. For Vælg handling, vælg Opret brugerdefineret handling.

        

     2. Som nævnt i handlingsafsnittet , lav reglen først. Derefter fuldfører du opsætningen af brugerdefinerede handlinger ved at følge trinene fra Trigger brugerdefinerede handlinger (Power Automate flows).

     3. Efter du har oprettet den brugerdefinerede handling, vælger du i definitionspanelet i reglen den brugerdefinerede handling, du har oprettet, fra handlingsrullemenuen.

5. Angiv , hvor aktiveringsbeskeden skal gemmes, på lagringsplaceringen. Vælg et eksisterende arbejdsområde, og gem enten i en eksisterende aktivator eller et nyt.

1. Vælg Opret for at oprette din Activator-regel.