推送日志PushLogRecord
更新时间：2026-06-02
-
支持批量推送日志记录到 BLS 平台，日志记录的格式可以是 TEXT，也可以是 JSON 格式。如果是 TEXT，则不对日志进行解析；如果是 JSON 格式，可以自动发现 JSON 字段（仅支持首层字段发现，暂不支持嵌套类型字段的自动发现）。
如果既想上传解析出的具体字段，又想上传日志原文，，可以使用 JSON 格式进行上传，并在 JSON 中包含日志原文(使用 @raw 作为key，日志原文作为 value)。 BLS 解析到 @raw 的时候，会将其内容作为日志原文处理。
API Explorer
去调试
您可以在 API Explorer 中直接运行该接口，免去您计算签名的困扰。运行成功后，API Explorer 可以自动生成 SDK 代码示例。
请求结构
Plain Text
1POST /v{version}/logstore/{logStoreName}/logrecord?project={project} HTTP/1.1
2Host: xxx.bj.baidubce.com
3Authorization: authorization string
4
5{
6 "logStreamName": <logStreamName>,
7 "type": <type>,
8 "logRecords": [
9 {
10 "message": <message>,
11 "timestamp": <timestamp>
12 }
13 ],
14 "tags": [
15 {
16 "k": "<tagKey>",
17 "v": "<tagValue>"
18 }
19 ]
20}请求头域
除公共头域外，无其他特殊头域
请求参数
| 参数名称 | 类型 | 是否必需 | 参数位置 | 描述 |
|---|---|---|---|---|
| version | String | 是 | URL参数 | API版本号，当前取值为1 |
| project | String | 否 | Query参数 | 日志组名称，默认default |
| logStoreName | String | 是 | URL参数 | 日志集名称 |
| logStreamName | String | 否 | RequestBody参数 | 日志流名称，长度不能超过 192 字符，包含的字符仅限于：a-z, A-Z, 0-9, '_', '-', '.' '/' |
| type | String | 否 | RequestBody参数 | 数据类型，JSON/TEXT，默认为 TEXT |
| logRecords | List<LogRecord> | 是 | RequestBody参数 | 日志记录 |
| tags | List<LogTag> | 否 | RequestBody参数 | 日志标签 |
返回状态码
成功返回200，失败返回见错误码
返回头域
除公共头域外，无其他特殊头域
返回参数
| 参数名称 | 类型 | 描述 |
|---|---|---|
| success | Boolean | 请求是否成功 |
| code | String | 请求码，成功为OK，错误为具体的错误码 |
请求示例
Plain Text
1* TEXT 类型日志
2
3```text
4POST /v1/logstore/demo/logrecord?project=default HTTP/1.1
5Host: bls-log.bj.baidubce.com
6Authorization: bce-auth-v1/18717522d39411e9b721df098b0b908c/2019-09-10T07:00:20Z/1800/content-type;host;x-bce-date;x-bce-request-id/6a7cb6c9ac7ec156c805e55e7d0bcfc443b47feee97cf099c1c0d93a0b4c8304
7Content-Type: application/json; charset=utf-8
8
9{
10 "logStreamName": "my-stream",
11 "type": "TEXT",
12 "logRecords": [
13 {
14 "message": "this is a log record",
15 "timestamp": 1453209131020
16 }
17 ]
18}
19```
20* TEXT 类型日志，包含标签
21
22```text
23POST /v1/logstore/demo/logrecord?project=default HTTP/1.1
24Host: bls-log.bj.baidubce.com
25Authorization: bce-auth-v1/18717522d39411e9b721df098b0b908c/2019-09-10T07:00:20Z/1800/content-type;host;x-bce-date;x-bce-request-id/6a7cb6c9ac7ec156c805e55e7d0bcfc443b47feee97cf099c1c0d93a0b4c8304
26Content-Type: application/json; charset=utf-8
27
28{
29 "logStreamName": "my-stream",
30 "type": "TEXT",
31 "logRecords": [
32 {
33 "message": "this is a log record",
34 "timestamp": 1453209131020
35 }
36 ],
37 "tags": [
38 {
39 "k": "hostname",
40 "v": "localhost"
41 }
42 ]
43}
44```
45* JSON 类型日志
46```text
47POST /v1/logstore/demo/logrecord?project=default HTTP/1.1
48Host: bls-log.bj.baidubce.com
49Authorization: bce-auth-v1/18717522d39411e9b721df098b0b908c/2019-09-10T07:00:20Z/1800/content-type;host;x-bce-date;x-bce-request-id/6a7cb6c9ac7ec156c805e55e7d0bcfc443b47feee97cf099c1c0d93a0b4c8304
50Content-Type: application/json; charset=utf-8
51
52{
53 "logStreamName": "my-stream",
54 "type": "JSON",
55 "logRecords": [
56 {
57 "message": "{\"level\":\"info\", \"status\": 200, \"cost\": 304.87}",
58 "timestamp": 1453209131020
59 }
60 ]
61}
62```
63* JSON 类型日志，包含日志原文(@raw)
64```text
65POST /v1/logstore/demo/logrecord?project=default HTTP/1.1
66Host: bls-log.bj.baidubce.com
67Authorization: bce-auth-v1/18717522d39411e9b721df098b0b908c/2019-09-10T07:00:20Z/1800/content-type;host;x-bce-date;x-bce-request-id/6a7cb6c9ac7ec156c805e55e7d0bcfc443b47feee97cf099c1c0d93a0b4c8304
68Content-Type: application/json; charset=utf-8
69
70{
71 "logStreamName": "my-stream",
72 "type": "JSON",
73 "logRecords": [
74 {
75 "message": "{\"@raw\":\"info 200 304.87ms this is a log record.\", \"level\":\"info\", \"status\": 200, \"cost\": 304.87}",
76 "timestamp": 1453209131020
77 }
78 ]
79}
80```响应示例
Plain Text
1HTTP/1.1 200 OK
2x-bce-request-id: 946002ee-cb4f-4aad-b686-5be55df27f09
3Date: Wed, 10 Apr 2016 08:26:52 GMT
4Transfer-Encoding: chunked
5Content-Type: application/json;charset=UTF-8
6Server: BWS
7
8{
9 "success" : true,
10 "code": "OK"
11}评价此篇文章