一、下载oracledb_exporter安装包

1、本地下载后上传到linux服务器

下载地址：https://github.com/iamseth/oracledb_exporter/releases

2、直接在linux服务器上wget方式下载

# 新建目录
mkdir -p /data/prometheus/oracle_exporter
# 进入目标目录
cd /data/prometheus/oracle_exporter
# 下载
wget https://github.com/iamseth/oracledb_exporter/releases/download/0.3.0rc1/oracledb_exporter.0.3.0rc1-ora18.5.linux-amd64.tar.gz
# 解压
tar -vxzf oracledb_exporter.0.3.0rc1-ora18.5.linux-amd64.tar.gz
# 移动到安装目录
mv /data/prometheus/oracle_exporter/oracledb_exporter.0.3.0rc1-ora18.5.linux-amd64 /data/prometheus/oracle_exporter/oracledb_exporter
# 进入目录
cd /data/prometheus/oracle_exporter/oracledb_exporter

3、启动oracledb_exporter

# 进入目录
cd /data/prometheus/oracle_exporter/oracledb_exporter
# 前台启动
./oracledb_exporter -log.level error
# 后台启动，并且重定向输入日志到当前目录的oracledb_exporter.out
nohup ./oracledb_exporter --log.level error >> /data/prometheus/oracle_exporter/oracledb_exporter/oracledb_exporter.out 2>&1 &

# 日志输出级别
--log.level error/warn/info
# 指定端口，不指定就是默认9161端口，官方给的配置是0.0.0.0:9161
--web.listen-address=:9161
# 指定指标配置文件，不指定就是默认的指标配置文件
--default.metrics ./default-metrics.toml

参数解析

# 进入目录
cd /data/prometheus/oracle_exporter/oracledb_exporter
# 查看参数
./oracledb_exporter --help
usage: oracledb_exporter [<flags>]
 
Flags:
  -h, --help                     Show context-sensitive help (also try --help-long and --help-man).
      --web.listen-address=":9161"  
                                 Address to listen on for web interface and telemetry. (env: LISTEN_ADDRESS)
      --web.telemetry-path="/metrics"  
                                 Path under which to expose metrics. (env: TELEMETRY_PATH)
      --default.metrics="default-metrics.toml"  
                                 File with default metrics in a TOML file. (env: DEFAULT_METRICS)
      --custom.metrics=""        File that may contain various custom metrics in a TOML file. (env: CUSTOM_METRICS)
      --query.timeout="5"        Query timeout (in seconds). (env: QUERY_TIMEOUT)
      --database.maxIdleConns=0  Number of maximum idle connections in the connection pool. (env: DATABASE_MAXIDLECONNS)
      --database.maxOpenConns=10  
                                 Number of maximum open connections in the connection pool. (env: DATABASE_MAXOPENCONNS)
      --log.level="info"         Only log messages with the given severity or above. Valid levels: [debug, info, warn, error, fatal]
      --log.format="logger:stderr"  
                                 Set the log target and format. Example: "logger:syslog?appname=bob&local=7" or "logger:stdout?json=true"
      --version                  Show application version.

二、将oracledb_exporter配置为系统服务

1、进入systemd目录

cd /usr/lib/systemd/system

2、创建文件

vim oracledb_exporter.service

# 添加如下内容
[Unit]
Description=https://github.com/iamseth/oracledb_exporter
After=network-online.target
  
[Service]
Restart=on-failure
ExecStart=/data/prometheus/oracle_exporter/oracledb_exporter --default.metrics "/data/prometheus/oracle_exporter/default-metrics.toml" --log.level error --web.listen-address 0.0.0.0:9161

[Install]                      
WantedBy=multi-user.target

3、生效系统systemd文件

systemctl daemon-reload

4、设置开机自启

systemctl enable oracledb_exporter

5、启动和停止服务命令

# 查看状态
systemctl status oracledb_exporter
# 启动
systemctl start oracledb_exporter.service
# 停止
systemctl stop oracledb_exporter.service

四、添加 Prometheus 监控配置

# 进入 prometheus 文件夹
cd /usr/local/prometheus
# 编辑 prometheus 配置文件
vim prometheus.yml

# 添加内容如下
- job_name: 'oracle_exporter'
  static_configs:
  - targets: ['192.168.3.105:9161']

五、默认指标

当把oracledb_exporter的二进制包解压到规划的目录后，其下面还包含了一个default-metrics.toml文件，这个是默认的指标配置文件。根据官方给出的数量，默认的指标共计有25个。如果没有额外的监控指标需求，当然可以使用默认的，启动时指定参数--default.metrics="default-metrics.toml"就好。当然，默认的指标也是可以不用的。如果有自定义监控指标的需求，当然就使用自定义监控指标了。