Todos os produtos
Search
Central de documentação

Simple Log Service:pull_log

Última atualização: Jul 03, 2026

Recupera dados de log de um shard específico em um intervalo de tempo definido.

Sintaxe da solicitação

aliyunlog log pull_log --project_name=<value> --logstore_name=<value> --shard_id=<value> --from_time=<value> --to_time=<value> [--batch_size=<value>] [--compress=<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 da solicitação

A tabela a seguir descreve os parâmetros disponíveis.

Nome do parâmetro

Tipo

Obrigatório

Exemplo

Descrição

--project_name

String

Sim

aliyun-test-project

Nome do projeto.

--logstore_name

String

Sim

logstore-a

Nome do Logstore.

--shard_id

Integer

Sim

0

ID do shard.

--from_time

String

Sim

2021-06-01 18:15:00+8:00

Hora de início. Use um timestamp UNIX ou o formato ”%Y-%m-%d %H:%M:%S<time_zone>”. Exemplo: ”2018-01-02 12:12:10+8:00”.

--to_time

String

Sim

2021-06-01 18:18:00+8:00

Hora de término. Use um timestamp UNIX ou o formato ”%Y-%m-%d %H:%M:%S<time_zone>”. Exemplo: ”2018-01-02 12:12:10+8:00”.

--batch_size

String

Não

1000

Número de logs por lote.

--compress

Boolean

Não

true

Indica se os dados de log retornados serão compactados.

  • true (padrão): compacta os dados de log antes do retorno.

  • false: retorna os dados de log sem compactação.

Para opções compartilhadas da CLI, consulte Parâmetros globais.

Exemplos

  • Exemplo de solicitação

    Recupere logs de um intervalo de tempo com a conta padrão:

    aliyunlog log pull_log --project_name="ali-test-project" --logstore_name="nginx-moni" --shard_id=0 --from_time="2023-03-02 10:05:54" --to_time="2023-03-02 10:20:54" --format-output=json,no_escape
  • Exemplo de resposta

    {
      "count": 20,
      "logs": [
        {
          "__source__": "30.15.*.125",
          "__tag__:__client_ip__": "124.89.*.166",
          "__tag__:__receive_time__": "1719382997",
          "__time__": 1719382927,
          "__topic__": "",
          "request_method": "GET",
          "status": "200"
        },
        {
          "__source__": "30.15.*.125",
          "__tag__:__client_ip__": "124.89.*.166",
          "__tag__:__receive_time__": "1719382997",
          "__time__": 1719382927,
          "__topic__": "",
          "request_method": "POST",
          "status": "200"
        }
       ],
      "next_cursor": "MTcxOTIwOTUyMDQ5MjY3ODUxNw=="
    }
    {
      "count": 0,
      "logs": [],
      "next_cursor": "MTcxOTIwOTUyMDQ5MjY3ODUxNw=="
    }

Para dicas de solução de problemas, consulte as Perguntas frequentes sobre a CLI.