Aktivointihälytysten luominen KQL-kyselyjoukosta

Tässä artikkelissa kerrotaan, miten voit luoda Fabric-aktivointihälytyksiä KQL-kyselyjoukosta. Lisätietoja on ohjeaiheessa Mikä on aktivoija? Voit käynnistää ilmoituksia kahdessa tilassa käyttämällä KQL-kyselyjoukon aktivointia:

• kun ajoitettu KQL-kysely palauttaa tuloksia
• kun ajoitettu KQL-kysely palauttaa tuloksia, jotka sisältävät määritetyn ehtojoukon vastaavan visualisoinnin.

Lähetä ilmoitus joko itsellesi tai muille organisaatiossasi. Ilmoitukset voidaan lähettää sähköpostitse tai Microsoft Teamsin viestillä.

Esimerkkitilanteet

Seuraavassa on joitakin tapoja, joilla voit käyttää aktivointihälytyksiä KQL-kyselyiden kanssa:

• Oletetaan, että sinulla on KQL-tietokanta ja että tallennat sovelluslokeja.
  • Saat ilmoituksen, kun viimeisen viiden minuutintietueet sisältävät merkkijonon, authorization error taulukon viestisarakkeessa.
• Eri skenaariossa saatavilla olevien polkupyörien tietoja virtautetaan eri kaupunginosissa. KQL-kysely luodaan, jotta saadaan hahmonnettua ympyräkaavio, joka näyttää saatavilla olevien polkupyörien määrän naapurustoa kohti.
  • Saat ilmoituksen, kun saatavilla olevien polkupyörien määrä missä tahansa kaupunginosassa laskee hyväksyttävän määrän alapuolelle.

Edellytykset

• Työtila, jossa on Microsoft Fabric -yhteensopiva kapasiteetti
• Tietoja sisältävä KQL-tietokanta
• KQL-kyselyjoukko, joka on yhdistetty KQL-tietokantaan. Lisätietoja on artikkelissa Tietojen kyseleminen KQL-kyselyjoukossa.

Tärkeä

Vain kyselyjä Eventhousen KQL-tietokantoja vastaan tuetaan. Jos KQL-kyselyjoukkosi on yhdistetty ulkoiseen Azure Data Explorer -klusteriin, ilmoituksen luomista ei tueta.

Seuraavissa vaiheissa näytetään, miten luodaan ilmoitus kyselylle, joka luo visualisoinnin, tai kyselylle, joka ei luo visualisointia.

Valitse välilehti, joka vastaa haluamaasi työnkulkua.

Visualisoinnin avulla

Hälytyksen asettaminen KQL-kyselyjoukolle

Tärkeä

Tässä skenaariossa ei tueta aikakaaviovisualisointeja . Niitä tuetaan reaaliaikaisen koontinäytön aktivointihälytysten luonnissa.

1. Avaa työtila, joka sisältää KQL-kyselyjoukon.

2. Selaa KQL-kyselyjoukkoon ja valitse se avattavaksi.

3. Suorita kysely, joka palauttaa visualisoinnin.

4. Kun kysely palauttaa tulokset, valitse yläreunan valintanauhasta Aseta ilmoitus .

   Esimerkiksi seuraava kysely perustuu polkupyörien mallitietoihin reaaliaikaisten tietojen opetusohjelmasta.

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

   Kysely palauttaa pylväskaavion, joka näyttää kussakin kaupunginosassa käytettävissä olevien polkupyörien määrän. Tämän kaavion avulla voit määrittää hälytyksiä.

Hälytysehtojen määrittäminen

1. Määritä aikatiheys sille, kuinka usein kysely suoritetaan. Oletusarvo on viisi minuuttia.

2. Määritä ilmoitusehdot Ehtojenseuraavasti:

   • Jos visualisoinnissa ei ole dimensioita, voit valita Käytössä jokaisessa tapahtumassa, kun ehto valvoo tietovirran muutoksia, valitsemalla tietyn valvottavan kentän.
   • Jos visualisointiisi sisältyy dimensioita, voit valita Käytössä jokaiselle tapahtumalle ehdon mukaan ryhmiteltynä seurataksesi tietovirran muutoksia valitsemalla kentän ryhmittelyä varten, joka jakaa tiedot erillisiin ryhmiin
   • Määritä avattavassa Milloin-valikossa arvioitava arvo.
   • Määritä avattavassa Ehto-valikossa arvioitava ehto. Lisätietoja on kohdassa Ehdot.
   • Määritä Arvo-kentässä arvo, jota verrataan vertaamiseen.

3. Määritä Toiminto-kohdassa, haluatko ilmoituksesi sähköpostitse vai Microsoft Teamsin kautta. Sivuruudussa voit määrittää itsellesi lähetetyt ilmoitukset. Jos haluat lähettää ilmoituksia toiselle käyttäjälle, katso Valinnainen: Muokkaa sääntöä aktivointitoiminnossa.

4. Määritä Tallenna sijainti -kohdassa, minne tallennat aktivointihälytyksen. Valitse aiemmin luotu työtila ja tallenna se joko olemassa olevassa tai uudessa aktivointitoiminnossa.

5. Luo aktivointisääntö valitsemalla Luo .

   

Ilman visualisointia

Hälytyksen asettaminen KQL-kyselyjoukolle

1. Avaa työtila, joka sisältää KQL-kyselyjoukon.
2. Selaa KQL-kyselyjoukkoon ja valitse se avattavaksi.
3. Suorita kysely. Aktivointi tarkistaa tämän kyselyn tulokset myöhemmässä vaiheessa määritetyn aikavälin mukaan ja lähettää hälytyksen jokaisesta tulosjoukossa palautetystä tietueesta. Jos esimerkiksi ajoitettu kysely palauttaa viisi tietuetta, Activator lähettää viisi hälytystä.
4. Kun kysely on suoritettu, valitse yläreunan valintanauhasta Aseta ilmoitus .

Esimerkki 1 – Yksittäinen tulos, kun määrä on suurempi kuin raja-arvo

Esimerkiksi seuraava kysely palauttaa ilmoituksen, jos taulukossa on enemmän kuin raja-arvotietueita viimeisten 5 minuutin aikana. Kyselyn kaksi viimeistä riviä ovat avainasemassa, jossa suodattimia vastaavien tietueiden määrä luodaan, ja tulos palautetaan vain, jos määrä on suurempi kuin raja-arvo.

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

Esimerkki 2 – Luo yksittäinen tulos useiden arvojen matriisilla

Seuraavassa esimerkissä kysely palauttaa ilmoituksen, jos minkä tahansa naapuruston polkupyörien määrä ylittää annetun kynnysarvon. Jos haluat saada yksittäisen hälytyksen kaikista kaupunginosista, joiden luku ylittää kynnysarvon, kysely luodaan palauttamaan yksittäinen tietue (eli yksittäinen hälytys). Tämä tehdään make_list()-operaattorilla, kun haluat muokata ilmoitusta sisältämään luettelon niistä naapurustoista, jotka saavuttavat raja-arvon, katso Valinnainen: Muokkaa sääntöä Aktivaattori-kohdassa.

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

Hälytysehtojen määrittäminen

Määritä seuraavaksi ilmoituksesi ehdot. Tee avautuvassa Aseta ilmoitus -ruudussa seuraavat vaiheet:

1. Määritä aikatiheys sille, kuinka usein kysely suoritetaan. Oletusarvo on 5 minuuttia. Tässä skenaariossa ainoa käytettävissä oleva ehto on Kussakin tapahtumassa, mikä tarkoittaa sitä, että kun mikä tahansa tietue palautetaan, ehto täyttyy.
2. Määritä Toiminto-kohdassa, haluatko ilmoituksesi sähköpostitse vai Microsoft Teamsin kautta. Sivuruudussa voit määrittää itsellesi lähetetyt ilmoitukset. Jos haluat lähettää ilmoituksia toiselle käyttäjälle, katso Valinnainen: Muokkaa sääntöä aktivointitoiminnossa.
3. Määritä Tallenna sijainti -kohdassa, minne tallennat aktivointihälytyksen. Valitse aiemmin luotu työtila ja tallenna se joko olemassa olevassa tai uudessa aktivointitoiminnossa.
4. Luo aktivointisääntö valitsemalla Luo .

Valinnainen: Muokkaa sääntöä Aktivointi-kohdassa

Kun aktivointitoimintosi on tallennettu, sivuruudussa näkyy linkki kohteeseen. Valitse linkki, jota haluat muokata lisää Aktivointi-kohdassa. Tämä vaihe voi olla hyödyllinen, jos haluat tehdä jonkin seuraavista toimista:

• Lisää muita vastaanottajia ilmoitukseen.
• Muuta hälytyksen sisältö vastaamaan tiettyjä tietoja, jotka hälytyksen laukaisivat.
• Määritä monimutkaisempi hälytysehto kuin Aseta ilmoitus -ruudussa on mahdollista.

Lisätietoja sääntöjen muokkaamisesta Aktivointi-toiminnossa on kohdassa Aktivointisääntöjen luominen.

Voit myös itse aktivointitoiminnossa tarkastella kyselyn tulosten historiaa ja sääntöjen aktivointihistoriaa. Lisätietoja on kohdassa Aktivointisääntöjen luominen.

Liittyvä sisältö

• Tietojen kyseleminen KQL-kyselyjoukossa
• Aktivoinnin käytön aloittaminen
• KQL-pikaopas