Compartir a través de


Gráfico de hora

Se aplica a: ✅Microsoft FabricAzure Data Explorer✅Azure MonitorMicrosoft Sentinel

Un objeto visual de tipo gráfico de tiempo es una clase de gráfico de líneas. La primera columna de la consulta es el eje X y debe ser una fecha y hora. Las otras columnas numéricas son los ejes Y. Los valores de una columna de cadena se utilizan para agrupar las columnas numéricas y crear líneas diferentes en el gráfico. Se omiten las demás columnas de cadena. El objeto visual de gráfico de tiempo es como un gráfico de líneas, excepto que el eje X siempre es la hora.

Nota:

Esta visualización solo se puede usar en el contexto del operador render.

Sintaxis

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

Obtenga más información sobre las convenciones de sintaxis.

Parámetros

Nombre Type Obligatorio Descripción
T string ✔️ Nombre de la tabla de entrada.
propertyName, propertyValue string Lista separada por comas de pares de propiedades clave-valor. Consulte las propiedades admitidas.

Propiedades admitidas

Todas las propiedades son opcionales.

PropertyName PropertyValue
accumulate Indica si el valor de cada medida se agrega a todos sus predecesores (true o false).
legend Indica si se va a mostrar una leyenda o no (visible o hidden).
series Lista delimitada por comas de columnas cuyos valores por registro combinados definen la serie a la que pertenece el registro.
ymin Valor mínimo que se va a mostrar en el eje Y.
ymax Valor máximo que se va a mostrar en el eje Y.
title Título de la visualización (de tipo string).
xaxis Cómo se escala el eje X (linear o log).
xcolumn Qué columna del resultado se usa para el eje X.
xtitle Título del eje X (de tipo string).
yaxis Cómo se escala el eje Y (linear o log).
ycolumns Lista delimitada por comas de las columnas que se componen de los valores proporcionados por valor de la columna X.
ysplit Cómo dividir varias visualizaciones. Para obtener más información, consulte la ysplit propiedad .
ytitle Título del eje Y (de tipo string).

Propiedad ysplit

Esta visualización admite la división en varios valores del eje Y:

ysplit Descripción
none Se muestra un solo eje Y para todos los datos de la serie. (Es el valor predeterminado).
axes Se muestra un solo gráfico con varios ejes Y (uno por serie).
panels Un gráfico se representa para cada valor ycolumn (hasta un límite).

Ejemplos

Representar un gráfico de tiempo

En el ejemplo siguiente se representa un gráfico de tiempo con un título "Aplicación web". tráfico durante un mes, descomponentes" que descompone los datos en componentes de línea base, estacional, tendencia y residual.

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 pantalla de la salida de visualización del gráfico de tiempo.

Etiquetar un gráfico de tiempo

En el ejemplo siguiente se representa un gráfico de tiempo que muestra los daños de recorte agrupados por semana. El eje x del gráfico de tiempo se desble "Fecha" y el eje y se desbaste "Daño de recorte".

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 pantalla del gráfico de tiempo con etiquetas.

Ver varios ejes y

En el ejemplo siguiente se representan eventos de granizo diarios en los estados de Texas, Nebraska y Kansas. La visualización usa la ysplit propiedad para representar los eventos de cada estado en paneles independientes para la comparación.

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

Captura de pantalla del resultado de la consulta del gráfico de tiempo con la propiedad ysplit paneles.

Propiedades admitidas

Todas las propiedades son opcionales.

PropertyName PropertyValue
series Lista delimitada por comas de columnas cuyos valores por registro combinados definen la serie a la que pertenece el registro.
title Título de la visualización (de tipo string).

Ejemplo

En el ejemplo siguiente se representa un gráfico de tiempo con un título "Aplicación web". tráfico durante un mes, descomponentes" que descompone los datos en componentes de línea base, estacional, tendencia y residual.

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 pantalla de la salida de visualización del gráfico de tiempo.