调用 WebTracks 接口批量上传日志到指定的日志主题中。

使用说明

本接口用于将多条结构化日志上传到指定的日志主题中。
数据上传要求：

• 一次请求不可超过 5MiB，每次可以写入的原始日志大小上限为 5MiB，日志组中每条日志不超过 1MiB，一个 LogGroup 中日志个数不能超过 10000 条。
• 服务端会对每次 WebTracks 请求写入的日志数据进行长度检查，如果超出限制则整个请求失败且无任何日志数据成功写入。

日志上传相关的接口（PutLogs、WebTracks）共用一个调用频率和流量限制的额度，具体限制如下：

• 接口的总请求频率限制为 500 次/Shard/秒，超出请求频率限制会报错 ExceedQPSLimit。
• 接口的总流量限制为 5MiB/Shard/s，每个 Shard 中日志解压后的流量限制为 30MiB/s，超出流量限制会报错 ExceedRateLimit。大流量场景下建议开启 Shard 自动分裂，以免影响数据写入效率。

请求说明

• 请求方式：POST
• 请求地址：https://tls-{Region}.ivolces.com/WebTracks

请求头

请求参数

下表仅列出该接口特有的请求参数和部分公共参数。更多信息请见公共参数。

Query

Body

[
{
"tap1": "person-A",
"tap2": "action-A"
}
]

Logs 说明

返回参数

本接口无特有的返回参数。更多信息请见返回结构。

请求示例

POST https://tls-{Region}.ivolces.com/WebTracks?TopicId=c1******&ProjectId=c2******
<公共请求头>
Content-Type: application/json
x-tls-bodyrawsize: 1024
{
    "Source": "postman",
    "Logs": [
        {
            "tap1": "person-A",
            "tap2": "action-A"
        },
        {
            "tap1": "person-B",
            "tap2": "action-B"
        }
    ]
}

返回示例

HTTP/1.1 200 OK
Content-Type: application/json; charset=utf-8 
...

错误码

下表为您列举了该接口与业务逻辑相关的错误码。公共错误码请参见公共错误码文档。