quintoandar/rds_exporter

RDS Exporter

概述

用于https://github.com/prometheus/prometheus%E7%9A%84AWS RDS指标导出器，可从CloudWatch基本指标和通过CloudWatch Logs的RDS增强监控中获取指标。

核心功能与特性

• 多指标源支持：同时获取CloudWatch基本指标和RDS增强监控指标
• 灵活的凭证管理：支持IAM角色、访问密钥及AWS默认凭证链
• 多实例监控：可配置多个AWS区域的RDS实例
• 自定义标签：支持为指标添加自定义标签
• Prometheus兼容：生成符合Prometheus规范的指标格式

使用场景与适用范围

适用于需要通过Prometheus监控AWS RDS实例性能的场景，包括：

• DevOps团队监控RDS数据库运行状态
• SRE团队构建RDS性能告警系统
• 需要整合RDS指标到统一监控平台的企业环境
• 对RDS实例进行深度性能分析的场景

使用方法与配置说明

快速开始

1. 创建配置文件

创建config.yml配置文件，示例如下：

yaml
---
instances:
  - region: us-east-1
    instance: rds-aurora1

  - region: us-east-1
    instance: rds-mysql57
    aws_access_key: AKIAIOSFODNN7EXAMPLE
    aws_secret_key: wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY
    aws_role_arn: arn:aws:iam::76784568345:role/my-role
    disable_basic_metrics: true
    disable_enhanced_metrics: false
    labels:
      foo: bar
      baz: qux

配置参数说明：

• instances: RDS实例配置列表
  • region: AWS区域（必填）
  • instance: RDS实例标识符（必填）
  • aws_access_key/aws_secret_key: AWS访问密钥对（可选）
  • aws_role_arn: 要假定的IAM角色ARN（可选）
  • disable_basic_metrics: 是否禁用基本指标获取（默认false）
  • disable_enhanced_metrics: 是否禁用增强指标获取（默认false）
  • labels: 附加到指标的自定义标签（可选）

凭证优先级：

1. 若配置aws_role_arn，则使用该IAM角色
2. 否则，使用aws_access_key和aws_secret_key
3. 最后，使用AWS默认凭证链（环境变量、~/.aws/credentials文件或EC2 IAM角色）

2. Docker部署

使用docker run启动

bash
docker run -d \
  -v /path/to/config.yml:/config.yml \
  -p 9042:9042 \
  --name rds-exporter \
  quintoandar/rds-exporter \
  --config.file=/config.yml

参数说明：

• -v /path/to/config.yml:/config.yml: 挂载本地配置文件到容器内
• -p 9042:9042: 暴露指标端口（默认端口9042）
• --config.file=/config.yml: 指定配置文件路径

查看所有可用参数

bash
docker run --rm quintoandar/rds-exporter --help

3. 配置Prometheus

在Prometheus配置文件中添加如下抓取配置：

yaml
---
scrape_configs:
  - job_name: rds-basic
    scrape_interval: 60s
    scrape_timeout: 55s
    metrics_path: /basic
    honor_labels: true
    static_configs:
      - targets:
          - rds-exporter:9042  # 容器名称或IP:端口

  - job_name: rds-enhanced
    scrape_interval: 10s
    scrape_timeout: 9s
    metrics_path: /enhanced
    honor_labels: true
    static_configs:
      - targets:
          - rds-exporter:9042  # 容器名称或IP:端口

注意：honor_labels: true 必须设置，因为导出器返回的指标已包含instance和region标签。

指标说明

导出器会生成类似node_exporter的指标格式。可查看以下指标列表：

• https://github.com/quintoandar/rds_exporter/blob/main/basic/testdata/all.txt
• https://github.com/quintoandar/rds_exporter/tree/main/enhanced/testdata%EF%BC%88%E6%96%87%E6%9C%AC%E6%96%87%E4%BB%B6%EF%BC%89

成本说明

Amazon对CloudWatch API请求收费，详见当前收费标准。

每获取一个指标需一个API请求（可包含多个统计数据）。按每分钟100个请求、每百万请求10计算（截至2018年8月），月成本约为45。