Partilhar via


Gráfico de tempo

Aplica-se a: ✅Microsoft FabricAzure Data ExplorerAzure MonitorMicrosoft Sentinel

Um gráfico de tempo visual é um tipo de gráfico de linhas. A primeira coluna da consulta é o eixo x e deve ser uma data/hora. Outras colunas numéricas são eixos y. Os valores de uma coluna de cadeia de caracteres são usados para agrupar as colunas numéricas e criar linhas diferentes no gráfico. Outras colunas de cadeia de caracteres são ignoradas. O visual do gráfico de tempo é como 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 .

Sintaxe

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

Saiba mais sobre convenções de sintaxe.

Parâmetros

Designação 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. Consulte propriedades suportadas.

Propriedades suportadas

Todas as propriedades são opcionais.

PropertyName PropertyValue
accumulate Se o valor de cada medida é adicionado a todas as suas antecessoras (true ou false).
legend Exibir ou não uma legenda (visible ou hidden).
series Lista delimitada por vírgulas de colunas cujos valores combinados por registro 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írgulas de colunas que consistem nos valores fornecidos por valor da coluna x.
ysplit Como dividir a visualização em vários valores do eixo y. Para obter mais informações, consulte 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 do eixo y:

ysplit Descrição
none Um único eixo y é exibido para todos os dados da 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 ycolumn valor. Máximo de cinco painéis.

Exemplos

O exemplo nesta seção mostra como usar a sintaxe para ajudá-lo a começar.

Os exemplos neste artigo usam tabelas disponíveis publicamente no de cluster de ajuda, como a tabela StormEvents no banco de dados Samples.

Os exemplos neste artigo usam tabelas disponíveis publicamente, como a tabela StormEvents na análise do tempo dados de exemplo.

Renderizar um gráfico de tempo

O exemplo a seguir renderiza um gráfico de tempo com um título "Web app. tráfego ao longo de um mês, em decomposição" que decompõe os dados em componentes de base, sazonais, de tendência e residuais.

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 over a month, decomposition')

Captura de tela da saída de visualização de timechart.

Rotular um gráfico de tempo

O exemplo a seguir renderiza um gráfico de tempo que mostra os danos à colheita agrupados por semana. O rótulo do gráfico de tempo x eixo é "Data" e o rótulo do eixo y é "Danos na colheita".

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 timechart com rótulos.

Ver vários eixos y

O exemplo a seguir renderiza eventos diários de granizo nos estados do Texas, Nebraska e Kansas. A visualização usa a propriedade ysplit para renderizar os eventos de cada estado em painéis separados para comparação.

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 ysplit panels.

Propriedades suportadas

Todas as propriedades são opcionais.

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

Exemplo

O exemplo a seguir renderiza um gráfico de tempo com um título "Web app. tráfego ao longo de um mês, em decomposição" que decompõe os dados em componentes de base, sazonais, de tendência e residuais.

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 de timechart.