Todos os produtos
Search
Central de documentação

Simple Log Service:get_log

Última atualização: Jul 03, 2026

Consulta um número especificado de logs em um Logstore.

Sintaxe da solicitação

aliyunlog log get_log --project=<value> --logstore=<value> --from_time=<value> --to_time=<value> [--topic=<value>] [--query=<value>] [--reverse=<value>] [--offset=<value>] [--size=<value>] [--power_sql=<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>] [--profile=<value>]

Parâmetros da solicitação

A tabela a seguir lista os parâmetros específicos do comando.

Nome do parâmetro

Tipo de dados

Obrigatório

Valor de exemplo

Descrição

--project

String

Sim

aliyun-test-project

Nome do projeto.

--logstore

String

Sim

logstore-a

Nome do Logstore.

--from_time

String

Sim

2021-05-28 15:33:00+8:00

Início do intervalo de tempo da consulta. Especifique como timestamp UNIX ou no formato "%Y-%m-%d %H:%M:%S<time_zone>" . Exemplo: "2018-01-02 12:12:10+8:00".

--to_time

String

Sim

2021-05-28 15:40:00+8:00

Fim do intervalo de tempo da consulta. Especifique como timestamp UNIX ou no formato "%Y-%m-%d %H:%M:%S<time_zone>" . Exemplo: "2018-01-02 12:12:10+8:00".

--topic

String

Não

""

Tópico do log. O padrão é uma string vazia (""). Tópico.

--query

String

Não

level:Information|select event_id as Key1,COUNT(*) as Key2 group by Key1

Instrução de consulta ou análise. Visão geral de consulta e análise.

Adicionar set session parallel_sql=true; à instrução analítica ativa o Dedicated SQL. Exemplo: | set session parallel_sql=true; select count() as pv.

Nota

Se o parâmetro query contiver uma instrução analítica, defina size e offset como 0 e use a cláusula LIMIT para paginação. Paginar resultados de consulta e análise.

--reverse

Boolean

Não

true

Define se os logs retornam em ordem decrescente de timestamp (com precisão de minutos).

  • true: Ordem decrescente.

  • false (padrão): Ordem crescente.

Importante
  • Este parâmetro aplica-se apenas a instruções de consulta, não a instruções analíticas.

  • Para instruções analíticas, utilize a cláusula ORDER BY para controlar a ordenação. Padrão: crescente (asc).

--offset

Integer

Não

0

Linha inicial da consulta. Válido apenas para instruções de consulta. Padrão: 0.

--size

Integer

Não

10

Número máximo de logs a retornar. Válido apenas para instruções de consulta. Intervalo de valores: 0 a 100. Padrão: 100.

--power_sql

Boolean

Não

false

Indica se o Dedicated SQL deve ser usado. Consulta e análise de alto desempenho e totalmente precisas (Dedicated SQL).

  • true: Usa o Dedicated SQL.

  • false (padrão): Usa o Standard SQL.

Ative o Dedicated SQL definindo este parâmetro como true ou adicionando a diretiva no parâmetro de consulta.

Este comando também suporta Parâmetros globais.

Exemplos

  • Exemplo de solicitação

    Consulte os 20 principais status de solicitação POST usando a conta padrão.

    aliyunlog log get_log --project="aliyun-test-project" --logstore="logstore-a" --from_time="2021-05-28 15:33:00+8:00" --to_time="2021-05-28 15:40:00+8:00" --query="request_method:POST | select status,COUNT(*) as pv group by status order by pv desc limit 20" --format-output=json
  • Exemplo de resposta

    {
      "data": [
        {
          "__source__": "",
          "__time__": "1719382500",
          "pv": "17",
          "status": "200"
        },
        {
          "__source__": "",
          "__time__": "1719382500",
          "pv": "3",
          "status": "500"
        }
      ],
      "meta": {
        "aggQuery": "select status,COUNT(*) as pv group by status order by pv desc limit 20",
        "columnTypes": [
          "long",
          "long"
        ],
        "count": 2,
        "cpuSec": 0.025,
        "elapsedMillisecond": 0,
        "hasSQL": true,
        "insertedSQL": "1,29, from \"gs-api\" ",
        "isAccurate": true,
        "keys": [
          "status",
          "pv"
        ],
        "processedBytes": 226,
        "processedRows": 20,
        "progress": "Complete",
        "telementryType": "logging",
        "telemetryType": "logging",
        "terms": [
          {
            "key": "",
            "term": "*"
          }
        ],
        "whereQuery": "*"
      }
    }

Comandos relacionados

Comando

Cenário

get_logs

Executa uma consulta por termo em logs usando um arquivo de configuração JSON.

get_log_all

Consulta um grande volume de dados de log.