采集器「华为云-RDS 慢日志统计采集器」配置手册

阅读本文前，请先阅读：

观测云集成 / 基本操作

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

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

1. 配置结构

本采集器配置结构如下：

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

2. 配置示例

指定地域

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

Python
collector_configs = {
    'region_projects': {
        'cn-north-4': ['c631f046252d4exxxxxxxxxxx', '15c6ce1c12da40xxxxxxxx9'],
    }
}

3. 数据上报格式

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

上报的数据示例如下：

JSON
{
  "measurement": "huaweicloud_rds_slowlog",
  "tags": {
    "name"                   : "4e0323877e5axxxxxxxxxxxxxxx61in01",
    "database"               : "test",
    "type"                   : "SELECT",
    "RegionId"               : "cn-north-4",
    "account_name"           : "脚本开发用华为云账号",
    "charge_info_charge_mode": "postPaid",
    "cloud_provider"         : "huaweicloud",
    "enable_ssl"             : "False",
    "id"                     : "4e0323877e5axxxxxxxxxxxxb61in01",
    "instance_name"          : "rds-xxxxx",
    "port"                   : "3306",
    "project_id"             : "c631f046252d4exxxxxxxxxx62d48585",
    "security_group_id"      : "d13ebb59-d4fe-xxxx-xxxx-c22bcea6f987",
    "status"                 : "ACTIVE",
    "time_zone"              : "UTC+08:00"
  },
  "fields": {
    "count"                  : "2 (100.00%)",
    "query_time"             : "2.50017 s",
    "lock_time"              : "0.00000 s",
    "rows_sent"              : "1",
    "rows_examined"          : "1",
    "client_ip"              : "100.*.*.128",
    "query_sample"           : "SELECT sleep(N) LIMIT N, N;",
    "message"                : "{实例 JSON 数据}"
  }
}

部分参数说明如下

字段	类型	说明
`count`	str	SQL 的执行次数和占比。
`query_time`	str	平均执行时间。
`lock_time`	str	平均等待锁时间，仅MySQL支持。
`rows_sent`	integer	平均结果统计数量，仅MySQL支持。
`rows_examined`	integer	平均扫描的行数量，仅MySQL支持。

4. 注意事项

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

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

5. 故障排除

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

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

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

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

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

解决方法：忽略即可

X. 附录

HuaWeiCloud-RDS「地域」

请参考 HuaWeiCloud 官方文档：

HuaWeiCloud-RDS 地域 ID

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

请参考 HuaWeiCloud 官方文档：

HuaWeiCloud-RDS 获取慢日志统计信息