更新时间:2025-09-03 GMT+08:00
分享

上报日志接口参考

功能介绍

该接口用于主机上报租户日志给LTS。

接入点IP可在LTS控制台安装ICAgent的安装命令中获取,端口为8102,调用时使用该参数请参见请求示例

关于上报日志的约束与限制请参考日志读写限制

URI

POST /v2/{project_id}/lts/groups/{log_group_id}/streams/{log_stream_id}/tenant/contents

表1 路径参数

参数

是否必选

参数类型

描述

project_id

String

项目ID,获取方式请参见:获取项目ID

log_group_id

String

日志组ID,获取方式请参见:获取日志组ID和日志流ID

log_stream_id

String

日志流ID,获取方式请参见:获取日志组ID和日志流ID

每个logstream写入速率最大不能超过100MB/S,超过此规格可能会导致日志丢失。

请求参数

表2 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

String

从IAM获取的用户Token,获取方式请参见:获取用户Token

Content-Type

String

用于定义消息体的格式,该字段填为:application/json;charset=UTF-8。

表3 请求Body参数

参数

是否必选

参数类型

描述

log_time_ns

Long

日志数据上报时间,UTC时间(纳秒)。

通过接口上报日志到LTS的时间相距当前时间不超过2天,否则上报日志会被LTS删除。

contents

Array of String

日志内容。

labels

Object

用户自定义label。

请不要将字段名称设置为内置保留字段,否则可能会造成字段名称重复、查询不精确等问题。

tenant_project_id

String

租户项目ID,获取方式请参见:获取项目ID

响应参数

状态码为200时:

表4 响应Body参数

参数

参数类型

描述

errorCode

String

错误码。

error_msg

String

调用失败响应信息描述。

result

String

响应结果。

状态码为400时:

表5 响应Body参数

参数

参数类型

描述

errorCode

String

错误码。

error_msg

String

调用失败响应信息描述。

result

String

响应结果。

状态码为401时:

表6 响应Body参数

参数

参数类型

描述

errorCode

String

错误码。

error_msg

String

调用失败响应信息描述。

result

String

响应结果。

状态码为500时:

表7 响应Body参数

参数

参数类型

描述

errorCode

String

错误码。

error_msg

String

调用失败响应信息描述。

result

String

响应结果。

状态码为503时:

表8 响应Body参数

参数

参数类型

描述

result

String

被请求的服务无效,服务不可用。

请求示例

POST https://{接入点IP:8102}/v2/{project_id}/lts/groups/{log_group_id}/streams/{log_stream_id}/tenant/contents

{
 "log_time_ns": 1586850540000000000,
 "contents": [
  "Fri Feb  1 07:48:04 UTC 2019 0\n",
  "Sat April 18 16:04:04 UTC 2019"
 ],
 "labels": {
  "user_tag": "string"
 }
}

响应示例

状态码:200

日志上报成功。

{
  "errorCode": "SVCSTG.ALS.200.200",
  "error_msg": "Report success.",
  "result": null
}

状态码:401

在客户端提供认证信息后,返回该状态码,表明服务端指出客户端所提供的认证信息不正确或非法。

{
  "errorCode" : "SVCSTG.ALS.403.105",
  "error_msg" : "Project id is invalid.",
  "result": null
}

状态码

状态码

描述

200

日志上报成功。

400

非法请求。建议根据error_msg直接修改该请求,不要重试该请求。

401

在客户端提供认证信息后,返回该状态码,表明服务端指出客户端所提供的认证信息不正确或非法。

500

系统内部错误。

503

被请求的服务无效,服务不可用。

相关文档