采集器「华为云-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_detail",
  "tags": {
    "RegionId"                : "cn-north-4",
    "charge_info.charge_mode" : "postPaid",
    "database"                : "xxx_test",
    "enable_ssl"              : "False",
    "engine"                  : "MySQL",
    "engine_version"          : "5.7",
    "id"                      : "9cb9936ba89xxx9df209603in01",
    "instance_name"           : "rds-3b91-0711",
    "name"                    : "9cb9936ba89xxx9df209603in01",
    "port"                    : "3306",
    "project_id"              : "c631f046252d4ebda45f253c62d48585",
    "security_group_id"       : "d13ebb59-d4fe-xxxx-xxxx-c22bcea6f987",
    "status"                  : "ACTIVE",
    "switch_strategy"         : "",
    "time_zone"               : "UTC+08:00",
    "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. 注意事项

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 获取慢日志明细信息