跳转至

采集器「华为云-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
1
2
3
4
5
collector_configs = {
    'region_projects': {
        'cn-north-4': ['c631f046252d4exxxxxxxxxxx', '15c6ce1c12da40xxxxxxxx9'],
    }
}

3. 数据上报格式

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

上报的数据示例如下:

JSON
 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
{
  "measurement": "huaweicloud_rds_slowlog",
  "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"               : "test",
    "type"                   : "SELECT",
  },
  "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
1
2
调用接口错误:
[ClientRequestException]{status_code:404,request_id:a8bf4ee50523dab10e631e51aed70196,error_code:None,error_msg:{"errCode":"DBS.280110","externalMessage":"Selected DB instance does not exist."} }

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

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

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

解决方法:忽略即可

X. 附录

HuaWeiCloud-RDS「地域」

请参考 HuaWeiCloud 官方文档:

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

请参考 HuaWeiCloud 官方文档: