通过 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
请求参数
| 名称 | 类型 | 必填 | 描述 | 示例值 |
|---|---|---|---|---|
| project | string | 是 | Project 名称。 | ali-test-project |
| logstoreName | string | 是 | Logstore 名称。 | ali-test-logstore |
| body | object | 是 | 请求消息体。 | |
| __topic__ | string | 否 | 日志主题。 | topic |
| __source__ | string | 是 | 日志来源。 | source |
| __logs__ | array<object> | 是 | 日志内容列表。每个元素为一个 JSON 对象，表示一条日志。 说明
说明WebTracking 采集的日志时间为日志到达服务端的时间，每条日志中无需设置__time__字段，如果存在该字段，将被服务端使用日志到达的时间覆盖。
| |
| object | 否 | 日志内容列表。 | ||
| string | 否 | 日志内容。 | { "key1": "value1", "key2": "value2" } | |
| __tags__ | object | 否 | 日志标签。 | |
| string | 否 | 日志标签。 |
仅支持如下三个请求头，在调用 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。详细数据压缩步骤，请参见数据压缩。
返回参数
示例
正常返回示例
JSON格式
{}错误码
访问错误中心查看更多错误码。
| HttpStatusCode | ErrorCode | ErrorMessage | 错误码描述 |
|---|---|---|---|
| 404 | ProjectNotExist | Project does not exist. | Project 不存在。 |
| 404 | LogStoreNotExist | Logstore does not exist. | Logstore 不存在。 |
| 400 | PostBodyInvalid | Fail to parse protobuf. | Protobuffer 内容不合法，无法解析。 |
| 400 | PostBodyInvalid | Body invalid error message. | 请求的 Body 不合法。 |
| 400 | PostBodyUncompressError | Post body uncompressed fail. | 日志内容解压失败。 |
| 400 | PostBodyTooLarge | Body size bodySize must little than 10485760. | 请求 Body （压缩前）不能超过 10MB。 |
| 500 | InternalServerError | Specified Server Error Message. | 内部服务调用错误。 |
更多信息，请参见通用错误码。