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

阅读本文前，请先阅读：

云集成

Tip

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

Tip

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

1. 配置结构¶

本采集器配置结构如下：

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

Tip

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

Tip

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

2. 配置示例¶

指定地域¶

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

collector_configs = {
    'regions': [ 'cn-hangzhou', 'cn-shanghai' ],
}

指定数据库类型¶

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

collector_configs = {
    'engine_types': [ 'MySQL', 'PostgreSQL']
}

3. 数据上报格式¶

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

上报的数据示例如下：

{
  "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	最后一条语句影响行数

Note

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

Note

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

Tip

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

X. 附录¶

请参考阿里云官方文档：