adonato/query-exporter Docker 镜像 - 轩辕镜像

镜像概述

query-exporter 是一个 Prometheus 导出器，允许通过数据库查询收集指标，支持按指定时间间隔或按需（请求时）收集数据并转换为 Prometheus 指标格式。

核心功能和特性

• 从 SQL 查询结果生成 Prometheus 指标
• 支持定时收集或按需触发指标收集
• 内置环境变量管理，支持通过 .env 文件加载配置
• 可自定义 dotenv 文件位置（通过 QE_DOTENV 环境变量）

支持的数据库

• PostgreSQL（postgresql://）
• MySQL（mysql://）
• SQLite（sqlite://）
• Microsoft SQL Server（mssql://）
• IBM DB2（db2://）
• Oracle（oracle://）
• ClickHouse（clickhouse+native://）
• Teradata（teradatasql://）

使用场景

适用于需要通过 SQL 查询监控数据库性能、业务指标或自定义数据，并将其集成到 Prometheus 监控系统的场景。

使用方法

基本运行命令

shell
docker run --rm -it -p 9560:9560/tcp -v "$CONFIG_DIR:/config" adonato/query-exporter:latest

其中 $CONFIG_DIR 是包含 config.yaml 配置文件的目录绝对路径，也可指定卷名。

配置说明

1. 配置文件：需在挂载的 /config 目录中提供 config.yaml，用于定义数据库连接、查询规则和指标定义。

2. 环境变量与 dotenv 支持：

   • 若 /config 目录存在 .env 文件，其内容将自动加载为环境变量
   • 通过设置 QE_DOTENV 环境变量可自定义 dotenv 文件路径

更多信息

详见官方仓库。