采集器「华为云-RDS 慢日志明细采集器」配置手册¶

阅读本文前，请先阅读：

云集成

Tip

使用本采集器前，必须安装「集成 Core 核心包」及其配套的第三方依赖包

Tip

本脚本的代码运行依赖 RDS 实例对象采集，如果未配置 RDS 的自定义对象采集，慢日志脚本无法采集到慢日志数据

1. 配置结构¶

本采集器配置结构如下：

配置一（推荐）

字段	类型	是否必须	说明
`regions`	list	必须	所需采集的地域列表
`regions[#]`	str	必须	地域 ID。如：`'cn-north-4'` 总表见附录

Tip

采集器会自动获取地域下的所有 IAM 项目，再根据 IAM 项目获取资源

配置二（旧版兼容）

字段	类型	是否必须	说明
`region_projects`	dict	必须	所需采集数据的「地域 - 项目 ID」列表
`region_projects[#]`	str:list	必须	键值对中： Key 代表地域（如：`'cn-north-4'`） Value 代表该地域下所需采集的项目 ID 列表总表见附录

2. 配置示例¶

指定地域¶

采集cn-north-4地域对应项目的 RDS 慢日志数据

collector_configs = {
    'regions': ['cn-north-4']
}

3. 数据上报格式¶

数据正常同步后，可以在观测云的「日志」中查看数据。

上报的数据示例如下：

部分参数说明如下 name="__codelineno-1-1">{ "measurement": "huaweicloud_rds_slowlog_detail", "tags": { "RegionId" : "cn-north-4", "project_id" : "c631f046252dxxxxxxxf253c62d48585", "enterprise_project_id" : "0", "instance_id" : "1d0c91561f4644dxxxxxxd68304b0520din01", "instance_name" : "rds-df54-xxxx", "status" : "ACTIVE", "type" : "Single", "engine" : "MySQL", "database" : "xxx_test", "type" : "SELECT", "users" : "root" }, "fields": { "client_ip" : "100.*.*.68", "count" : "1", "execution_time" : "0.000146 s", "lock_time" : "0.000072", "rows_examined" : "2", "rows_sent" : "0", "start_time" : "2023-07-11T07:08:59", "query_sample" : "SELECT sleep(N) LIMIT N, N;", "message" : "{实例 JSON 数据}" } }

字段	类型	说明
`count`	str	SQL 的执行次数。
`execution_time`	str	执行时间。
`start_time`	str	执行时刻（UTC时间）。
`lock_time`	str	等待锁时间，仅MySQL支持。
`rows_sent`	integer	结果统计数量，仅MySQL支持。
`rows_examined`	integer	扫描的行数量，仅MySQL支持。

4. 注意事项¶

Note

tags、fields 中的字段可能会随后续更新有所变动

Tip

fields.message 为 JSON 序列化后字符串

5. 故障排除¶

运行程序时，可能会遇到如下问题报错：

调用接口错误：
[ClientRequestException]{status_code:404,request_id:a8bf4ee50523dab10e631e51aed70196,error_code:None,error_msg:{"errCode":"DBS.280110","externalMessage":"Selected DB instance does not exist."} }

错误提示后面会打印对应实例的相关信息，如：

实例信息：{'region_id': 'xxx', 'project_id': 'xxx', 'instance_id': 'xxx'}

原因：某个 RDS 实例对应的慢日志数据时，该实例已经被释放了，造成接口抛错

解决方法：忽略即可

X. 附录¶

HuaWeiCloud-RDS「地域」¶

请参考 HuaWeiCloud 官方文档：

HuaWeiCloud-RDS 地域 ID

HuaWeiCloud-RDS「慢日志信息说明文档」¶