3.3 API 接入
3.3.2 上报高精度日志
功能介绍
该接口用于华为云主机上报租户日志给LTS，目前不支持非华为云主机API接入。
接入点IP可在LTS控制台“主机管理 > 安装ICAgent”的安装命令中获取，端口为 8102，调用时使用该参数请参见“请求示例”。
说明
每次上报的时候， 每条日志都必须带一个纳秒级的时间戳。在LTS界面查看日志的时候， 会按 照时间戳排序展示在页面上。
URI
POST /v2/{project_id}/lts/groups/{log_group_id}/streams/{log_stream_id}/tenant/
contents/high-accuracy 表3-14 路径参数
参数 是否
必选
参数类型 描述
project_id 是 String 项目ID，获取方式请参见：获取帐号
ID、项目ID、日志组ID、日志流ID。
缺省值：None 最小长度：32 最大长度：32
log_group_id 是 String 日志组ID，获取方式请参见：获取帐号
ID、项目ID、日志组ID、日志流ID。
缺省值：None 最小长度：36 最大长度：36
参数 是否 必选
参数类型 描述
log_stream_id 是 String 日志流ID，获取方式请参见：获取帐号
ID、项目ID、日志组ID、日志流ID。
X-Auth-Token 是 String 从IAM获取的用户Token，获取方式请参 见：获取用户Token。
缺省值：None 最小长度：1000 最大长度：2000
Content-Type 是 String 该字段填为：application/
json;charset=utf8。
缺省值：None 最小长度：29 最大长度：29
Content-Encoding 否 String 日志压缩格式 枚举值：
● gzip
● snappy
表3-16 请求 Body 参数
参数 是否
必选
参数类型 描述
contents 是 Array of
LogContents
包含上报时间戳的日志内容列表。参数 是否 必选
参数类型 描述
labels 是 String 用户自定义tag。
tenant_projec
t_id 否 String 租户ID。
表3-17 LogContents
参数 是
否 必 选
参数类型 描述
log_time_ns 是 Long 日志数据采集时间，UTC时间（纳秒）。
说明
采集时间需在日志存储时间范围之内，否则上报日 志会被删除。比如日志组的日志存储时间是7天，
则此参数不应早于当前时间的7天前。
log 是 String 日志内容。
响应参数
状态码为 200 时:
表3-18 响应 Body 参数
参数 参数类型 描述
errorCode String 错误码。
枚举值：
● SVCSTG.ALS.200.200 errorMessage String 调用失败响应信息描述。
枚举值：
● Report success.
result String 响应结果。
状态码为 400 时:
表3-19 响应 Body 参数
参数 参数类型 描述
errorCode String 错误码。
枚举值：
● SVCSTG.ALS.200.201
● SVCSTG.ALS.200.210 errorMessage String 调用失败响应信息描述。
枚举值：
● Request conditions must be json format.
● projectid xxx log's quota has full!!
result String 响应结果。
状态码为 401 时:
表3-20 响应 Body 参数
参数 参数类型 描述
errorCode String 错误码。
枚举值：
● SVCSTG.ALS.403.105 errorMessage String 调用失败响应信息描述。
枚举值：
● Project id is invalid.
result String 响应结果。
状态码为 500 时:
表3-21 响应 Body 参数
参数 参数类型 描述
errorCode String 错误码。
枚举值：
● SVCSTG.ALS.403.105 errorMessage String 调用失败响应信息描述。
枚举值：
● Internal error
参数 参数类型 描述 result String 响应结果。
状态码为 503 时:
表3-22 响应 Body 参数
参数 参数类型 描述
result String ServiceUnavailable。 被请求的服务无效, 服务不 可用。
请求示例
POST https://{接入点IP:8102}/v2/{project_id}/lts/groups/{log_group_id}/streams/{log_stream_id}/tenant/
contents/high-accuracy
{ "errorCode": "SVCSTG.ALS.200.200", "errorMessage": "Report success.", "result": null
}
状态码： 401
在客户端提供认证信息后，返回该状态码，表明服务端指出客户端所提供的认证信息 不正确或非法。
{ "errorCode" : "SVCSTG.ALS.403.105", "errorMessage" : "Project id is invalid.", "result": null
}
状态码
状态码 描述
200 请求响应成功。
400 BadRequest。非法请求。建议根据error_msg直接修改该请求，不要重 试该请求。
401 在客户端提供认证信息后，返回该状态码，表明服务端指出客户端所提 供的认证信息不正确或非法。
500 系统内部错误。
503 ServiceUnavailable。被请求的服务无效，服务不可用。
错误码
请参见错误码。