Compartilhar via


Gráfico de tempo

Um objeto visual gráfico de tempo é um tipo de gráfico de linhas. A primeira coluna da consulta é o eixo x e deve ser um datetime. Outras colunas numéricas são os eixos y. Valores de uma coluna de cadeia de caracteres usados para agrupar as colunas numéricas e criar linhas diferentes no gráfico. Outras colunas de cadeia de caracteres são ignoradas. O objeto visual gráfico de tempo é semelhante a um gráfico de linhas, exceto que o eixo x é sempre o tempo.

Observação

Essa visualização só pode ser usada no contexto do operador de renderização.

Syntax

T|rendertimechart [with(propertyName=propertyValue [, ...])]

Saiba mais sobre as convenções de sintaxe.

Parâmetros

Nome Tipo Obrigatório Descrição
T string ✔️ Nome da tabela de entrada.
propertyName, propertyValue string Uma lista separada por vírgulas de pares de propriedades chave-valor. Consulte propriedades com suporte.

Propriedades com suporte

Todas as propriedades são opcionais.

PropertyName PropertyValue
accumulate Se o valor de cada medida é adicionado a todos os seus antecessores (true ou false).
legend Se uma legenda será exibida ou não (visible ou hidden).
series Lista delimitada por vírgula de colunas cujos valores por registro combinados definem a série à qual o registro pertence.
ymin O valor mínimo a ser exibido no eixo y.
ymax O valor máximo a ser exibido no eixo y.
title O título da visualização (do tipo string).
xaxis Como dimensionar 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 dimensionar o eixo y (linear ou log).
ycolumns Lista delimitada por vírgula de colunas formadas pelos valores fornecidos por valor da coluna x.
ysplit Como dividir várias visualizações. Para obter mais informações, consulte ysplit property.
ytitle O título do eixo y (do tipo string).

Propriedade ysplit

Essa visualização dá suporte à divisão em vários valores de eixo y:

ysplit Descrição
none Um único eixo y é exibido para todos os dados de série. (Padrão)
axes Um único gráfico é exibido com vários eixos y (um por série).
panels Um gráfico é renderizado para cada valor ycolumn (até certo limite).

Exemplos

Renderizar um gráfico de tempo

let min_t = datetime(2017-01-05);
let max_t = datetime(2017-02-03 22:00);
let dt = 2h;
demo_make_series2
| make-series num=avg(num) on TimeStamp from min_t to max_t step dt by sid 
| where sid == 'TS1'   //  select a single time series for a cleaner visualization
| extend (baseline, seasonal, trend, residual) = series_decompose(num, -1, 'linefit')  //  decomposition of a set of time series to seasonal, trend, residual, and baseline (seasonal+trend)
| render timechart with(title='Web app. traffic of a month, decomposition')

Captura de tela da saída de visualização do gráfico de tempo.

Rotular um gráfico de tempo

StormEvents
| where StartTime between (datetime(2007-01-01) .. datetime(2007-12-31)) 
    and DamageCrops > 0
| summarize EventCount = count() by bin(StartTime, 7d)
| render timechart
    with (
    title="Crop damage over time",
    xtitle="Date",
    ytitle="Crop damage",
    legend=hidden
    )

Captura de tela do gráfico de tempo com rótulos.

Exibir vários eixos y

StormEvents
| where State in ("TEXAS", "NEBRASKA", "KANSAS") and EventType == "Hail"
| summarize count() by State, bin(StartTime, 1d)
| render timechart with (ysplit=panels)

Captura de tela do resultado da consulta do gráfico de tempo com a propriedade de painéis ysplit.

Propriedades com suporte

Todas as propriedades são opcionais.

PropertyName PropertyValue
series Lista delimitada por vírgula de colunas cujos valores por registro combinados definem a série à qual o registro pertence.
title O título da visualização (do tipo string).

Exemplo

let min_t = datetime(2017-01-05);
let max_t = datetime(2017-02-03 22:00);
let dt = 2h;
demo_make_series2
| make-series num=avg(num) on TimeStamp from min_t to max_t step dt by sid 
| where sid == 'TS1'   //  select a single time series for a cleaner visualization
| extend (baseline, seasonal, trend, residual) = series_decompose(num, -1, 'linefit')  //  decomposition of a set of time series to seasonal, trend, residual, and baseline (seasonal+trend)
| render timechart with(title='Web app. traffic of a month, decomposition')

Captura de tela da saída de visualização do gráfico de tempo.