上报高精度日志接口参考

功能介绍

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

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

每次上报的时候，每条日志都必须带一个纳秒级的时间戳。在LTS界面查看日志的时候，会按照时间戳排序展示在页面上。关于上报日志的约束与限制请参考日志读写限制。

URI

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

表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。
Content-Encoding	否	String	日志压缩格式。枚举值： GZIP SNAPPY gzip snappy

表3 请求Body参数
参数	是否必选	参数类型	描述
contents	是	Array of LogContents	包含上报时间戳的日志内容列表。
labels	是	Object	用户自定义label。请不要将字段名称设置为内置保留字段，否则可能会造成字段名称重复、查询不精确等问题。
tenant_project_id	否	String	租户项目ID，获取方式请参见：获取项目ID。

表4 LogContents
参数	是否必选	参数类型	描述
log_time_ns	是	Long	日志数据上报时间，UTC时间（纳秒）。通过接口上报日志到LTS的时间相距当前时间不超过2天，否则上报日志会被LTS删除。
log	是	String	日志内容。

响应参数

状态码为200时：

表5 响应Body参数
参数	参数类型	描述
errorCode	String	错误码。
error_msg	String	调用失败响应信息描述。
result	String	响应结果。

状态码为400时：

表6 响应Body参数
参数	参数类型	描述
errorCode	String	错误码。
error_msg	String	调用失败响应信息描述。
result	String	响应结果。

状态码为401时：

表7 响应Body参数
参数	参数类型	描述
errorCode	String	错误码。
error_msg	String	调用失败响应信息描述。
result	String	响应结果。

状态码为500时：

表8 响应Body参数
参数	参数类型	描述
errorCode	String	错误码。
error_msg	String	调用失败响应信息描述。
result	String	响应结果。

状态码为503时：

表9 响应Body参数
参数	参数类型	描述
result	String	被请求的服务无效，服务不可用。

请求示例

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

{
 "contents": [
  {
   "log_time_ns": 1586850540000000000,
   "log": "Fri Feb  15 15:48:04 UTC 2019"
  },
  {
   "log_time_ns": 1586850540000000001,
   "log": "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	被请求的服务无效，服务不可用。