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.
-
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 -
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 pesquisasão suportadas.Instruções analíticasnã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.
-
Execute o comando:
aliyunlog log get_histograms --request="file://./gethistograms.json" --format-output=jsonExemplo 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
A documentação do Simple Log Service fornece exemplos de como chamar a operação GetHistograms usando o Simple Log Service SDK for Java. Para obter mais informações, consulte Usar GetHistograms para consultar a distribuição de logs.
Além de seu SDK nativo, o SLS também suporta os SDKs comuns da Alibaba Cloud. Para obter mais informações, consulte Simple Log Service_SDK Center_Alibaba Cloud OpenAPI Explorer.
Para obter mais informações sobre a operação de API, consulte GetHistograms.