get_histograms CLI command - query log distribution - Simple Log Service

Consulta la distribución de los registros que cumplen con las condiciones especificadas en un logstore y devuelve el recuento de registros dentro de cada intervalo de tiempo.

Sintaxis del comando

aliyunlog log get_histograms --request=<value> [--access-id=<value>] [--access-key=<value>] [--sts-token=<value>] [--region-endpoint=<value>] [--client-name=<value>] [--jmes-filter=<value>] [--format-output=<value>] [--decode-output=<value>]

Parámetros del comando

Parámetros obligatorios para este comando:

Parámetro	Tipo	Obligatorio	Ejemplo	Descripción
--request	JSON Object	Sí	file://./gethistograms.json	Ruta al archivo de configuración que contiene los parámetros de consulta de registros.

Para obtener más información sobre los parámetros globales de este comando, consulte Global parameters.

Ejemplo de comando

En este ejemplo se utiliza un archivo gethistograms.json para consultar la distribución de registros donde request_method es PUT y status es 200 dentro de un intervalo especificado.

Registro sin procesar de ejemplo:

body_bytes_sent:1750
host:www.example.com
http_referer:www.example.com
http_user_agent:Mozilla/5.0 (Macintosh; U; Intel Mac OS X 10_6_6; it-it) AppleWebKit/533.20.25 (KHTML, like Gecko) Version/5.0.4 Safari/533.20.27
http_x_forwarded_for:203.0.103.10
remote_addr:203.0.103.10
remote_user:p288
request_length:13741
request_method:GET
request_time:71
request_uri:/request/path-1/file-1
status:200
time_local:11/Aug/2021:06:52:27
upstream_response_time:0.66

Cree un archivo gethistograms.json para consultar los registros donde request_method es PUT y status es 200 durante los últimos 15 minutos:

{
"topic": "",
"logstore": "logstore-a",
"project": "aliyun-test-project",
"toTime": "2023-03-03 14:30:41",
"query": "request_method:PUT and status:200",
"fromTime": "2023-03-03 14:15:41"
}

Parámetros:

Parámetro	Descripción
topic	El tema del registro.
logstore	El nombre del logstore.
project	El nombre del proyecto.
toTime	Fin del intervalo de tiempo de la consulta. Ejemplo: 2023-03-03 14:30:41.
query	La instrucción de búsqueda. Solo se admiten `instrucciones de búsqueda`. No se admiten `instrucciones analíticas`. Para obtener más información, consulte Search syntax and functions.
fromTime	Inicio del intervalo de tiempo de la consulta. Ejemplo: 2023-03-03 14:15:41.

Ejecute el comando:

aliyunlog log get_histograms --request="file://./gethistograms.json" --format-output=json

Respuesta de ejemplo:

[
  {
    "count": 18,
    "from": 1677824141,
    "progress": "Complete",
    "to": 1677824160
  },
  {
    "count": 37,
    "from": 1677824160,
    "progress": "Complete",
    "to": 1677824190
  },
 ......
  {
    "count": 30,
    "from": 1677825000,
    "progress": "Complete",
    "to": 1677825030
  },
  {
    "count": 0,
    "from": 1677825030,
    "progress": "Complete",
    "to": 1677825041
  }
]

Referencias

La documentación de Simple Log Service proporciona ejemplos sobre cómo invocar la operación GetHistograms mediante el SDK de Simple Log Service para Java. Para obtener más información, consulte Use GetHistograms to query the distribution of logs.
Error codes.
Además de su SDK nativo, SLS también es compatible con los SDK comunes de Alibaba Cloud. Para obtener más información, consulte Simple Log Service_SDK Center_Alibaba Cloud OpenAPI Explorer.
Para obtener más información sobre la operación de API, consulte GetHistograms.