yannig/oracledb_exporter

Oracle DB Exporter for Prometheus

镜像概述

本镜像为Prometheus的Oracle数据库导出器，是iamseth/oracledb_exporter的分支版本。其核心功能是采集Oracle数据库的性能指标，并将指标暴露给Prometheus监控系统。该导出器支持通过外部TOML文件自定义指标配置，提供灵活的指标采集能力。

核心功能与特性

支持的指标

当前暴露的指标包括：

• oracledb_exporter_last_scrape_duration_seconds: 最近一次指标采集的持续时间（秒）
• oracledb_exporter_last_scrape_error: 最近一次指标采集错误状态（1表示错误，0表示成功）
• oracledb_exporter_scrapes_total: 指标采集总次数
• oracledb_up: Oracle数据库连接状态（1表示连接正常，0表示连接失败）
• oracledb_activity_execute_count: SQL执行次数
• oracledb_activity_parse_count_total: SQL解析总次数
• oracledb_activity_user_commits: 用户提交次数
• oracledb_activity_user_rollbacks: 用户回滚次数
• oracledb_sessions_activity: 活动会话数
• oracledb_wait_time_application: 应用程序等待时间
• oracledb_wait_time_commit: 提交等待时间
• oracledb_wait_time_concurrency: 并发等待时间
• oracledb_wait_time_configuration: 配置等待时间
• oracledb_wait_time_network: 网络等待时间
• oracledb_wait_time_other: 其他等待时间
• oracledb_wait_time_scheduler: 调度器等待时间
• oracledb_wait_time_system_io: 系统I/O等待时间
• oracledb_wait_time_user_io: 用户I/O等待时间
• oracledb_tablespace_bytes: 表空间大小（字节）
• oracledb_tablespace_max_bytes: 表空间最大容量（字节）
• oracledb_tablespace_bytes_free: 表空间空闲容量（字节）
• oracledb_resource_current_utilization: 资源当前利用率
• oracledb_resource_limit_value: 资源限制值

自定义指标

可通过修改default-metrics.toml文件调整指标配置，详细说明参见项目GitHub仓库：https://github.com/Yannig/oracledb_exporter%E3%80%82

使用场景与适用范围

适用于需要对Oracle数据库进行性能监控的场景，包括：

• 数据库性能实时监控与分析
• 数据库资源利用率跟踪
• 数据库异常告警系统构建
• 数据库性能优化与容量规划

使用方法与配置说明

环境变量配置

运行容器时需配置以下核心环境变量：

• DATA_SOURCE_NAME: Oracle数据库连接字符串，格式为username/password@host:port/service_name（如使用SYSDBA权限，需添加as sysdba）

Docker Run部署示例

bash
docker run -d \
  -p 9161:9161 \
  -e DATA_SOURCE_NAME="sys/password@oracle:1521/ORCLCDB as sysdba" \
  -v /path/to/custom-metrics.toml:/default-metrics.toml \
  --name oracledb-exporter \
  [镜像名称]

Docker Compose部署示例

yaml
version: '3'
services:
  oracledb-exporter:
    image: [镜像名称]
    ports:
      - "9161:9161"
    environment:
      - DATA_SOURCE_NAME=sys/password@oracle:1521/ORCLCDB as sysdba
    volumes:
      - ./custom-metrics.toml:/default-metrics.toml  # 挂载自定义指标配置文件
    restart: always

指标访问

容器启动后，可通过http://<容器IP>:9161/metrics端点访问导出的指标，Prometheus可配置该地址进行指标采集。