文档首页 > > 用户指南> 日志接入> API接入>

上报日志

上报日志

分享
更新时间:2021/04/08 GMT+08:00

功能介绍

该接口用于上报租户日志给LTS(通过podlb, 不是通过内部apig)。

调试

您可以在API Explorer中调试该接口。

URI

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

表1 路径参数

参数

是否必选

参数类型

描述

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

缺省值:None

最小长度:36

最大长度:36

注:每个logstream写入速率最大不能超过5MB/S,写入条数最多不能超过25000条/秒,超过此规格可能会导致日志丢失。

请求参数

表2 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

String

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

缺省值:None

最小长度:1000

最大长度:2000

Content-Type

String

该字段填为:application/json;charset=utf8。

缺省值:None

最小长度:29

最大长度:29

表3 请求Body参数

参数

是否必选

参数类型

描述

log_time_ns

String

日志数据采集时间,UTC时间(纳秒)。

contents

Array of String

日志内容。

labels

Map

用户自定义tag。

响应参数

状态码为 200 时:

表4 响应Body参数

参数

参数类型

描述

errorCode

String

错误码。

枚举值:

  • SVCSTG.ALS.200.200

errorMessage

String

调用失败响应信息描述。

枚举值:

  • Report success.

状态码为 400 时:

表5 响应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!!

状态码为 401 时:

表6 响应Body参数

参数

参数类型

描述

errorCode

String

错误码。

枚举值:

  • SVCSTG.ALS.403.105

errorMessage

String

调用失败响应信息描述。

枚举值:

  • Project id is invalid.

状态码为 500 时:

表7 响应Body参数

参数

参数类型

描述

errorCode

String

错误码。

枚举值:

  • SVCSTG.ALS.403.105

errorMessage

String

调用失败响应信息描述。

枚举值:

  • Internal error

状态码为 503 时:

表8 响应Body参数

参数

参数类型

描述

-

String

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

请求示例

POST https://{endpoint}/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 Apri 18 16:04:04 UTC 2019"
	],
	"labels": {
		"user_tag": "string"
	}
}

响应示例

状态码: 200

日志上报成功。

{
  "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。被请求的服务无效,服务不可用。

错误码

请参见错误码

分享:

    相关文档

    相关产品

文档是否有解决您的问题?

提交成功!非常感谢您的反馈,我们会继续努力做到更好!
反馈提交失败,请稍后再试!

*必选

请至少选择或填写一项反馈信息

字符长度不能超过200

提交反馈 取消

如您有其它疑问,您也可以通过华为云社区论坛频道来与我们联系探讨

智能客服提问云社区提问