Megosztás a következőn keresztül:

renderelési operátor

  • Cikk

A következőkre vonatkozik: ✅Microsoft Fabric✅Azure Data Explorer✅Azure Monitor✅Microsoft Sentinel

Utasítja a felhasználói ügynököt, hogy vizualizációt jelenítsen meg a lekérdezés eredményeiről.

A renderelő operátornak kell lennie a lekérdezés utolsó operátorának, és csak olyan lekérdezésekkel használható, amelyek egyetlen táblázatos adatfolyam-eredményt hoznak létre. A renderelési operátor nem módosítja az adatokat. Széljegyzetet ("Vizualizációt") injektál az eredmény kiterjesztett tulajdonságaiba. A széljegyzet a lekérdezésben szereplő operátor által megadott információkat tartalmazza. A vizualizációs információk értelmezését a felhasználói ügynök végzi. A különböző ügynökök, például a Kusto.Explorer vagy az Azure Data Explorer webes felhasználói felülete különböző vizualizációkat támogathatnak.

A renderelési operátor adatmodellje úgy tekinti meg a táblázatos adatokat, mintha háromféle oszlopból áll:

  • Az x tengely oszlopa (a xcolumn tulajdonság jelzi).
  • Az adatsoroszlopok (a series tulajdonság által jelzett tetszőleges számú oszlop).) Minden rekord esetében az oszlopok összesített értékei egyetlen adatsort határoznak meg, a diagram pedig annyi adatsort tartalmaz, amennyi különböző kombinált értékeket tartalmaz.
  • Az y tengely oszlopai (a ycolumns tulajdonság által jelzett tetszőleges számú oszlop). Az adatsor minden rekordhoz annyi mérést ("pontot" tartalmaz a diagramban), mint az y tengelyes oszlopok.

Borravaló

  • A megjelenő kötet korlátozásához használja where, summarize és top.
  • Rendezze az adatokat az x tengely sorrendjének meghatározásához.
  • A felhasználói ügynökök szabadon "találgatják" a lekérdezés által nem megadott tulajdonságok értékét. Különösen, ha az eredmény sémájában "érdektelen" oszlopok vannak, előfordulhat, hogy helytelenül találgatnak. Ilyen esetekben próbálkozzon az ilyen oszlopok kivetítésével.

Jegyzet

Vannak olyan vizualizációk, amelyek csak az Azure Data Explorer-irányítópultokon érhetők el. További információ: irányítópult-specifikus vizualizációk.

Szintaxis

T|rendervizualizációs [with(propertyName=propertyValue [, ...])]

További információ szintaxiskonvenciákról.

Paraméterek

Név Típus Szükséges Leírás
T string ✔️ Beviteli tábla neve.
vizualizációs string ✔️ A használni kívánt vizualizációs típusát jelzi. Az alábbi lista egyik támogatott értékének kell lennie.
propertyName, propertyValue string Kulcs-érték tulajdonságpárok vesszővel tagolt listája. Lásd támogatott tulajdonságokat.

Látványtervezés

vizualizációs Leírás Illusztráció
anomalychart Hasonló az idődiagramhoz, de kiemeli az series_decompose_anomalies függvényt használó anomáliákat.
areachart Területdiagram.
barchart vízszintes csíkként jelenik meg.
card Az első eredményrekord skaláris értékek halmazaként lesz kezelve, és kártyaként jelenik meg.
columnchart Mint barchart vízszintes csíkok helyett függőleges csíkokkal.
ladderchart Az utolsó két oszlop az x tengely, a másik az y tengely.
linechart Vonaldiagram.
piechart Az első oszlop színtengely, a második oszlop numerikus.
pivotchart Kimutatástáblát és diagramot jelenít meg. A felhasználó interaktívan kiválaszthatja az adatokat, oszlopokat, sorokat és különböző diagramtípusokat.
scatterchart Pontdiagram.
stackedareachart Halmozott területdiagram.
table Alapértelmezett – az eredmények táblázatként jelennek meg.
timechart Vonaldiagram. Az első oszlop x tengelyű, és dátumidőnek kell lennie. Más (numerikus) oszlopok y tengelyek.
timepivot Interaktív navigáció az események idővonalán (az időtengelyen forgatva)
treemap Hierarchikus adatokat jelenít meg beágyazott téglalapok halmazaként.

Jegyzet

A létradiagram, a kimutatásdiagram, a timepivot és a fatérkép-vizualizációk használhatók a Kusto.Explorerben, de nem érhetők el az Azure Data Explorer webes felhasználói felületén.

Vizualizációs Leírás Illusztráció
areachart Területdiagram. Az első oszlop az x tengely, és numerikus oszlopnak kell lennie. Más numerikus oszlopok y tengelyek.
barchart Az első oszlop az x tengely, amely lehet szöveg, dátum vagy szám. A többi oszlop numerikus, vízszintes csíkként jelenik meg.
columnchart Mint barchart vízszintes csíkok helyett függőleges csíkokkal.
piechart Az első oszlop színtengely, a második oszlop numerikus.
scatterchart Pontdiagram. Az első oszlop az x tengely, és numerikus oszlopnak kell lennie. Más numerikus oszlopok y tengelyek.
table Alapértelmezett – az eredmények táblázatként jelennek meg.
timechart Vonaldiagram. Az első oszlop x tengelyű, és dátumidőnek kell lennie. Más (numerikus) oszlopok y tengelyek. Van egy sztringoszlop, amelynek értékei a numerikus oszlopok "csoportosítására" szolgálnak, és különböző sorokat hoznak létre a diagramban (a további sztringoszlopokat figyelmen kívül hagyja a rendszer).
vizualizációs Leírás Illusztráció
anomalychart Hasonló az idődiagramhoz, de kiemeli az series_decompose_anomalies függvényt használó anomáliákat.
areachart Területdiagram.
barchart vízszintes csíkként jelenik meg.
card Az első eredményrekord skaláris értékek halmazaként lesz kezelve, és kártyaként jelenik meg.
columnchart Mint barchart vízszintes csíkok helyett függőleges csíkokkal.
linechart Vonaldiagram.
piechart Az első oszlop színtengely, a második oszlop numerikus.
scatterchart Pontdiagram.
stackedareachart Halmozott területdiagram.
table Alapértelmezett – az eredmények táblázatként jelennek meg.
timechart Vonaldiagram. Az első oszlop x tengelyű, és dátumidőnek kell lennie. Más (numerikus) oszlopok y tengelyek.

Támogatott tulajdonságok

PropertyName/PropertyValue a renderelés során használandó további információkat jelzik. Minden tulajdonság megadása nem kötelező. A támogatott tulajdonságok a következők:

PropertyName PropertyValue
accumulate Azt, hogy az egyes mértékek értéke hozzáadódik-e az összes elődjéhez. (true vagy false)
kind A vizualizáció típusának további kidolgozása. További információ: kind tulajdonság.
legend Jelmagyarázat megjelenítése (visible vagy hidden).
series Azoknak az oszlopoknak a vessző által tagolt listája, amelyek rekordonként összesített értékei határozzák meg azt az adatsort, amelyhez a rekord tartozik.
ymin Az Y tengelyen megjelenítendő minimális érték.
ymax Az Y tengelyen megjelenítendő maximális érték.
title A vizualizáció címe (stringtípusú).
xaxis Az x tengely (linear vagy log) skálázása.
xcolumn Az eredmény melyik oszlopát használja a rendszer az x tengelyhez.
xtitle Az x tengely címe (stringtípusú).
yaxis Az y tengely (linear vagy log) skálázása.
ycolumns Vessző által tagolt oszlopok listája, amelyek az x oszlop értékeként megadott értékekből állnak.
ysplit A vizualizáció felosztása több y tengelyes értékre. További információ: y-split tulajdonság.
ytitle Az y tengely címe (stringtípusú).
anomalycolumns Csak a anomalychartvonatkozó tulajdonság. Vesszővel tagolt oszlopok listája, amelyek anomáliák sorozatának minősülnek, és pontokként jelennek meg a diagramon
PropertyName PropertyValue
kind A vizualizáció típusának további kidolgozása. További információ: kind tulajdonság.
series Azoknak az oszlopoknak a vessző által tagolt listája, amelyek rekordonként összesített értékei határozzák meg azt az adatsort, amelyhez a rekord tartozik.
title A vizualizáció címe (stringtípusú).

kind tulajdonság

Ezt a vizualizációt tovább lehet dolgozni a kind tulajdonság megadásával. A tulajdonság támogatott értékei a következők:

Vizualizációs kind Leírás
areachart default Minden "terület" önmagában áll.
unstacked Ugyanaz, mint default.
stacked Verem a "területeket" a jobb oldalon.
stacked100 Verem a "területeket" a jobb oldalon, és nyújtsa mindegyiket ugyanolyan szélességűre, mint a többi.
barchart default Minden "sáv" önmagában áll.
unstacked Ugyanaz, mint default.
stacked Verem "sávok".
stacked100 Verje össze a "sávokat", és nyújtsa mindegyiket a többihez hasonló szélességűre.
columnchart default Minden "oszlop" önmagában áll.
unstacked Ugyanaz, mint default.
stacked Verem az "oszlopok" egyik tetején a másikat.
stacked100 Verje össze az "oszlopokat", és nyújtsa ki mindegyiket a többiével megegyező magasságban.
scatterchart map A várt oszlopok a [Hosszúság, Szélesség] vagy GeoJSON-pont. Az adatsor oszlop nem kötelező. További információ: Térinformatikai vizualizációk.
piechart map A várt oszlopok a következők: [Hosszúság, Szélesség] vagy GeoJSON-pont, színtengely és numerikus. A Kusto Explorer asztali verziójában támogatott. További információ: Térinformatikai vizualizációk.

ysplit tulajdonság

Egyes vizualizációk támogatják a több y tengelyes értékekre való felosztást:

ysplit Leírás
none Az összes adatsorhoz egyetlen y tengely jelenik meg. (Alapértelmezett)
axes Egyetlen diagram több y tengelysel (sorozatonként egy) jelenik meg.
panels Minden ycolumn értékhez egy diagram jelenik meg. Legfeljebb öt panel.

Folyamatos adatok renderelése

Számos vizualizációt használunk értéksorozatok megjelenítéséhez, például linechart, timechartés areachart. Ezek a vizualizációk a következő fogalmi modellel rendelkeznek:

  • A táblázat egyik oszlopa az adatok x tengelyét jelöli. Ez az oszlop explicit módon definiálható a xcolumn tulajdonság használatával. Ha nincs megadva, a felhasználói ügynök kiválasztja a vizualizációnak megfelelő első oszlopot.
    • Például: a timechart vizualizációban a felhasználói ügynök az első datetime oszlopot használja.
    • Ha ez az oszlop dynamic típusú, és egy tömböt tartalmaz, a tömb egyes értékei az x tengely értékeiként lesznek kezelve.
  • A táblázat egy vagy több oszlopa egy vagy több mértéket jelöl, amelyek az x tengelytől függően változnak. Ezek az oszlopok explicit módon definiálhatók a ycolumns tulajdonság használatával. Ha nincs definiálva, a felhasználói ügynök kiválasztja a vizualizációhoz megfelelő összes oszlopot.
    • Például: a timechart vizualizációban a felhasználói ügynök minden olyan oszlopot használ, amelynek numerikus értéke nincs másként megadva.
    • Ha az x tengely tömb, akkor az egyes y tengelyek értékeinek is egy hasonló hosszúságú tömbnek kell lenniük, és az egyes y tengelyek egyetlen oszlopban fordulnak elő.
  • A tábla nulla vagy több oszlopa olyan egyedi dimenziókészletet jelöl, amely a mértékeket csoportosítja. Ezeket az oszlopokat megadhatja a series tulajdonság, vagy a felhasználói ügynök automatikusan kiválasztja őket az egyébként nem meghatározott oszlopokból.

Jegyzet

A renderelési operátor adatmodellje úgy tekinti meg a táblázatos adatokat, mintha háromféle oszlopból áll:

  • Az x tengely oszlopa (a xcolumn tulajdonság jelzi).
  • Az adatsoroszlopok (a series tulajdonság által jelzett tetszőleges számú oszlop).)
  • Az y tengely oszlopai (a ycolumns tulajdonság által jelzett tetszőleges számú oszlop). Az adatsor minden rekordhoz annyi mérést ("pontot" tartalmaz a diagramban), mint az y tengelyes oszlopok.

Példa

InsightsMetrics
| where Computer == "DC00.NA.contosohotels.com"
| where Namespace  == "Processor" and Name == "UtilizationPercentage"
| summarize avg(Val) by Computer, bin(TimeGenerated, 1h)
| render timechart