Todos os produtos
Search
Central de documentação

Simple Log Service:get_histograms

Última atualização: Jul 03, 2026

Consulta a distribuição de logs que correspondem às condições especificadas em um Logstore e retorna a contagem de logs dentro de cada intervalo de tempo.

Sintaxe do 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 do comando

Parâmetros obrigatórios para este comando:

Parâmetro

Tipo

Obrigatório

Exemplo

Descrição

--request

JSON Object

Sim

file://./gethistograms.json

Caminho para o arquivo de configuração que contém os parâmetros de consulta de log.

Para obter mais informações sobre os parâmetros globais deste comando, consulte Parâmetros globais.

Exemplo de comando

Este exemplo utiliza um arquivo gethistograms.json para consultar a distribuição de logs em que request_method é PUT e status é 200 dentro de um intervalo especificado.

  1. Exemplo de log bruto:

    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
  2. Crie um arquivo gethistograms.json para consultar logs em que request_method é PUT e status é 200 nos ú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

    Descrição

    topic

    O tópico do log.

    logstore

    O nome do Logstore.

    project

    O nome do projeto.

    toTime

    Fim do intervalo de tempo da consulta. Exemplo: 2023-03-03 14:30:41.

    query

    A instrução de pesquisa. Apenas instruções de pesquisa são suportadas. Instruções analíticas não são suportadas. Para obter mais informações, consulte Sintaxe e funções de pesquisa.

    fromTime

    Início do intervalo de tempo da consulta. Exemplo: 2023-03-03 14:15:41.

  3. Execute o comando:

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

    Exemplo de resposta:

    [
      {
        "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
      }
    ]

Referências