timestats

Utilice este comando para generar datos para mostrar tendencias estadísticas a lo largo del tiempo, agrupadas opcionalmente por campo.

Sintaxis

timestats [<timestats_options>] <stats_function / timestats_function> "("<field_name>")" [as new_field_name] [, <stats_function / timestats_function> "("<field_name>")" [as new_field_name]]* [by_<field_name>]

Parámetros

En la siguiente tabla se muestran los parámetros utilizados con este comando, junto con sus descripciones.

Parámetro Descripción

timestats_options

Utilice este parámetro para especificar cómo se deben incluir los datos en el cubo. Los valores permitidos para este parámetro deben seguir el formato [span = <int><timescale>] [field = <field_name>][maxvalues = <limit>][topcount = <count> | bottomcount = <count>][name = <chart_name>].

span

Utilice este parámetro para definir el tamaño de cada cubo, utilizando una longitud de período basada en el tiempo. Los valores permitidos para este parámetro deben tener el formato <int><timescale>.

timescale

Utilice este parámetro para especificar el tiempo para ajustar el tamaño de los cubos. Los valores permitidos para este parámetro deben ser <sec>, <min>, <hour>, <day>, <week>, <month> o <year>.

Sintaxis:

sec: los valores permitidos para este parámetro incluyen s, sec, secs, second y seconds.

min: los valores permitidos para este parámetro incluyen m, min, mins, minute o minutes.

hour: los valores permitidos para este parámetro son h, hr, hrs, hour y hours.

week: los valores permitidos para este parámetro son w, week y weeks.

month: los valores permitidos para este parámetro son mon, month y months.

field

El campo debe tener un valor de registro de hora. Si no se especifica, se utiliza Time.

maxvalues

Reduzca el número de valores agregados que se devolverán para una función.

topcount

Al agrupar por campos, se devuelve el recuento de n de grupos distintos con los valores agregados más grandes.

bottomcount

Al agrupar por campos, devuelve n recuento de grupos distintos con los valores agregados más pequeños

name

Nombre que se mostrará para el gráfico.

Nota

También puede utilizar las funciones asociadas al comando stats con el comando timestats. Para obtener detalles sobre las funciones y los ejemplos de uso de las funciones con el comando, consulte stats.

Funciones

En la siguiente tabla se muestran las funciones disponibles con este comando, junto con sus ejemplos.

Función Ejemplos

persecond: devuelve un punto de datos por intervalo de tiempo que representa el ratio medio por segundo.

persecond(field_name)

  • | timestats persecond('Error Id')

perminute: devuelve un punto de datos por intervalo de tiempo que representa el ratio medio por minuto.

perminute(field_name)

  • | timestats perminute('Error Id')

perhour: devuelve un punto de datos por intervalo de tiempo que representa el ratio medio por hora.

perhour(field_name)

  • | timestats perhour('Error Id')

perday: devuelve un punto de datos por intervalo de tiempo que representa el ratio medio por día.

perday(field_name)

  • | timestats perday('Error Id')

La siguiente consulta devuelve el recuento de entradas de log fatales durante el rango de tiempo especificado.

Severity = fatal | timestats count

Con la siguiente consulta se devuelve el recuento de logs agrupados en fragmentos diarios.

* | timestats span = 1day count

Devolver el recuento de entradas de log, por destino, en el rango de tiempo especificado para los destinos de producción:

'lifecycle status'='production' | search * | timestats count by target

Gráfico de series temporales por entidad en la propiedad de grupo:

* | link Entity, Severity | stats sum('Content Size') as 'Content Size' | timestats avg('Content Size') by Entity

Gráfico de series temporales por entidad solo para logs fatales:

* | link Entity, Severity | stats sum('Content Size') as 'Content Size' | addfields [ * | where Severity = fatal | timestats avg('Content Size') by Entity ]

Limite el gráfico de series temporales a 20 valores:

* | link Entity, Severity | stats sum('Content Size') as 'Content Size' | timestats maxvalues = 20 avg('Content Size')

Devolver los gráficos de series temporales para las 3 entidades principales:

* | link Entity, Severity | stats sum('Content Size') as 'Content Size' | timestats topcount = 3 avg('Content Size') by Entity

Devolver los gráficos de series temporales para las 3 entidades inferiores:

* | link Entity, Severity | stats sum('Content Size') as 'Content Size' | timestats bottomcount = 3 avg('Content Size') by Entity