Operatore renderrender operator

Indica all'agente utente di eseguire il rendering dei risultati della query in un determinato modo.Instructs the user agent to render the results of the query in a particular way.

range x from 0.0 to 2*pi() step 0.01 | extend y=sin(x) | render linechart

Nota

  • L'operatore render deve essere l'ultimo operatore della query e deve essere usato solo con query che producono un singolo risultato del flusso TDS.The render operator should be the last operator in the query, and used only with queries that produce a single tabular data stream result.
  • L'operatore render non modifica i dati.The render operator does not modify data. Inserisce un'annotazione ("visualizzazione") nelle proprietà estese del risultato.It injects an annotation ("Visualization") into the result's extended properties. L'annotazione contiene le informazioni fornite dall'operatore nella query.The annotation contains the information provided by the operator in the query.
  • L'interpretazione delle informazioni della visualizzazione viene eseguita dall'agente utente.The interpretation of the visualization information is done by the user agent. Agenti diversi (come Kusto.Explorer, Kusto.WebExplorer) potrebbero supportare visualizzazioni diverse.Different agents (such as Kusto.Explorer,Kusto.WebExplorer) might support different visualizations.

SintassiSyntax

T | render Visualization [with ( PropertyName = PropertyValue [, ...] )]T | render Visualization [with ( PropertyName = PropertyValue [, ...] )]

Dove:Where:

  • Visualization indica il tipo di visualizzazione da usare.Visualization indicates the kind of visualization to use. I valori supportati sono:The supported values are:
VisualizzazioneVisualization DescrizioneDescription
anomalychart Simile a timechart, ma evidenzia le anomalie usando la funzione series_decompose_anomalies.Similar to timechart, but highlights anomalies using series_decompose_anomalies function.
areachart Grafico ad area.Area graph. La prima colonna è l'asse x e deve essere una colonna numerica.First column is the x-axis and should be a numeric column. Le altre colonne numeriche sono assi y.Other numeric columns are y-axes.
barchart La prima colonna è l'asse x e può essere di tipo test, data/ora o numerico.First column is the x-axis and can be text, datetime or numeric. Le altre colonne sono numeriche, visualizzate come strisce orizzontali.Other columns are numeric, displayed as horizontal strips.
card Il primo record dei risultati viene considerato come un set di valori scalari e viene visualizzato come una scheda.First result record is treated as set of scalar values and shows as a card.
columnchart Come barchart ma con strisce verticali invece che orizzontali.Like barchart with vertical strips instead of horizontal strips.
ladderchart Le ultime due colonne sono l'asse x, mentre le altre colonne sono assi y.Last two columns are the x-axis, other columns are y-axis.
linechart grafico a linee.Line graph. La prima colonna è l'asse x e deve essere una colonna numerica.First column is x-axis, and should be a numeric column. Le altre colonne numeriche sono assi y.Other numeric columns are y-axes.
piechart la prima colonna è l'asse del colore, la seconda colonna è numerica.First column is color-axis, second column is numeric.
pivotchart Visualizza un grafico e una tabella pivot.Displays a pivot table and chart. L'utente può selezionare in modo interattivo dati, colonne, righe e vari tipi di grafico.User can interactively select data, columns, rows and various chart types.
scatterchart Grafico a punti.Points graph. La prima colonna è l'asse x e deve essere una colonna numerica.First column is x-axis and should be a numeric column. Le altre colonne numeriche sono assi y.Other numeric columns are y-axes.
stackedareachart Grafico ad area in pila.Stacked area graph. La prima colonna è l'asse x e deve essere una colonna numerica.First column is x-axis, and should be a numeric column. Le altre colonne numeriche sono assi y.Other numeric columns are y-axes.
table Visualizzazione predefinita. I risultati vengono visualizzati come tabella.Default - results are shown as a table.
timechart grafico a linee.Line graph. La prima colonna è l'asse x e deve essere datetime.First column is x-axis, and should be datetime. Le altre colonne (numeriche) sono assi y.Other (numeric) columns are y-axes. È presente una colonna stringa i cui valori vengono usati per raggruppare le colonne numeriche e creare diverse righe nel grafico (le altre colonne stringa vengono ignorate).There is one string column whose values are used to "group" the numeric columns and create different lines in the chart (further string columns are ignored).
timepivot Esplorazione interattiva della sequenza temporale degli eventi (con pivot sull'asse temporale)Interactive navigation over the events time-line (pivoting on time axis)
VisualizzazioneVisualization DescrizioneDescription
areachart Grafico ad area.Area graph. La prima colonna è l'asse x e deve essere una colonna numerica.First column is the x-axis and should be a numeric column. Le altre colonne numeriche sono assi y.Other numeric columns are y-axes.
barchart La prima colonna è l'asse x e può essere di tipo test, data/ora o numerico.First column is the x-axis and can be text, datetime or numeric. Le altre colonne sono numeriche, visualizzate come strisce orizzontali.Other columns are numeric, displayed as horizontal strips.
columnchart Come barchart ma con strisce verticali invece che orizzontali.Like barchart with vertical strips instead of horizontal strips.
piechart la prima colonna è l'asse del colore, la seconda colonna è numerica.First column is color-axis, second column is numeric.
scatterchart Grafico a punti.Points graph. La prima colonna è l'asse x e deve essere una colonna numerica.First column is the x-axis and should be a numeric column. Le altre colonne numeriche sono assi y.Other numeric columns are y-axes.
table Visualizzazione predefinita. I risultati vengono visualizzati come tabella.Default - results are shown as a table.
timechart grafico a linee.Line graph. La prima colonna è l'asse x e deve essere datetime.First column is x-axis, and should be datetime. Le altre colonne (numeriche) sono assi y.Other (numeric) columns are y-axes. È presente una colonna stringa i cui valori vengono usati per raggruppare le colonne numeriche e creare diverse righe nel grafico (le altre colonne stringa vengono ignorate).There is one string column whose values are used to "group" the numeric columns and create different lines in the chart (further string columns are ignored).
  • PropertyName/PropertyValue indicano informazioni aggiuntive da usare durante il rendering.PropertyName/PropertyValue indicate additional information to use when rendering. Tutte le proprietà sono facoltative.All properties are optional. Le proprietà supportate sono:The supported properties are:
PropertyNamePropertyName PropertyValuePropertyValue
accumulate Indica se il valore di ogni misura viene aggiunto a tutti i predecessori.Whether the value of each measure gets added to all its predecessors. (true o false)(true or false)
kind Ulteriore elaborazione del tipo di visualizzazione.Further elaboration of the visualization kind. Vedere qui di seguito.See below.
legend Indica se visualizzare o meno una legenda (visible o hidden).Whether to display a legend or not (visible or hidden).
series Elenco delimitato da virgole di colonne i cui valori per record combinati definiscono la serie a cui appartiene il record.Comma-delimited list of columns whose combined per-record values define the series that record belongs to.
ymin Valore minimo da visualizzare sull'asse y.The minimum value to be displayed on Y-axis.
ymax Valore massimo da visualizzare sull'asse y.The maximum value to be displayed on Y-axis.
title Titolo della visualizzazione (di tipo string).The title of the visualization (of type string).
xaxis Indica la scala da applicare all'asse x (linear o log).How to scale the x-axis (linear or log).
xcolumn Indica quale colonna del risultato viene usata per l'asse x.Which column in the result is used for the x-axis.
xtitle Titolo dell'asse x (di tipo string).The title of the x-axis (of type string).
yaxis Indica la scala da applicare all'asse y (linear o log).How to scale the y-axis (linear or log).
ycolumns Elenco delimitato da virgole di colonne costituite dai valori specificati in base al valore della colonna x.Comma-delimited list of columns that consist of the values provided per value of the x column.
ysplit Indica come suddividere la visualizzazione in più visualizzazioni.How to split multiple the visualization. Vedere qui di seguito.See below.
ytitle Titolo dell'asse y (di tipo string).The title of the y-axis (of type string).
anomalycolumns Proprietà pertinente solo per anomalychart.Property relevant only for anomalychart. Elenco delimitato da virgole di colonne che verranno considerate come serie di anomalie e visualizzate come punti nel grafico.Comma-delimited list of columns which will be considered as anomaly series and displayed as points on the chart
PropertyNamePropertyName PropertyValuePropertyValue
kind Ulteriore elaborazione del tipo di visualizzazione.Further elaboration of the visualization kind. Vedere qui di seguito.See below.
series Elenco delimitato da virgole di colonne i cui valori per record combinati definiscono la serie a cui appartiene il record.Comma-delimited list of columns whose combined per-record values define the series that record belongs to.
title Titolo della visualizzazione (di tipo string).The title of the visualization (of type string).
yaxis Indica la scala da applicare all'asse y (linear o log).How to scale the y-axis (linear or log).

Alcune visualizzazioni possono essere elaborate ulteriormente specificando la proprietà kind.Some visualizations can be further elaborated by providing the kind property. Si tratta di:These are:

VisualizzazioneVisualization kind DescrizioneDescription
areachart default Ogni "area" è a sé stante.Each "area" stands on its own.
unstacked Uguale a default.Same as default.
stacked Impila le "aree" a destra.Stack "areas" to the right.
stacked100 Impila le "aree" a destra e ne estende ognuna alla stessa larghezza delle altre.Stack "areas" to the right and stretch each one to the same width as the others.
barchart default Ogni "barra" è a sé stante.Each "bar" stands on its own.
unstacked Uguale a default.Same as default.
stacked Impila le "barre".Stack "bars".
stacked100 Eseguire lo stack delle "barre" e estenderle ognuna alla stessa larghezza degli altri.Stack "bars" and stretch each one to the same width as the others.
columnchart default Ogni "colonna" è a sé stante.Each "column" stands on its own.
unstacked Uguale a default.Same as default.
stacked Impila le "colonne" una sopra l'altra.Stack "columns" one atop the other.
stacked100 Impila le "colonne" e ne estende ognuna alla stessa altezza delle altre.Stack "columns" and stretch each one to the same height as the others.
scatterchart map Le colonne previste sono [Longitude, Latitude] o punto GeoJSON.Expected columns are [Longitude, Latitude] or GeoJSON point. La colonna della serie è facoltativa.Series column is optional.
piechart map Le colonne previste sono [Longitude, Latitude] o punto GeoJSON, asse colore e numerica.Expected columns are [Longitude, Latitude] or GeoJSON point, color-axis and numeric. Supportata nella versione desktop di Kusto Explorer.Supported in Kusto Explorer desktop.

Alcune visualizzazioni supportano la suddivisione in più valori dell'asse y:Some visualizations support splitting into multiple y-axis values:

ysplit DescrizioneDescription
none Viene visualizzato un solo asse y per tutti i dati della serie.A single y-axis is displayed for all series data. Valore predefinito.(Default)
axes Viene visualizzato un singolo grafico con più assi y (uno per serie).A single chart is displayed with multiple y-axes (one per series).
panels Viene eseguito il rendering di un grafico per ogni valore di ycolumn (fino a un determinato limite).One chart is rendered for each ycolumn value (up to some limit).

Nota

Il modello di dati dell'operatore render considera i dati tabulari come costituiti da tre tipi di colonne:The data model of the render operator looks at the tabular data as if it has three kinds of columns:

  • La colonna dell'asse x (indicata dalla proprietà xcolumn).The x axis column (indicated by the xcolumn property).
  • Le colonne della serie (qualsiasi numero di colonne indicate dalla proprietà series). Per ogni record, i valori combinati di queste colonne definiscono una singola serie e il grafico ha tante serie quanti sono i valori combinati distinti.The series columns (any number of columns indicated by the series property.) For each record, the combined values of these columns defines a single series, and the chart has as many series as there are distinct combined values.
  • Le colonne dell'asse y (qualsiasi numero di colonne indicate dalla proprietà ycolumns).The y axis columns (any number of columns indicated by the ycolumns property). Per ogni record, la serie ha tante misure ("punti" nel grafico) quante sono le colonne dell'asse y.For each record, the series has as many measurements ("points" in the chart) as there are y-axis columns.

Suggerimento

  • Usare where, summarize e top per limitare la quantità di dati visualizzati.Use where, summarize and top to limit the volume that you display.
  • Disporre i dati per definire l'ordine dell'asse x.Sort the data to define the order of the x-axis.
  • Gli agenti utente sono liberi di "indovinare" il valore delle proprietà non specificate dalla query.User agents are free to "guess" the value of properties that are not specified by the query. In particolare, la presenza di colonne "non interessanti" nello schema del risultato potrebbe portare a interpretazioni errate.In particular, having "uninteresting" columns in the schema of the result might translate into them guessing wrong. In queste situazioni, provare a escludere queste colonne.Try projecting-away such columns when that happens.

EsempioExample

range x from -2 to 2 step 0.1
| extend sin = sin(x), cos = cos(x)
| extend x_sign = iif(x > 0, "x_pos", "x_neg")
| extend sum_sign = iif(sin + cos > 0, "sum_pos", "sum_neg")
| render linechart with  (ycolumns = sin, cos, series = x_sign, sum_sign)

Esempi di rendering nell'esercitazioneRendering examples in the tutorial

Rilevamento anomalieAnomaly detection

Nota

Il modello di dati dell'operatore render considera i dati tabulari come costituiti da tre tipi di colonne:The data model of the render operator looks at the tabular data as if it has three kinds of columns:

  • La colonna dell'asse x (indicata dalla proprietà xcolumn).The x axis column (indicated by the xcolumn property).
  • Le colonne della serie (qualsiasi numero di colonne indicate dalla proprietà series).The series columns (any number of columns indicated by the series property.)
  • Le colonne dell'asse y (qualsiasi numero di colonne indicate dalla proprietà ycolumns).The y axis columns (any number of columns indicated by the ycolumns property). Per ogni record, la serie ha tante misure ("punti" nel grafico) quante sono le colonne dell'asse y.For each record, the series has as many measurements ("points" in the chart) as there are y-axis columns.

Suggerimento

  • Usare where, summarize e top per limitare la quantità di dati visualizzati.Use where, summarize and top to limit the volume that you display.
  • Disporre i dati per definire l'ordine dell'asse x.Sort the data to define the order of the x-axis.
  • Gli agenti utente sono liberi di "indovinare" il valore delle proprietà non specificate dalla query.User agents are free to "guess" the value of properties that are not specified by the query. In particolare, la presenza di colonne "non interessanti" nello schema del risultato potrebbe portare a interpretazioni errate.In particular, having "uninteresting" columns in the schema of the result might translate into them guessing wrong. In queste situazioni, provare a escludere queste colonne.Try projecting-away such columns when that happens.

EsempioExample

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

Esempi di rendering nell'esercitazioneRendering examples in the tutorial