通過 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格式
{}錯誤碼
訪問錯誤中心查看更多錯誤碼。
變更歷史
更多資訊，參考變更詳情。