justwatch/sql_exporter

Prometheus SQL Exporter 镜像文档

镜像概述

该镜像包含一个用于Prometheus监控系统的灵活SQL Exporter，核心功能是从各类SQL数据库中收集指标数据，并按照Prometheus兼容格式导出，以便Prometheus进行数据抓取、存储和监控分析。

核心功能和特性

• 多数据库支持：兼容主流关系型数据库（如MySQL、PostgreSQL、SQL Server等）
• 灵活配置：支持自定义SQL查询以收集特定业务指标
• Prometheus集成：原生支持Prometheus指标格式，可直接被Prometheus抓取
• 轻量级部署：容器化设计，资源占用低，易于集成到现有监控体系

使用场景和适用范围

• 监控SQL数据库性能指标（连接数、查询延迟、表空间使用率等）
• 收集业务系统自定义SQL指标（如订单量、用户活跃度等）
• 为Prometheus提供数据库层监控数据，用于构建监控面板和告警规则
• 适用于DevOps、SRE团队及数据库管理员对SQL数据库进行监控

使用方法和配置说明

基本部署（Docker Run）

bash
docker run -d \
  --name sql-exporter \
  -p 9237:9237 \  # 默认暴露端口
  -v /host/path/to/config.yml:/etc/sql-exporter/config.yml \  # 挂载配置文件
  prometheus-sql-exporter

配置文件说明

需通过配置文件定义数据库连接信息和指标查询规则，典型配置文件（config.yml）结构如下：

yaml
# 全局配置
global:
  scrape_interval: 15s  # 指标抓取间隔

# 数据库配置
databases:
  - name: mysql_production
    driver: mysql
    dsn: "user:password@tcp(mysql-host:3306)/dbname?parseTime=true"  # 数据库连接串
    max_open_connections: 5  # 最大连接数
    queries:
      - name: mysql_active_connections
        help: "Number of active database connections"
        sql: "SELECT COUNT(*) AS value FROM information_schema.processlist WHERE user IS NOT NULL"
        metrics:
          - name: mysql_active_connections_total
            type: gauge
            value: "value"  # 从查询结果中取value字段作为指标值

关键配置参数

验证与测试

部署后可通过访问以下地址验证指标是否正常导出：

http://<容器IP>:9237/metrics

成功导出后，在Prometheus配置文件中添加如下抓取配置：

yaml
scrape_configs:
  - job_name: 'sql-exporter'
    static_configs:
      - targets: ['sql-exporter:9237']