跳转至

采集器「阿里云-RDS 慢查询明细日志」配置手册

阅读本文前，请先阅读：

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

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

1. 配置结构

本采集器配置结构如下：

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

因明细慢日志数据量过大，推荐配置 engine_types 参数

engine_types 可选参数：MySQL, PostgreSQL, SQLServer, MariaDB

2. 配置示例

指定地域

采集杭州、上海地域的数据

Python
1
2
3
collector_configs = {
    'regions': [ 'cn-hangzhou', 'cn-shanghai' ],
}

指定数据库类型

采集 MySQL, PostgreSQL类型数据库的数据

Python
1
2
3
collector_configs = {
    'engine_types': [ 'MySQL', 'PostgreSQL']
}

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
26
27
28
29
30
31
32
33
{
  "measurement": "aliyun_rds_slowlog",
  "tags": {
    "name"                 : "rm-xxxxx",
    "DBName"               : "cloudcare_core",
    "DBInstanceId"         : "rm-bp1xxxxxxxxxx",
    "RegionId"             : "cn-hangzhou",
    "DBInstanceType"       : "Primary",
    "PayType"              : "Prepaid",
    "Engine"               : "MySQL",
    "DBInstanceClass"      : "rds.mysql.s2.large",
    "ZoneId"               : "cn-shanghai-h",
    "DBInstanceDescription": "业务系统",
    "HostAddress"          : "xxxx",
    "UserName"             : "xxxx",
    "ClientHostName"       : "xxxx",
    "ApplicationName"      : "xxxx",

  },
  "fields": {
    "SQLHASH"              : "436f9dd030e0a87920bbcd818b34f271",
    "SQLText"              : "{SQL 语句}",
    "QueryTimes"           : 0,
    "QueryTimesMS"         : 0,
    "ReturnRowCounts"      : 0,
    "ParseRowCounts"       : 0,
    "ExecutionStartTime"   : "2022-02-02T12:00:00Z",
    "CpuTime"              : 1,
    "RowsAffectedCount"    : 0,
    "LastRowsAffectedCount": 0,
    "message"              : "{日志 JSON 数据}"
  }
}

部分参数说明如下：

字段 类型 说明
QueryTimes int 执行时长。单位：秒（s）
QueryTimesMS int 执行时长。单位：毫秒（ms）
ReturnRowCounts int 返回行数
ParseRowCounts int 解析行数
ExecutionStartTime str 执行开始时间
CpuTime int CPU处理时长
RowsAffectedCount int 影响行数
LastRowsAffectedCount int 最后一条语句影响行数

CpuTime、RowsAffectedCount、LastRowsAffectedCount等字段仅 SQL Server 实例支持

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

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

X. 附录

请参考阿里云官方文档：