Share via


Gráfico de tempo

Um elemento visual de 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 eixos y. São utilizados valores de uma coluna de cadeia para agrupar as colunas numéricas e criar linhas diferentes no gráfico. Outras colunas de cadeia são ignoradas. O elemento visual do gráfico de tempo é semelhante a um gráfico de linhas , exceto que o eixo x é sempre tempo.

Nota

Esta visualização só pode ser utilizada no contexto do operador de composição.

Syntax

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

Saiba mais sobre as convenções de sintaxe.

Parâmetros

Nome Tipo Necessá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. Veja as propriedades suportadas.

Propriedades suportadas

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 Quer apresente ou não uma legenda (visible ou hidden).
series Lista delimitada por vírgulas de colunas cujos valores combinados por registo definem a série à qual o registo pertence.
ymin O valor mínimo a apresentar no eixo Y.
ymax O valor máximo a apresentar no eixo Y.
title O título da visualização (do tipo string).
xaxis Como dimensionar o eixo x (linear ou log).
xcolumn Que coluna no resultado é utilizada 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írgulas de colunas que consistem nos valores fornecidos por valor da coluna x.
ysplit Como dividir múltiplas visualizações. Para obter mais informações, veja ysplit propriedade.
ytitle O título do eixo y (do tipo string).

ysplit propriedade

Esta visualização suporta a divisão em vários valores de 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 É composto um gráfico para cada ycolumn valor (até algum limite).

Exemplos

Compor 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 ecrã a mostrar a saída da visualização do gráfico de tempo.

Etiquetar 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 ecrã do gráfico de tempo com etiquetas.

Ver 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 ecrã a mostrar o resultado da consulta do gráfico de tempo com a propriedade painéis ysplit.

Propriedades suportadas

Todas as propriedades são opcionais.

PropertyName PropertyValue
series Lista delimitada por vírgulas de colunas cujos valores combinados por registo definem a série à qual o registo 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 ecrã a mostrar a saída da visualização do gráfico de tempo.