推送日志PushLogRecord

描述

支持批量推送日志记录到 BLS 平台，日志记录的格式可以是 TEXT，也可以是 JSON 格式。如果是 TEXT，则不对日志进行解析；如果是 JSON 格式，可以自动发现 JSON 字段（仅支持首层字段发现，暂不支持嵌套类型字段的自动发现）。

如果既想上传解析出的具体字段，又想上传日志原文，，可以使用 JSON 格式进行上传，并在 JSON 中包含日志原文(使用 @raw 作为key，日志原文作为 value)。 BLS 解析到 @raw 的时候，会将其内容作为日志原文处理。

请求

• 请求语法

1POST /v1/logstore/{logStoreName}/logrecord?project={project} HTTP/1.1
2Host: <Endpoint>
3Authorization: <Authorization String>
4Content-Type: application/json; charset=utf-8
5 
6{
7  "logStreamName": <logStreamName>,
8  "type": <type>,
9  "logRecords": [
10    {
11      "message": <message>,
12      "timestamp": <timestamp>
13    }
14  ],
15  "tags": [
16    {
17      "k": "<tagKey>",
18      "v": "<tagValue>"
19    }
20  ]
21}

• 请求头域

除公共请求头域外，无其它特殊头域。

• 请求参数

其中，logRecords 数组中的每个 LogRecord 元素结构如下：

tags 数组中的每个 Tag 元素结构如下：

响应

• 响应头域

除公共响应头域外，无其它特殊头域。

• 响应参数

无

错误码

除了通用的错误码，还可能出现如下错误码：

示例

• 请求示例

  • TEXT 类型日志
  Text 复制

  1POST /v1/logstore/demo/logrecord?project=default HTTP/1.1
  2Host: bls-log.bj.baidubce.com
  3Authorization: bce-auth-v1/18717522d39411e9b721df098b0b908c/2019-09-10T07:00:20Z/1800/content-type;host;x-bce-date;x-bce-request-id/6a7cb6c9ac7ec156c805e55e7d0bcfc443b47feee97cf099c1c0d93a0b4c8304
  4Content-Type: application/json; charset=utf-8
  5
  6{
  7  "logStreamName": "my-stream",
  8  "type": "TEXT",
  9  "logRecords": [
  10    {
  11      "message": "this is a log record",
  12      "timestamp": 1453209131020
  13    }
  14  ]
  15}

  • TEXT 类型日志，包含标签
  Text 复制

  1POST /v1/logstore/demo/logrecord?project=default HTTP/1.1
  2Host: bls-log.bj.baidubce.com
  3Authorization: bce-auth-v1/18717522d39411e9b721df098b0b908c/2019-09-10T07:00:20Z/1800/content-type;host;x-bce-date;x-bce-request-id/6a7cb6c9ac7ec156c805e55e7d0bcfc443b47feee97cf099c1c0d93a0b4c8304
  4Content-Type: application/json; charset=utf-8
  5
  6{
  7  "logStreamName": "my-stream",
  8  "type": "TEXT",
  9  "logRecords": [
  10    {
  11      "message": "this is a log record",
  12      "timestamp": 1453209131020
  13    }
  14  ],
  15  "tags": [
  16    {
  17        "k": "hostname",
  18        "v": "localhost"
  19    }
  20  ]
  21}

  • JSON 类型日志
  Text 复制

  1POST /v1/logstore/demo/logrecord?project=default HTTP/1.1
  2Host: bls-log.bj.baidubce.com
  3Authorization: bce-auth-v1/18717522d39411e9b721df098b0b908c/2019-09-10T07:00:20Z/1800/content-type;host;x-bce-date;x-bce-request-id/6a7cb6c9ac7ec156c805e55e7d0bcfc443b47feee97cf099c1c0d93a0b4c8304
  4Content-Type: application/json; charset=utf-8
  5
  6{
  7  "logStreamName": "my-stream",
  8  "type": "JSON",
  9  "logRecords": [
  10    {
  11      "message": "{\"level\":\"info\", \"status\": 200, \"cost\": 304.87}",
  12      "timestamp": 1453209131020
  13    }
  14  ]
  15}

  • JSON 类型日志，包含日志原文(@raw)
  Text 复制

  1POST /v1/logstore/demo/logrecord?project=default HTTP/1.1
  2Host: bls-log.bj.baidubce.com
  3Authorization: bce-auth-v1/18717522d39411e9b721df098b0b908c/2019-09-10T07:00:20Z/1800/content-type;host;x-bce-date;x-bce-request-id/6a7cb6c9ac7ec156c805e55e7d0bcfc443b47feee97cf099c1c0d93a0b4c8304
  4Content-Type: application/json; charset=utf-8
  5
  6{
  7  "logStreamName": "my-stream",
  8  "type": "JSON",
  9  "logRecords": [
  10    {
  11      "message": "{\"@raw\":\"info 200 304.87ms this is a log record.\", \"level\":\"info\", \"status\": 200, \"cost\": 304.87}",
  12      "timestamp": 1453209131020
  13    }
  14  ]
  15}

• 响应示例

1HTTP/1.1 200
2Content-Type: application/json; charset=utf-8
3X-Bce-Request-Id: 2eeba101-4cc7-4cfe-b5ac-a3be8d060e33
4Date: Fri, 10 Apr 2020 04:42:37 GMT