批量查询采集的日志
更新时间 2026-08-17 09:47:45
最近更新时间: 2026-08-17 09:47:45
本节主要介绍如何使用API批量查询采集的日志。
此操作用来批量查询采集的日志。
请求语法
GET /rest/v1/system/logcollect?filter=filter HTTP/1.1
Date: date
Host: ip:port
Authorization: authorization请求参数
| 参数 | 类型 | 描述 | 是否必须 |
|---|---|---|---|
| filter | String | 查询的过滤条件。 过滤条件由查询属性和属性值组成，其中属性和属性值之间用单个冒号分隔（key:value）表示模糊匹配，用两个冒号分隔（key::value）表示精确匹配。可以选择多个查询，如果是或的关系，使用“or”将查询条件分隔开；如果是与的关系，使用“and”将查询条件分隔开。 支持的查询条件为：
| 否 |
响应结果
| 名称 | 类型 | 描述 |
|---|---|---|
| logs | Array of log | 日志列表信息，详见“表1 响应参数log说明”。 |
| message | String | 收集失败或者部分收集成功的原因，如果收集成功，则不会返回此项。 |
表1 响应参数log说明
| 名称 | 类型 | 描述 |
|---|---|---|
| id | String | 日志ID。 |
| startTime | Long | HBlock日志采集的起始时间。 |
| endTime | Long | HBlock日志采集的结束时间。 |
| servers | Array of String | HBlock日志采集的服务器ID。 |
| logTypes | Array of string | 采集的HBlock日志类型：
|
| services | Array of string | 采集的HBlock服务。 说明 只有采集类型包含Service时，才会返回此字段。 |
| file | String | 日志文件存储路径及名称。 |
| status | Enum | 日志采集的状态：
|
| size | Long | 采集到的日志文件大小，单位是bytes。 |
| createTime | Long | 日志采集请求的创建时间。 |
请求示例1
查询所有的采集日志。
GET /rest/v1/system/logcollect HTTP/1.1
Date: Mon, 15 Jun 2026 02:44:56 GMT
Authorization: HBlock userName:signature
Host: 192.168.0.65:1443响应示例1
HTTP/1.1 200 OK
x-hblock-request-id: 841e51227bb2455592bd54df0b556215
Connection: keep-alive
Content-Length: 1659
Date: Mon, 15 Jun 2026 02:44:56 GMT
Content-Type: application/json;charset=utf-8
Server: HBlock
{
"data": {
"logs": [
{
"id": "f9257600e3c640c9889baedb370572f1",
"startTime": 1781172000000,
"endTime": 1781301600000,
"servers": [
"hblock_1",
"hblock_3"
],
"logTypes": [
"Config",
"System",
"Service"
],
"services": [
"ps",
"ag"
],
"file": "192.168.0.64:/mnt/storage01/hblock_logs_f9257600e3c640c9889baedb370572f1_20260611100000_20260612220000.zip",
"status": "Succeeded",
"size": 1945994907,
"createTime": 1781489998695
},
{
"id": "161c22914e0d48c5b7a8e717d038f114",
"startTime": 1781056800000,
"endTime": 1781107200000,
"servers": [
"hblock_1",
"hblock_2",
"hblock_3",
"hblock_4"
],
"logTypes": [
"Config",
"Service"
],
"services": [
"ls",
"cs",
"ps"
],
"file": "192.168.0.68:/mnt/storage02/hblock_logs_161c22914e0d48c5b7a8e717d038f114_20260610020000_20260610160000.zip",
"status": "Succeeded",
"size": 399810381,
"createTime": 1781254224229
},
{
"id": "ace557efa4fb417dada7bd4bb8f6c549",
"startTime": 1781056800000,
"endTime": 1781107200000,
"servers": [
"hblock_1",
"hblock_2",
"hblock_3",
"hblock_4"
],
"logTypes": [
"Config"
],
"file": "192.168.0.68:/mnt/storage02/hblock_logs_ace557efa4fb417dada7bd4bb8f6c549_20260610020000_20260610160000.zip",
"status": "Succeeded",
"size": 2132886,
"createTime": 1781253813857
},
{
"id": "924f827e3dc54d8da7746ff1c1bbc770",
"startTime": 1781246409689,
"endTime": 1781253609689,
"servers": [
"hblock_1",
"hblock_2",
"hblock_3",
"hblock_4"
],
"logTypes": [
"Config",
"System",
"Data",
"Coordination",
"Service"
],
"services": [
"mdm",
"fc",
"ls",
"cs",
"ds",
"ps",
"ms",
"ag",
"cloud",
"net",
"rb",
"stor",
"ua",
"uc",
"ws"
],
"file": "192.168.0.68:/mnt/storage01/CTYUN_HBlock_Plus_4.1.0_x64/collected_logs/hblock_logs_924f827e3dc54d8da7746ff1c1bbc770_20260612064009_20260612084009.zip",
"status": "Succeeded",
"size": 613200107,
"createTime": 1781253610465
}
]
}
}请求示例2
查询日志类型为Service的日志。
GET /rest/v1/system/logcollect?filter=logTypes:Servic HTTP/1.1
Date: Mon, 15 Jun 2026 02:56:37 GMT
Authorization: HBlock userName:signature
Host: 192.168.0.65:1443响应示例2
HTTP/1.1 200 OK
x-hblock-request-id: bff7859badaa4acdaad95c6d82630437
Connection: keep-alive
Content-Length: 1310
Date: Mon, 15 Jun 2026 02:56:38 GMT
Content-Type: application/json;charset=utf-8
Server: HBlock
{
"data": {
"logs": [
{
"id": "f9257600e3c640c9889baedb370572f1",
"startTime": 1781172000000,
"endTime": 1781301600000,
"servers": [
"hblock_1",
"hblock_3"
],
"logTypes": [
"Config",
"System",
"Service"
],
"services": [
"ps",
"ag"
],
"file": "192.168.0.64:/mnt/storage01/hblock_logs_f9257600e3c640c9889baedb370572f1_20260611100000_20260612220000.zip",
"status": "Succeeded",
"size": 1945994907,
"createTime": 1781489998695
},
{
"id": "161c22914e0d48c5b7a8e717d038f114",
"startTime": 1781056800000,
"endTime": 1781107200000,
"servers": [
"hblock_1",
"hblock_2",
"hblock_3",
"hblock_4"
],
"logTypes": [
"Config",
"Service"
],
"services": [
"ls",
"cs",
"ps"
],
"file": "192.168.0.68:/mnt/storage02/hblock_logs_161c22914e0d48c5b7a8e717d038f114_20260610020000_20260610160000.zip",
"status": "Succeeded",
"size": 399810381,
"createTime": 1781254224229
},
{
"id": "924f827e3dc54d8da7746ff1c1bbc770",
"startTime": 1781246409689,
"endTime": 1781253609689,
"servers": [
"hblock_1",
"hblock_2",
"hblock_3",
"hblock_4"
],
"logTypes": [
"Config",
"System",
"Data",
"Coordination",
"Service"
],
"services": [
"mdm",
"fc",
"ls",
"cs",
"ds",
"ps",
"ms",
"ag",
"cloud",
"net",
"rb",
"stor",
"ua",
"uc",
"ws"
],
"file": "192.168.0.68:/mnt/storage01/CTYUN_HBlock_Plus_4.1.0_x64/collected_logs/hblock_logs_924f827e3dc54d8da7746ff1c1bbc770_20260612064009_20260612084009.zip",
"status": "Succeeded",
"size": 613200107,
"createTime": 1781253610465
}
]
}
}
