文档

pull_log

更新时间:

调用CLI命令获取指定时间段的日志详细信息。

请求语法

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>]

请求参数

该命令的必选和特有参数描述如下。

参数名称

数值类型

是否必选

示例值

描述

--project_name

String

aliyun-test-project

Project名称。

--logstore_name

String

logstore-a

Logstore名称。

--shard_id

Integer

0

Shard ID。

--from_time

String

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

开始时间,Unix时间戳格式或者“%Y-%m-%d %H:%M:%S<time_zone>” 格式,例如“2018-01-02 12:12:10+8:00”

--to_time

String

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

结束时间,Unix时间戳格式或者“%Y-%m-%d %H:%M:%S<time_zone>” ,例如“2018-01-02 12:12:10+8:00”

--batch_size

String

1000

每个查询迭代获取的日志数据数量。

--compress

Boolean

true

是否压缩返回日志数据。

  • true(默认值):压缩后返回日志数据。

  • false:不压缩直接返回。

关于该命令的全局参数,请参见全局参数

示例

  • 请求示例

    使用默认账号查询指定时间段内的日志数据。命令示例如下:

    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
  • 返回示例

    {
      "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=="
    }

更多信息,请参见使用CLI的常见问题