通过 WebTracking 方式单次写入多条日志。
接口说明
接口说明
-
已明确您查询日志所属的 Project 名称、所属地域、Logstore 名称等。如何查询，请参见管理 Project和管理 Logstore。
-
适用于在网页或者客户端采集日志的场景。
-
使用 Web Tracking 采集日志时，单个请求只能写入一条日志。更多信息，请参见使用 Web Tracking 采集日志。
-
针对日志量较大的场景，可以调用 PutWebTracking 接口将多条日志合并为一次请求。
-
使用 PutWebTracking 接口写入日志时，需要先为 Logstore 打开 Web Tracking 开关。更多信息，请参见使用 Web Tracking 采集日志。
-
该接口不支持同时写入多个 Topic 的日志数据。
-
使用该接口则表示该 Logstore 打开互联网匿名写入权限，没有经过有效鉴权（不需要 AccessKey），可能产生脏数据。
调试
您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。
调试
授权信息
请求语法
POST /logstores/{logstoreName}/track HTTP/1.1路径参数
|
名称 |
类型 |
必填 |
描述 |
示例值 |
| logstoreName |
string |
是 |
Logstore 名称。 |
ali-test-logstore |
请求参数
|
名称 |
类型 |
必填 |
描述 |
示例值 |
| project |
string |
是 |
Project 名称。 |
ali-test-project |
| body |
object |
是 |
请求消息体。 |
|
| __topic__ |
string |
否 |
日志主题。 |
topic |
| __source__ |
string |
是 |
日志来源。 |
source |
| __logs__ |
array<object> |
是 |
日志内容列表。每个元素为一个 JSON 对象，表示一条日志。 说明
说明WebTracking 采集的日志时间为日志到达服务端的时间，每条日志中无需设置__time__字段，如果存在该字段，将被服务端使用日志到达的时间覆盖。 |
|
|
object |
否 |
日志内容列表。 |
||
|
string |
否 |
日志内容。 |
{ "key1": "value1", "key2": "value2" } |
|
| __tags__ |
object |
否 |
日志标签。 |
|
|
string |
否 |
日志标签。 |
{ "tag1": "value1", "tag2": "value2" } |
仅支持如下三个请求头，在调用 PutWebTracking 接口时前两个为必选，格式和含义请参见公共请求参数文档。
x-log-apiversion: 0.6.0
x-log-bodyrawsize: 1234
x-log-compresstype: lz4
如果发送的数据没有经过任何压缩，不需要指定 x-log-compresstype。如果需要对数据压缩发送，当前仅支持 lz4 和 Deflate 算法，其分别对应的请求头为：x-log-compresstype: lz4或x-log-compresstype: deflate。详细数据压缩步骤，请参见数据压缩。
返回参数
|
名称 |
类型 |
描述 |
示例值 |
当前API暂无返回参数
示例
正常返回示例
JSON格式
{}错误码
访问错误中心查看更多错误码。
变更历史
更多信息，参考变更详情。