Operatore render
Indica all'agente utente di eseguire il rendering di una visualizzazione dei risultati della query.
L'operatore di rendering deve essere l'ultimo operatore della query e può essere usato solo con query che producono un singolo risultato del flusso di dati tabulare. L'operatore di rendering non modifica i dati. Inserisce un'annotazione ("visualizzazione") nelle proprietà estese del risultato. L'annotazione contiene le informazioni fornite dall'operatore nella query. L'interpretazione delle informazioni della visualizzazione viene eseguita dall'agente utente. Diversi agenti, ad esempio Kusto.Explorer o l'interfaccia utente Web di Azure Esplora dati, possono supportare visualizzazioni diverse.
Il modello di dati dell'operatore render considera i dati tabulari come costituiti da tre tipi di colonne:
- La colonna dell'asse x (indicata dalla proprietà
xcolumn
). - Colonne di serie (qualsiasi numero di colonne indicate dalla
series
proprietà). Per ogni record, i valori combinati di queste colonne definiscono una singola serie e il grafico ha il numero massimo di serie che esistono valori combinati distinti. - Le colonne dell'asse y (qualsiasi numero di colonne indicate dalla proprietà
ycolumns
). Per ogni record, la serie ha tante misure ("punti" nel grafico) quante sono le colonne dell'asse y.
Suggerimento
- Usare
where
,summarize
etop
per limitare la quantità di dati visualizzati. - Disporre i dati per definire l'ordine dell'asse x.
- Gli agenti utente sono liberi di "indovinare" il valore delle proprietà non specificate dalla query. In particolare, la presenza di colonne "non interessanti" nello schema del risultato potrebbe portare a interpretazioni errate. In queste situazioni, provare a escludere queste colonne.
Nota
Esistono alcune visualizzazioni disponibili solo nei dashboard di Azure Esplora dati. Per altre informazioni, vedere Oggetti visivi specifici del dashboard.
Sintassi
T|
render
visualizzazione [with
(
propertyName=
propertyValue [,
...])
]
Altre informazioni sulle convenzioni di sintassi.
Parametri
Nome | Tipo | Obbligatoria | Descrizione |
---|---|---|---|
T | string |
✔️ | Nome tabella di input. |
Visualizzazione | string |
✔️ | Indica il tipo di visualizzazione da usare. Deve essere uno dei valori supportati nell'elenco seguente. |
propertyName, propertyValue | string |
Elenco delimitato da virgole di coppie di proprietà chiave-valore. Vedere le proprietà supportate. |
Visualizzazione
Visualizzazione | Descrizione | Illustrazione |
---|---|---|
anomalychart |
Simile a timechart, ma evidenzia le anomalie usando la funzione series_decompose_anomalies. | |
areachart |
Grafico ad area. | |
barchart |
visualizzato come strisce orizzontali. | |
card |
Il primo record dei risultati viene considerato come un set di valori scalari e viene visualizzato come una scheda. | |
columnchart |
Come barchart ma con strisce verticali invece che orizzontali. |
|
ladderchart |
Le ultime due colonne sono l'asse x, mentre le altre colonne sono assi y. | |
linechart |
grafico a linee. | |
piechart |
la prima colonna è l'asse del colore, la seconda colonna è numerica. | |
pivotchart |
Visualizza un grafico e una tabella pivot. L'utente può selezionare in modo interattivo dati, colonne, righe e vari tipi di grafico. | |
scatterchart |
Grafico a punti. | |
stackedareachart |
Grafico ad area in pila. | |
table |
Visualizzazione predefinita. I risultati vengono visualizzati come tabella. | |
timechart |
grafico a linee. La prima colonna è x-asse e deve essere datetime. Le altre colonne (numeriche) sono assi y. | |
timepivot |
Esplorazione interattiva della sequenza temporale degli eventi (con pivot sull'asse temporale) | |
treemap |
Visualizza i dati gerarchici come set di rettangoli annidati. |
Nota
I grafici a scala, il grafico pivot, il timepivot e le visualizzazioni mappa ad albero possono essere usati in Kusto.Explorer, ma non sono disponibili nell'interfaccia utente Web di Azure Esplora dati.
Visualizzazione | Descrizione | Illustrazione |
---|---|---|
areachart |
Grafico ad area. La prima colonna è l'asse x e deve essere una colonna numerica. Le altre colonne numeriche sono assi y. | |
barchart |
La prima colonna è l'asse x e può essere di tipo test, data/ora o numerico. Le altre colonne sono numeriche, visualizzate come strisce orizzontali. | |
columnchart |
Come barchart ma con strisce verticali invece che orizzontali. |
|
piechart |
la prima colonna è l'asse del colore, la seconda colonna è numerica. | |
scatterchart |
Grafico a punti. La prima colonna è l'asse x e deve essere una colonna numerica. Le altre colonne numeriche sono assi y. | |
table |
Visualizzazione predefinita. I risultati vengono visualizzati come tabella. | |
timechart |
grafico a linee. La prima colonna è l'asse x e deve essere datetime. Le altre colonne (numeriche) sono assi y. È presente una colonna stringa i cui valori vengono usati per "raggruppare" le colonne numeriche e creare righe diverse nel grafico (vengono ignorate altre colonne di stringa). |
Visualizzazione | Descrizione | Illustrazione |
---|---|---|
anomalychart |
Simile a timechart, ma evidenzia le anomalie usando la funzione series_decompose_anomalies. | |
areachart |
Grafico ad area. | |
barchart |
visualizzato come strisce orizzontali. | |
card |
Il primo record dei risultati viene considerato come un set di valori scalari e viene visualizzato come una scheda. | |
columnchart |
Come barchart ma con strisce verticali invece che orizzontali. |
|
linechart |
grafico a linee. | |
piechart |
la prima colonna è l'asse del colore, la seconda colonna è numerica. | |
scatterchart |
Grafico a punti. | |
stackedareachart |
Grafico ad area in pila. | |
table |
Visualizzazione predefinita. I risultati vengono visualizzati come tabella. | |
timechart |
grafico a linee. La prima colonna è x-asse e deve essere datetime. Le altre colonne (numeriche) sono assi y. |
Proprietà supportate
PropertyName/PropertyValue indicano informazioni aggiuntive da usare durante il rendering. Tutte le proprietà sono facoltative. Le proprietà supportate sono:
PropertyName | PropertyValue |
---|---|
accumulate |
Indica se il valore di ogni misura viene aggiunto a tutti i predecessori. (true o false ) |
kind |
Ulteriore elaborazione del tipo di visualizzazione. Per altre informazioni, vedere kind proprietà. |
legend |
Indica se visualizzare o meno una legenda (visible o hidden ). |
series |
Elenco delimitato da virgole di colonne i cui valori per record combinati definiscono la serie a cui appartiene il record. |
ymin |
Valore minimo da visualizzare sull'asse y. |
ymax |
Valore massimo da visualizzare sull'asse y. |
title |
Titolo della visualizzazione (di tipo string ). |
xaxis |
Indica la scala da applicare all'asse x (linear o log ). |
xcolumn |
Indica quale colonna del risultato viene usata per l'asse x. |
xtitle |
Titolo dell'asse x (di tipo string ). |
yaxis |
Indica la scala da applicare all'asse y (linear o log ). |
ycolumns |
Elenco delimitato da virgole di colonne costituite dai valori specificati in base al valore della colonna x. |
ysplit |
Indica come suddividere la visualizzazione in più visualizzazioni. Per altre informazioni, vedere y-split proprietà. |
ytitle |
Titolo dell'asse y (di tipo string ). |
anomalycolumns |
Proprietà pertinente solo per anomalychart . Elenco delimitato da virgole di colonne, che verranno considerate come serie anomalie e visualizzate come punti nel grafico |
PropertyName | PropertyValue |
---|---|
kind |
Ulteriore elaborazione del tipo di visualizzazione. Per altre informazioni, vedere kind proprietà. |
series |
Elenco delimitato da virgole di colonne i cui valori per record combinati definiscono la serie a cui appartiene il record. |
title |
Titolo della visualizzazione (di tipo string ). |
Proprietàkind
Questa visualizzazione può essere ulteriormente elaborata fornendo la kind
proprietà.
I valori supportati di questa proprietà sono:
Visualizzazione | kind |
Descrizione |
---|---|---|
areachart |
default |
Ogni "area" è a sé stante. |
unstacked |
Uguale a default . |
|
stacked |
Impila le "aree" a destra. | |
stacked100 |
Impila le "aree" a destra e ne estende ognuna alla stessa larghezza delle altre. | |
barchart |
default |
Ogni "barra" è a sé stante. |
unstacked |
Uguale a default . |
|
stacked |
Impila le "barre". | |
stacked100 |
Pila "barre" e estende ognuna alla stessa larghezza degli altri. | |
columnchart |
default |
Ogni "colonna" è a sé stante. |
unstacked |
Uguale a default . |
|
stacked |
Impila le "colonne" una sopra l'altra. | |
stacked100 |
Impila le "colonne" e ne estende ognuna alla stessa altezza delle altre. | |
scatterchart |
map |
Le colonne previste sono [Longitude, Latitude] o punto GeoJSON. La colonna della serie è facoltativa. Per altre informazioni, vedere Visualizzazioni geospaziali. |
piechart |
map |
Le colonne previste sono [Longitude, Latitude] o punto GeoJSON, asse colore e numerica. Supportata nella versione desktop di Kusto Explorer. Per altre informazioni, vedere Visualizzazioni geospaziali. |
Proprietàysplit
Alcune visualizzazioni supportano la suddivisione in più valori dell'asse y:
ysplit |
Descrizione |
---|---|
none |
Viene visualizzato un solo asse y per tutti i dati della serie. Valore predefinito. |
axes |
Viene visualizzato un singolo grafico con più assi y (uno per serie). |
panels |
Viene eseguito il rendering di un grafico per ogni valore di ycolumn (fino a un determinato limite). |
Come eseguire il rendering di dati continui
Diverse visualizzazioni vengono usate per il rendering di sequenze di valori, ad esempio , linechart
, timechart
e areachart
.
Queste visualizzazioni hanno il modello concettuale seguente:
- Una colonna nella tabella rappresenta l'asse x dei dati. Questa colonna può essere definita in modo esplicito usando la
xcolumn
proprietà . Se non definito, l'agente utente seleziona la prima colonna appropriata per la visualizzazione.- Ad esempio: nella visualizzazione l'agente
timechart
utente usa la primadatetime
colonna. - Se questa colonna è di tipo
dynamic
e contiene una matrice, i singoli valori della matrice verranno considerati come valori dell'asse x.
- Ad esempio: nella visualizzazione l'agente
- Una o più colonne nella tabella rappresentano una o più misure che variano in base all'asse x.
Queste colonne possono essere definite in modo esplicito usando la
ycolumns
proprietà . Se non definito, l'agente utente seleziona tutte le colonne appropriate per la visualizzazione.- Ad esempio: nella visualizzazione l'agente
timechart
utente usa tutte le colonne con un valore numerico che non è stato specificato in caso contrario. - Se l'asse x è una matrice, i valori di ogni asse y devono essere anche una matrice di lunghezza simile, con ogni asse y che si verifica in una singola colonna.
- Ad esempio: nella visualizzazione l'agente
- Zero o più colonne nella tabella rappresentano un set univoco di dimensioni che raggruppano le misure. Queste colonne possono essere specificate dalla proprietà oppure l'agente
series
utente li selezionerà automaticamente dalle colonne altrimenti non specificate.
Contenuti correlati
Nota
Il modello di dati dell'operatore render considera i dati tabulari come costituiti da tre tipi di colonne:
- La colonna dell'asse x (indicata dalla proprietà
xcolumn
). - Le colonne della serie (qualsiasi numero di colonne indicate dalla proprietà
series
). - Le colonne dell'asse y (qualsiasi numero di colonne indicate dalla proprietà
ycolumns
). Per ogni record, la serie ha tante misure ("punti" nel grafico) quante sono le colonne dell'asse y.
Esempio
InsightsMetrics
| where Computer == "DC00.NA.contosohotels.com"
| where Namespace == "Processor" and Name == "UtilizationPercentage"
| summarize avg(Val) by Computer, bin(TimeGenerated, 1h)
| render timechart
Commenti e suggerimenti
https://aka.ms/ContentUserFeedback.
Presto disponibile: Nel corso del 2024 verranno gradualmente disattivati i problemi di GitHub come meccanismo di feedback per il contenuto e ciò verrà sostituito con un nuovo sistema di feedback. Per altre informazioni, vedereInvia e visualizza il feedback per