operador render

  • Artigo
  • 7 minutos para ler

Instrui o agente utilizador a fazer os resultados da consulta de uma forma particular.

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

Nota

  • O operador de renderização deve ser o último operador na consulta, e utilizado apenas com consultas que produzem um único resultado de fluxo de dados tabular.
  • O operador de renderização não modifica dados. Injeta uma anotação ("Visualização") nas propriedades estendidas do resultado. A anotação contém as informações fornecidas pelo operador na consulta.
  • A interpretação da informação de visualização é feita pelo agente do utilizador. Agentes diferentes (como Kusto. Explorador, Kusto. WebExplorer) pode suportar diferentes visualizações.

Syntax

T|renderVisualização [with(PropertyNamePropertyValue= [, ...] )]

Argumentos

  • A visualização indica o tipo de visualização a utilizar. Os valores suportados são:
Visualização Descrição Exemplo
anomalychart Semelhante ao timechart, mas destaca anomalias usando series_decompose_anomalies função. Clique para executar consulta de amostra
areachart Gráfico de área. A primeira coluna é o eixo x e deve ser uma coluna numérica. Outras colunas numéricas são eixos y. Clique para executar consulta de amostra
barchart A primeira coluna é o eixo x e pode ser texto, data ou numérico. Outras colunas são numéricas, exibidas como tiras horizontais. Clique para executar consulta de amostra
card O primeiro registo de resultados é tratado como um conjunto de valores escalar e mostra como um cartão. Clique para executar consulta de amostra
columnchart Como barchart com tiras verticais em vez de tiras horizontais. Clique para executar consulta de amostra
ladderchart As duas últimas colunas são o eixo x, outras colunas são eixo y.
linechart Gráfico de linha. A primeira coluna é eixo x, e deve ser uma coluna numérica. Outras colunas numéricas são eixos y. Clique para executar consulta de amostra
piechart A primeira coluna é o eixo de cores, a segunda coluna é numérica. Clique para executar consulta de amostra
pivotchart Exibe uma mesa de pivô e um gráfico. O utilizador pode selecionar interativamente dados, colunas, linhas e vários tipos de gráficos.
scatterchart Gráfico de pontos. A primeira coluna é eixo x e deve ser uma coluna numérica. Outras colunas numéricas são eixos y. Clique para executar consulta de amostra
stackedareachart Gráfico de área empilhado. A primeira coluna é eixo x, e deve ser uma coluna numérica. Outras colunas numéricas são eixos y. Clique para executar consulta de amostra
table Predefinição - os resultados são apresentados como uma tabela. Clique para executar consulta de amostra
timechart Gráfico de linha. A primeira coluna é eixo x, e deve ser a hora da data. Outras colunas (numéricas) são eixos y. Há uma coluna de cordas cujos valores são usados para "agrupar" as colunas numéricas e criar diferentes linhas na tabela (outras colunas de cordas são ignoradas). Clique para executar consulta de amostra
timepivot Navegação interativa sobre a linha do tempo dos eventos (rotação no eixo do tempo)

Nota

As visualizações de escadote, pivô e timepivot podem ser usadas em Kusto. Explorador, mas não estão disponíveis no Azure Data Explorer Web UI.

Visualização Description
areachart Gráfico de área. A primeira coluna é o eixo x e deve ser uma coluna numérica. Outras colunas numéricas são eixos y.
barchart A primeira coluna é o eixo x e pode ser texto, data ou numérico. Outras colunas são numéricas, exibidas como tiras horizontais.
columnchart Como barchart com tiras verticais em vez de tiras horizontais.
piechart A primeira coluna é o eixo de cores, a segunda coluna é numérica.
scatterchart Gráfico de pontos. A primeira coluna é o eixo x e deve ser uma coluna numérica. Outras colunas numéricas são eixos y.
table Predefinição - os resultados são apresentados como uma tabela.
timechart Gráfico de linha. A primeira coluna é x-eixo, e deve ser a hora da data. Outras colunas (numéricas) são eixos y. Há uma coluna de cordas cujos valores são usados para "agrupar" as colunas numéricas e criar diferentes linhas na tabela (outras colunas de cordas são ignoradas).
  • /Nome de propriedadeO PropertyValue indica informações adicionais a utilizar ao fazer a renderização. Todas as propriedades são opcionais. As propriedades suportadas são:
PropertyName Valor da Propriedade
accumulate Se o valor de cada medida é adicionado a todos os seus antecessores. (true ou false)
kind Mais elaboração do tipo de visualização. Veja abaixo.
legend Quer exibindo uma lenda ou não (visible ou hidden).
series Lista de colunas com vírgulas cujos valores combinados por registo definem a série a que o registo pertence.
ymin O valor mínimo a ser mostrado no eixo Y.
ymax O valor máximo a ser visualizado no eixo Y.
title O título da visualização (do tipo string).
xaxis Como escalar o eixo x (linear ou log).
xcolumn Qual coluna no resultado é usada para o eixo x.
xtitle O título do eixo x (do tipo string).
yaxis Como escalar o eixo y (linear ou log.
ycolumns Lista de colunas delimitadas por vírgulas que consistem nos valores fornecidos por valor da coluna x.
ysplit Como dividir vários da visualização. Veja abaixo.
ytitle O título do eixo y (do tipo string).
anomalycolumns Imóveis relevantes apenas para anomalychart. Lista de colunas delimitadas por vírgulas que serão consideradas séries de anomalias e exibidas como pontos na tabela
PropertyName Valor da Propriedade
kind Mais elaboração do tipo de visualização. Veja abaixo.
series Lista de colunas com vírgulas cujos valores combinados por registo definem a série a que o registo pertence.
title O título da visualização (do tipo string).

Algumas visualizações podem ser ainda elaboradas fornecendo a kind propriedade. Esses avisos são:

Visualização kind Description
areachart default Cada "área" fica por si só.
unstacked O mesmo que default.
stacked Empilhe "áreas" para a direita.
stacked100 Empilhe "áreas" para a direita e estique cada uma com a mesma largura que as outras.
barchart default Cada "bar" fica por si só.
unstacked O mesmo que default.
stacked Empilhar "bares".
stacked100 Empilhe "barras" e estique cada um na mesma largura que os outros.
columnchart default Cada "coluna" está por si só.
unstacked O mesmo que default.
stacked Empilhe "colunas" uma em cima da outra.
stacked100 Empilhe "colunas" e estique cada uma à mesma altura que as outras.
scatterchart map As colunas esperadas são [Longitude, Latitude] ou GeoJSON. A coluna da série é opcional.
piechart map As colunas esperadas são [Longitude, Latitude] ou Ponto GeoJSON, eixo de cor e numérico. Suportado no ambiente de trabalho Kusto Explorer.

Algumas visualizações suportam a divisão em múltiplos valores do eixo y:

ysplit Description
none É apresentado um único eixo y para todos os dados da série. (Predefinição)
axes Um único gráfico é apresentado com vários eixos y (um por série).
panels Um gráfico é renderizado por cada ycolumn valor (até algum limite).

Nota

O modelo de dados do operador de renderização olha para os dados tabulares como se tivesse três tipos de colunas:

  • A coluna do eixo x (indicada pela xcolumn propriedade).
  • As colunas da série (qualquer número de colunas indicadas pela series propriedade.) Para cada registo, os valores combinados destas colunas definem uma única série, e o gráfico tem tantas séries quanto valores combinados distintos.
  • As colunas do eixo y (qualquer número de colunas indicadas pela ycolumns propriedade). Para cada registo, a série tem tantas medições ("pontos" na tabela) como existem colunas de eixo y.

Dica

  • Utilizar where, summarize e top limitar o volume que exibe.
  • Ordenar os dados para definir a ordem do eixo x.
  • Os agentes utilizadores são livres de "adivinhar" o valor das propriedades que não são especificadas pela consulta. Em particular, ter colunas "desinteressantes" no esquema do resultado pode traduzir-se em palpites errados. Tente projetar tais colunas quando isso acontecer.

Exemplo

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)

Dar exemplos no tutorial

Deteção de anomalias

Nota

O modelo de dados do operador de renderização olha para os dados tabulares como se tivesse três tipos de colunas:

  • A coluna do eixo x (indicada pela xcolumn propriedade).
  • As colunas da série (qualquer número de colunas indicadas pela series propriedade.)
  • As colunas do eixo y (qualquer número de colunas indicadas pela ycolumns propriedade). Para cada registo, a série tem tantas medições ("pontos" na tabela) como existem colunas de eixo y.

Dica

  • Utilizar where, summarize e top limitar o volume que exibe.
  • Ordenar os dados para definir a ordem do eixo x.
  • Os agentes utilizadores são livres de "adivinhar" o valor das propriedades que não são especificadas pela consulta. Em particular, ter colunas "desinteressantes" no esquema do resultado pode traduzir-se em palpites errados. Tente projetar tais colunas quando isso acontecer.

Exemplo

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

Dar exemplos no tutorial