operator render
Geeft de gebruikersagent de opdracht om een visualisatie van de queryresultaten weer te geven.
De renderoperator moet de laatste operator in de query zijn en kan alleen worden gebruikt met query's die één gegevensstroomresultaat in tabelvorm produceren. De renderoperator wijzigt de gegevens niet. Het injecteert een aantekening ('Visualisatie') in de uitgebreide eigenschappen van het resultaat. De aantekening bevat de informatie die door de operator in de query is opgegeven. De interpretatie van de visualisatiegegevens wordt uitgevoerd door de gebruikersagent. Verschillende agents, zoals Kusto.Explorer of de webinterface van Azure Data Explorer, kunnen verschillende visualisaties ondersteunen.
Het gegevensmodel van de renderoperator bekijkt de tabellaire gegevens alsof deze drie soorten kolommen hebben:
- De kolom x-as (aangegeven door de
xcolumn
eigenschap). - De reekskolommen (een willekeurig aantal kolommen dat wordt aangegeven door de
series
eigenschap.) Voor elke record definiëren de gecombineerde waarden van deze kolommen één reeks en de grafiek heeft net zoveel reeksen als er afzonderlijke gecombineerde waarden zijn. - De kolommen van de y-as (een willekeurig aantal kolommen dat wordt aangegeven door de
ycolumns
eigenschap). Voor elke record heeft de reeks net zoveel metingen ('punten' in de grafiek) als er kolommen op de y-as zijn.
Tip
- Gebruik
where
ensummarize
top
om het weer te geven volume te beperken. - Sorteer de gegevens om de volgorde van de x-as te definiëren.
- Gebruikersagenten kunnen de waarde 'raden' van eigenschappen die niet zijn opgegeven door de query. Met name het hebben van 'oninteresterende' kolommen in het schema van het resultaat kan zich vertalen in het verkeerd raden. Probeer dergelijke kolommen weg te projecteren wanneer dat gebeurt.
Notitie
Er zijn enkele visualisaties die alleen beschikbaar zijn in Azure Data Explorer-dashboards. Zie Dashboardspecifieke visuals voor meer informatie.
Syntax
T|
render
visualisatie [with
(
propertyName=
propertyValue [,
...])
]
Meer informatie over syntaxisconventies.
Parameters
Naam | Type | Vereist | Beschrijving |
---|---|---|---|
T | string |
✔️ | Naam van invoertabel. |
Visualization | string |
✔️ | Geeft het type visualisatie aan dat moet worden gebruikt. Moet een van de ondersteunde waarden in de volgende lijst zijn. |
propertyName, propertyValue | string |
Een door komma's gescheiden lijst met sleutel-waarde-eigenschappenparen. Zie ondersteunde eigenschappen. |
Visualisatie
Visualization | Description | Illustratie |
---|---|---|
anomalychart |
Vergelijkbaar met tijddiagram, maar markeert afwijkingen met behulp van series_decompose_anomalies-functie . | |
areachart |
Vlakdiagram. | |
barchart |
weergegeven als horizontale stroken. | |
card |
De eerste resultaatrecord wordt behandeld als een reeks scalaire waarden en wordt weergegeven als een kaart. | |
columnchart |
Zoals barchart bij verticale stroken in plaats van horizontale stroken. |
|
ladderchart |
De laatste twee kolommen zijn de x-as, andere kolommen zijn de y-as. | |
linechart |
Lijndiagram. | |
piechart |
De eerste kolom is een kleuras, de tweede kolom is numeriek. | |
pivotchart |
Geeft een draaitabel en grafiek weer. De gebruiker kan interactief gegevens, kolommen, rijen en verschillende grafiektypen selecteren. | |
scatterchart |
Puntengrafiek. | |
stackedareachart |
Gestapeld vlakdiagram. | |
table |
Standaard: de resultaten worden weergegeven als een tabel. | |
timechart |
Lijndiagram. De eerste kolom is een x-as en moet datum/tijd zijn. Andere (numerieke) kolommen zijn y-assen. | |
timepivot |
Interactieve navigatie over de tijdlijn van gebeurtenissen (draaien op de tijdas) | |
treemap |
Geeft hiërarchische gegevens weer als een set geneste rechthoeken. |
Notitie
De visualisaties laddergrafiek, draaigrafiek, timepivot en treemap kunnen worden gebruikt in Kusto.Explorer, maar zijn niet beschikbaar in de webgebruikersinterface van Azure Data Explorer.
Visualisatie | Description | Illustratie |
---|---|---|
areachart |
Vlakdiagram. De eerste kolom is de x-as en moet een numerieke kolom zijn. Andere numerieke kolommen zijn y-assen. | |
barchart |
De eerste kolom is de x-as en kan tekst, datum/tijd of numeriek zijn. Andere kolommen zijn numeriek en worden weergegeven als horizontale stroken. | |
columnchart |
Zoals barchart bij verticale stroken in plaats van horizontale stroken. |
|
piechart |
De eerste kolom is een kleuras, de tweede kolom is numeriek. | |
scatterchart |
Puntengrafiek. De eerste kolom is de x-as en moet een numerieke kolom zijn. Andere numerieke kolommen zijn y-assen. | |
table |
Standaard: de resultaten worden weergegeven als een tabel. | |
timechart |
Lijndiagram. De eerste kolom is een x-as en moet datum/tijd zijn. Andere (numerieke) kolommen zijn y-assen. Er is één tekenreekskolom waarvan de waarden worden gebruikt om de numerieke kolommen te 'groepeer' en verschillende lijnen in de grafiek te maken (andere tekenreekskolommen worden genegeerd). |
Visualization | Description | Illustratie |
---|---|---|
anomalychart |
Vergelijkbaar met tijddiagram, maar markeert afwijkingen met behulp van series_decompose_anomalies-functie . | |
areachart |
Vlakdiagram. | |
barchart |
weergegeven als horizontale stroken. | |
card |
De eerste resultaatrecord wordt behandeld als een reeks scalaire waarden en wordt weergegeven als een kaart. | |
columnchart |
Zoals barchart bij verticale stroken in plaats van horizontale stroken. |
|
linechart |
Lijndiagram. | |
piechart |
De eerste kolom is een kleuras, de tweede kolom is numeriek. | |
scatterchart |
Puntengrafiek. | |
stackedareachart |
Gestapeld vlakdiagram. | |
table |
Standaard: de resultaten worden weergegeven als een tabel. | |
timechart |
Lijndiagram. De eerste kolom is een x-as en moet datum/tijd zijn. Andere (numerieke) kolommen zijn y-assen. |
Ondersteunde eigenschappen
Propertyname/PropertyValue geeft aanvullende informatie aan die moet worden gebruikt bij het weergeven. Alle eigenschappen zijn optioneel. De ondersteunde eigenschappen zijn:
PropertyName | PropertyValue |
---|---|
accumulate |
Of de waarde van elke meting wordt toegevoegd aan alle voorafgaande waarden. (true of false ) |
kind |
Verdere uitwerking van het soort visualisatie. Zie eigenschap voor meer informatiekind . |
legend |
Of een legenda wel of niet moet worden weergegeven (visible of hidden ). |
series |
Door komma's gescheiden lijst met kolommen waarvan de gecombineerde waarden per record de reeks definiëren waartoe de record behoort. |
ymin |
De minimumwaarde die op de y-as moet worden weergegeven. |
ymax |
De maximumwaarde die op de Y-as moet worden weergegeven. |
title |
De titel van de visualisatie (van het type string ). |
xaxis |
De schaal van de x-as (linear of log ). |
xcolumn |
Welke kolom in het resultaat wordt gebruikt voor de x-as. |
xtitle |
De titel van de x-as (van het type string ). |
yaxis |
De schaal van de y-as (linear of log ). |
ycolumns |
Door komma's gescheiden lijst met kolommen die bestaan uit de opgegeven waarden per waarde van de x-kolom. |
ysplit |
Meerdere visualisaties splitsen. Zie eigenschap voor meer informatiey-split . |
ytitle |
De titel van de y-as (van het type string ). |
anomalycolumns |
Eigenschap die alleen relevant is voor anomalychart . Door komma's gescheiden lijst met kolommen, die worden beschouwd als anomaliereeksen en worden weergegeven als punten in de grafiek |
PropertyName | PropertyValue |
---|---|
kind |
Verdere uitwerking van het soort visualisatie. Zie eigenschap voor meer informatiekind . |
series |
Door komma's gescheiden lijst met kolommen waarvan de gecombineerde waarden per record de reeks definiëren waartoe de record behoort. |
title |
De titel van de visualisatie (van het type string ). |
kind
Eigenschap
Deze visualisatie kan verder worden uitgewerkt door de kind
eigenschap op te geven.
De ondersteunde waarden van deze eigenschap zijn:
Visualisatie | kind |
Description |
---|---|---|
areachart |
default |
Elk "gebied" staat op zichzelf. |
unstacked |
Hetzelfde als default . |
|
stacked |
Stapel 'gebieden' aan de rechterkant. | |
stacked100 |
Stapel 'gebieden' aan de rechterkant en strek elk gebied uit tot dezelfde breedte als de andere. | |
barchart |
default |
Elke "bar" staat op zichzelf. |
unstacked |
Hetzelfde als default . |
|
stacked |
Stapel 'balken'. | |
stacked100 |
Stapel 'balken' en rek ze uit tot dezelfde breedte als de andere. | |
columnchart |
default |
Elke 'kolom' staat op zichzelf. |
unstacked |
Hetzelfde als default . |
|
stacked |
Stapel 'kolommen' boven op de andere. | |
stacked100 |
Stapel 'kolommen' en rek ze uit tot dezelfde hoogte als de andere. | |
scatterchart |
map |
Verwachte kolommen zijn [Lengtegraad, Breedtegraad] of GeoJSON-punt. De kolom Reeks is optioneel. Zie Georuimtelijke visualisaties voor meer informatie. |
piechart |
map |
Verwachte kolommen zijn [Lengtegraad, Breedtegraad] of GeoJSON-punt, kleuras en numeriek. Ondersteund in de bureaubladversie van Kusto Explorer. Zie Georuimtelijke visualisaties voor meer informatie. |
ysplit
Eigenschap
Sommige visualisaties ondersteunen splitsen in meerdere y-aswaarden:
ysplit |
Description |
---|---|
none |
Er wordt één y-as weergegeven voor alle reeksgegevens. (standaard) |
axes |
Eén grafiek wordt weergegeven met meerdere y-assen (één per reeks). |
panels |
Er wordt één grafiek weergegeven voor elke ycolumn waarde (tot een bepaalde limiet). |
Continue gegevens weergeven
Er worden verschillende visualisaties gebruikt voor het weergeven van reeksen van waarden, bijvoorbeeld linechart
, timechart
en areachart
.
Deze visualisaties hebben het volgende conceptuele model:
- Eén kolom in de tabel vertegenwoordigt de x-as van de gegevens. Deze kolom kan expliciet worden gedefinieerd met behulp van de
xcolumn
eigenschap . Als deze niet is gedefinieerd, kiest de gebruikersagent de eerste kolom die geschikt is voor de visualisatie.- Bijvoorbeeld: in de
timechart
visualisatie gebruikt de gebruikersagent de eerstedatetime
kolom. - Als deze kolom van het type
dynamic
is en een matrix bevat, worden de afzonderlijke waarden in de matrix behandeld als de waarden van de x-as.
- Bijvoorbeeld: in de
- Een of meer kolommen in de tabel vertegenwoordigen een of meer metingen die variëren per x-as.
Deze kolommen kunnen expliciet worden gedefinieerd met behulp van de
ycolumns
eigenschap . Als deze niet is gedefinieerd, kiest de gebruikersagent alle kolommen die geschikt zijn voor de visualisatie.- Bijvoorbeeld: in de
timechart
visualisatie gebruikt de gebruikersagent alle kolommen met een numerieke waarde die anders niet zijn opgegeven. - Als de x-as een matrix is, moeten de waarden van elke y-as ook een matrix van een vergelijkbare lengte zijn, waarbij elke y-as in één kolom voorkomt.
- Bijvoorbeeld: in de
- Nul of meer kolommen in de tabel vertegenwoordigen een unieke set dimensies die de metingen groeperen. Deze kolommen kunnen worden opgegeven door de
series
eigenschap, of de gebruikersagent kiest ze automatisch uit de kolommen die anders niet zijn opgegeven.
Gerelateerde inhoud
Notitie
Het gegevensmodel van de renderoperator kijkt naar de gegevens in tabelvorm alsof deze drie soorten kolommen hebben:
- De kolom x-as (aangegeven door de
xcolumn
eigenschap). - De reekskolommen (een willekeurig aantal kolommen dat wordt aangegeven door de
series
eigenschap.) - De y-askolommen (een willekeurig aantal kolommen dat wordt aangegeven door de
ycolumns
eigenschap). Voor elke record heeft de reeks net zoveel metingen ('punten' in de grafiek) als er y-askolommen zijn.
Voorbeeld
InsightsMetrics
| where Computer == "DC00.NA.contosohotels.com"
| where Namespace == "Processor" and Name == "UtilizationPercentage"
| summarize avg(Val) by Computer, bin(TimeGenerated, 1h)
| render timechart
Feedback
https://aka.ms/ContentUserFeedback.
Binnenkort beschikbaar: In de loop van 2024 zullen we GitHub-problemen geleidelijk uitfaseren als het feedbackmechanisme voor inhoud en deze vervangen door een nieuw feedbacksysteem. Zie voor meer informatie:Feedback verzenden en weergeven voor