文档首页/ 云数据库 GeminiDB/ API参考/ API v3（推荐）/ 日志管理/ 关联LTS日志流
更新时间：2024-04-02 GMT+08:00
查看PDF
分享

关联LTS日志流

功能介绍

  • 将实例日志与LTS日志流关联，后台将自动上传实例日志到关联的LTS日志流里。
  • 关联成功后，会产生一定费用，具体计费可参考云日志服务（LTS）的定价详情。
  • 系统会为当前选择的日志流创建对应日志类型的结构化配置，若该日志流已存在其他日志类型的结构化配置，系统会进行覆盖。

接口约束

  • 只支持GeminiDB Redis数据库实例的慢日志和审计日志配置。
  • 部分低版本的实例需要升级内核小版本以支持审计日志配置功能。
  • 创建中、已删除、冻结状态的实例不支持该操作。
  • 单批最多支持100个实例关联LTS日志流。

URI

POST https://{Endpoint}/v3/{project_id}/instances/logs/lts-configs

表1 路径参数

参数

是否必选

参数类型

描述

project_id

是

String

租户在某一region下的project ID。获取方法请参见获取项目ID。

请求参数

表2 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

是

String

用户Token。

X-Language

否

String

语言。
表3 请求Body参数

参数

是否必选

参数类型

描述

instance_ids

是

Array of strings

需要建立关联的实例ID列表。

log_type

是

String

日志类型。取值：

  • slow_log，表示慢日志。
  • audit_log，表示审计日志。

lts_group_id

是

String

LTS日志组ID。可通过云日志服务中“查询账号下所有日志组”API接口获取。

lts_stream_id

是

String

LTS日志流ID。可通过云日志服务中“查询指定日志组下的所有日志流”API接口获取。

响应参数

状态码：200

无响应参数。

请求示例

  • URI样例 
    POST https://{Endpoint}/v3/0549b4a43100d4f32f51c01c2fe4acdb/instances/logs/lts-configs
  • 慢日志关联LTS日志流 
    { 
  "instance_ids" : [ "fe45815ce8a6413ab7fa290da1db1614in12", "362b42f769ff45d884e1866f8ee00bb4in12" ], 
  "log_type" : "slow_log", 
  "lts_group_id" : "65442dd4-b8de-4e9f-8a80-b60aa0698354", 
  "lts_stream_id" : "5992dd29-fd11-4228-a852-5f6e578789c5" 
}
  • 审计日志关联LTS日志流 
    { 
  "instance_ids" : [ "fe45815ce8a6413ab7fa290da1db1614in12", "362b42f769ff45d884e1866f8ee00bb4in12" ], 
  "log_type" : "audit_log", 
  "lts_group_id" : "65442dd4-b8de-4e9f-8a80-b60aa0698354", 
  "lts_stream_id" : "5992dd29-fd11-4228-a852-5f6e578789c5" 
}

响应示例

状态码： 200

Success

{}

状态码

请参见状态码。

错误码

请参见错误码。

父主题： 日志管理

相关文档