上報日志
更新時間 2025-07-23 17:24:56
最近更新時間: 2025-07-23 17:24:56
分享文章
功能介紹
該接口用于上報日志數據至云日志服務中。
URI
POST
Path參數
| 參數名 | 類型 | 描述 |
|---|---|---|
| endpoint | sting | 訪問地址，請查看訪問地址（Endpoint） |
| logProject | sting | 日志項目ID |
| logUnit | string | 日志單元ID |
參數（Endpoint） 獲取方式
各資源池地址請查看訪問地址（Endpoint）。
參數（logProject、logUnit）獲取方式
logProject、logUnit代表了日志上傳的目標日志項目與目標日志單元。要獲取這兩個參數的前提是您已經成功開通了云日志服務，并創建了日志項目和日志單元，詳情參考創建日志項目與日志單元。
創建完成后，您可在云日志服務控制臺-日志管理-日志項目與日志單元列表中獲取，將鼠標懸浮在日志項目、日志單元名稱上，即可獲取項目/單元ID
注意日志項目和日志單元編碼所屬區域要和訪問地址endpoint相對應，例如日志項目和日志單元開通在華東1區域內，則也需要使用華東1的endpoint。
Header
| 參數名 | 說明 |
|---|---|
| token | 通過CTAPI獲取的臨時憑證token值，有限期為30分鐘 |
| accesskey | 租戶的ak |
| Content-Type | application/json |
Body
| 參數名 | 類型 | 描述 | 是否必須 |
|---|---|---|---|
| log_items | Array[log_item] | 參考對象log_item 一個log_itme指一條日志 |
是 |
對象log_item
| 參數名 | 類型 | 說明 | 是否必須 |
|---|---|---|---|
| log_timestamp | long | 時間戳，納秒（長度19位），一般是當前時間 | 是 |
| origin_msg | string | 原始日志內容 | 是 |
| content | Map<string, string> | 對日志進行分詞后的內容，可用于索引 | 否 |
| labels | Map<string, string> | 自定義標簽 | 否 |
Response
| 參數名 | 類型 | 說明 | 示例 |
|---|---|---|---|
| statusCode | Integer | 返回碼取值范圍 0：正常； -1：嚴重錯誤； |
0 |
| message | String | 狀態描述 | SUCCESS |
| error | String | 參考錯誤編碼列表 | LTS_8000 |
示例
可參考Api工具：OpenApiUtils.zip
curl --location --request POST '//lts-huadong1.cnsp-internal.daliqc.cn/v1/lts/api/aeabaf4816c6b6/d49e75568c16b9/putlogs' \
--header 'token: 04ad5e6d4ac03534e117cb49388458e382b350a7ad915e0b644be9d2c57db4cf981c47c60a6252259f330817b75438d9bb7087f6393c3815e015c2e6cb3f293cd5369843adda4c0f7b428063334d39b2d3f78306e78211224a33ddd3c22293b3766a67acf7af4ad7250c2c07c41c7517f2451a9babc0f4947da8d4600053bda5b78cc202ebccf39e63cd3158f46d7f2238ba843c7b6b79d3b7bf43d80aa57c23daa9c0048892a163bb6d59cde267095c5b047eacf78e1515532da0e0b9c9bb85bc571477d6d956d5ab334a4db81c836b0bd2c5097a6c2f0f256b10eef4ce769b2ca95472275aff608350f68978134ac9f23b4b3fdee9bf2c711cc59d9ee48ec8b1673e4a8c74888d98b67301b060a94a63d6bc96a94653458cfa133f8214c8ae1e5bd467b2199b6e2e57a0bd06d16acefa1902cb45204cfd69899dd40c8782559b458b7b56d1ca6b499e4630470c477' \
--header 'accesskey: e1301507eb4b42939b1c17480bdcbc8a' \
--header 'Content-Type: application/json' \
--data '{
"log_items":[
{
"log_timestamp": 1724061582000000000,
"origin_msg":"this is api message...",
"content":
{
"level":"info",
"flag": 1,
"value": 3.1415
}
}
]
}'
錯誤碼
| statusCode | errorCode | message |
|---|---|---|
| -1 | LTS_8000 | 請求失敗，請稍候重試，或提交工單反饋 |
| -1 | LTS_8001 | 內容不合法，無法解析 |
| -1 | LTS_8002 | 日志內容中有無效的日志時間戳 |
| -1 | LTS_8003 | 日志內容中有非UTF8字符 |
| -1 | LTS_8004 | 日志內容包含的日志必須小于[x] MB和[y]條 |
| -1 | LTS_8005 | 日志中時間范圍不在[-7*24小時 + 15分鐘]有效范圍內 |
| -1 | LTS_8006 | 日志內容解壓失敗 |
| -1 | LTS_8007 | Token失效，請重新獲取 |
| -1 | LTS_8008 | 云日志服務產品失效，請續費或重新開通 |
| -1 | LTS_8009 | 無云日志服務產品實例，請先開通云日志服務 |
| -1 | LTS_8010 | 日志項目不存在 |
| -1 | LTS_8011 | 日志單元不存在 |
