百度日志服务BLS

    PushLogRecord

    描述

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

    请求

    • 请求语法
    POST /v1/logstore/{logStoreName}/logrecord HTTP/1.1
    Host: <Endpoint>
    Authorization: <Authorization String>
    Content-Type: application/json; charset=utf-8
     
    {
      "logStreamName": <logStreamName>,
      "type": <type>,
      "logRecords": [
        {
          "message": <message>,
          "timestamp": <timestamp>
        }
      ]
    }
    • 请求头域

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

    • 请求参数
    参数名称 类型 是否必须 参数位置 描述
    logStoreName String Yes Path 日志集名称
    logStreamName String Yes RequestBody 日志流名称,长度不能超过 128 字符,包含的字符仅限于:a-z, A-Z, 0-9, '_', '-', '.'
    type String No RequestBody 数据类型,JSON/TEXT,默认为 TEXT
    logRecords List<LogRecord> Yes RequestBody 日志记录

    上表中的 logRecords 数组中的每个 LogRecord 元素结构如下:

    字段名称 类型 描述
    message String 日志记录的内容
    timestamp Int 日志记录的时间戳,精确到毫秒

    响应

    • 响应头域

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

    • 响应参数

    错误码

    除了通用的错误码,还可能出现如下错误码:

    错误码 错误消息 描述 HTTP状态码
    LogStoreNotFound LogStore [logStoreName] not exists LogStore 不存在 404
    TooNewLogRecord Check out the logRecord that occurred in the future time at position [offset] 请求批次中存在过新的LogRecord 400

    注:错误消息中 [offset] 部分会用具体的位置来替换

    示例

    • 请求示例
    POST /v1/logstore/demo/logrecord HTTP/1.1
    Host: bls-log.bj.baidubce.com
    Authorization: bce-auth-v1/18717522d39411e9b721df098b0b908c/2019-09-10T07:00:20Z/1800/content-type;host;x-bce-date;x-bce-request-id/6a7cb6c9ac7ec156c805e55e7d0bcfc443b47feee97cf099c1c0d93a0b4c8304
    Content-Type: application/json; charset=utf-8
     
    {
      "logStreamName": "my-stream",
      "type": "TEXT",
      "logRecords": [
        {
          "message": "this is a log record",
          "timestamp": 1453209131020
        }
      ]
    }
    • 响应示例
    HTTP/1.1 200
    Content-Type: application/json; charset=utf-8
    X-Bce-Request-Id: 2eeba101-4cc7-4cfe-b5ac-a3be8d060e33
    Date: Fri, 10 Apr 2020 04:42:37 GMT
    上一篇
    LogStream 相关接口
    下一篇
    PullLogRecord