通過 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. | 內部服務調用錯誤。 |
更多信息，請參見通用錯誤碼。