​        

[root@Oracle11g ~]# tar -zxvf oracledb_exporter.tar.gz 

[root@Oracle11g ~]# mkdir -p /opt/prometheus
[root@Oracle11g ~]# mv oracledb_exporter-0.5.2.linux-amd64 /opt/prometheus/
[root@Oracle11g ~]# mv /opt/prometheus/oracledb_exporter-0.5.2.linux-amd64 /opt/prometheus/oracledb_exporter

[root@Oracle11g ~]# groupadd prometheus
[root@Oracle11g ~]# useradd -g prometheus -M -s /usr/sbin/nologin prometheus     ---创建一个名为prometheus的系统账号，该账号没有家目录并且不能登录Shell。这种设置适用于需要运行服务或任务而不需要用户交互的情况。
-M：不为用户创建家目录。对于系统服务账号来说，通常不需要家目录，因此使用 -M 可以跳过家目录的创建步骤。
-s /usr/sbin/nologin：指定用户登录时使用的Shell。将用户prometheus的登录Shell设置为/usr/sbin/nologin。nologin Shell的作用是阻止用户登录系统，但允许该用户拥有有效的系统账号。这通常用于服务账号，因为它们不需要交互式Shell访问，仅用于执行特定服务或任务。[root@Oracle11g ~]# passwd prometheus[root@Oracle11g ~]# id prometheus

[root@Oracle11g ~]# chown -R prometheus:prometheus /opt/prometheus/oracledb_exporter

[root@Oracle11g ~]# cd /usr/lib/systemd/system
[root@Oracle11g ~]# vi oracledb_orcl_exporter.service[Unit]
Description=oracledb_exporter
After=network.target[Service]
Type=simple
User=prometheus
Group=prometheus
Restart=on-failure
ExecStart=/opt/prometheus/oracledb_exporter/oracledb_exporter --database.dsn "oracle://oracle_exporter:123456@192.168.56.17:1521/orcl" --default.metrics "/opt/prometheus/oracledb_exporter/default-metrics.toml" --web.listen-address=0.0.0.0:9161[Install]
WantedBy=multi-user.target[root@Oracle11g ~]# systemctl daemon-reload
[root@Oracle11g ~]# systemctl start oracledb_orcl_exporter.service
[root@Oracle11g ~]# systemctl enable oracledb_orcl_exporter.service
[root@Oracle11g ~]# systemctl status oracledb_orcl_exporter.service

​###--default.metrics=：指定toml文件，toml文件中包含指定的指标。oracledb_exporter的0.5.2版本是没有包含toml文件的，一般都是开发者自己编辑，然后指定该toml文件。需要注意此参数不能使用 = ，使用的话会报错：ts=2024-09-16T12:42:45.684Z caller=default_metrics.go:81 level=error therewasanissuewhileloadingspecifieddefaultmetricsfileat:/opt/prometheus/oracledb_exporter/default-metrics.toml,proceedingtorunwithdefaultmetrics.="open \"/opt/prometheus/oracledb_exporter/default-metrics.toml\": no such file or directory"。

[root@Oracle11g ~]# cd /etc/init.d/
[root@Oracle11g ~]# vi oracledb_orcl_exporter#!/bin/bash
# chkconfig: 2345 99 10
# description: Oracle Exporter for Oracle instance orclDAEMON="/opt/prometheus/oracledb_exporter/oracledb_exporter"
DAEMON_OPTS="--database.dsn oracle://oracle_exporter:123456@192.168.56.17:1521/orcl --default.metrics /opt/prometheus/oracledb_exporter/default-metrics.toml --web.listen-address=0.0.0.0:9161"case "$1" instart)echo "Starting oracledb_orcl_exporter"$DAEMON $DAEMON_OPTS &;;stop)echo "Stopping oracledb_orcl_exporter"pkill -f "$DAEMON $DAEMON_OPTS";;restart)$0 stop$0 start
;;status)PID=$(pgrep -f "$DAEMON $DAEMON_OPTS")if [ -n "$PID" ]; thenecho "oracledb_orcl_exporter is running with PID: $PID"elseecho "oracledb_orcl_exporter is not running"fi
;;*)echo "Usage: $0 {start|stop|restart|status}"exit 1;;
esacexit 0[root@Oracle11g ~]# chmod 755  /etc/init.d/oracledb_orcl_exporter
[root@Oracle11g ~]# chkconfig --add oracledb_orcl_exporter [root@Oracle11g ~]# service  oracledb_orcl_exporter  start
[root@Oracle11g ~]# chkconfig  oracledb_orcl_exporter  on  [root@Oracle11g ~]# service oracledb_orcl_exporter status

[root@prometheus ~]# vi /opt/prometheus/prometheus.yml    
在scrape_configs下面新增如下内容：# oracledb_exporter配置           - job_name: "oracledb_exporter"      ###job_name 用来唯一标识一个监控任务。在同一个 prometheus.yml 文件中，不同的 scrape_config可以有不同的job_name，以便 Prometheus 能够区分和管理不同的监控目标和配置，用来将不同的监控目标分组。单位为监控Oracle数据库设置一个独立的job_namescrape_interval: 15s              ###指定这个job_name每隔多久从每个目标（如 Exporter、应用端点）拉取一次指标数据。优先级：会覆盖全局的 global:scrape_interval（如果存在）。file_sd_configs:- files:- /opt/prometheus/conf.d/oracle_targets.json           #### Oracle需要监控的实例都单独写在了oracle_targets.json文件中，是为了避免prometheus.yml内容过多，看起来更简洁[root@prometheus ~]# vi /opt/prometheus/conf.d/oracle_targets.json        
###因为使用的是17136 json模版，17136模版中在页头定义了group（group）、数据库ip（oracle_ip）、数据库实例（oracle_instance）信息，所以在配置文件中就必须定义这些内容。如果添加了多个targets，但每个targets都没有定义group（group）、数据库ip（oracle_ip）、数据库实例（oracle_instance）信息，就会导致在grafana界面上无法选择对应目标targets的监控信息。所以用17136 json模版，就必须添加
[{"targets": [ "192.168.56.17:9161" ],"labels": {"type": "db","group": "192.168.56.17 orcl实例","oracle_ip": "192.168.56.17","oracle_instance": "orcl"}}
]

[root@prometheus ~]# cd /opt/prometheus/rules/    ###在prometheus.yml文件中定义了告警规则文件rule_files参数
[root@prometheus rules]# vi oracledb_alerts.yml groups:- name: oracledb_alertsrules:- alert: OracleDBDownexpr: oracledb_up == 0for: 3slabels:severity: criticalannotations:summary: "Oracle 数据库实例宕机"description: "Oracle 实例 {{ $labels.instance }} 当前不可用，请立即检查！"- alert: OracleSessionUsageexpr: sum(oracledb_sessions_value) by (instance, oracle_ip, oracle_instance) / sum(oracledb_parameter_sessions_value) by (instance, oracle_ip, oracle_instance) * 100 > 90for: 3slabels:severity: criticalannotations:summary: "Oracle 会话使用率过高"description: "当前 Oracle 实例 {{ $labels.instance }} 的会话与限额百分比已达到 {{ $value | printf \"%.2f\" }}%，超过 90%。请及时检查会话使用情况！"- alert: OracleTablespaceUsageexpr: (1 - oracledb_tablespace_free / oracledb_tablespace_bytes) * 100 > 90for: 3slabels:severity: criticalannotations:summary: "Oracle 表空间使用率过高"description: "当前 Oracle 实例 {{ $labels.instance }} 的 {{ $labels.tablespace }} 表空间使用率已达到 {{ $value | printf \"%.2f\" }}%，超过 90%。请及时检查表空间使用情况！"- alert: OracleDataGuardStatusIssueexpr: oracledb_dataguard_status_value == 1for: 3slabels:severity: criticalannotations:summary: "Oracle Data Guard 进程存在异常"description: "当前 Oracle 实例 {{ $labels.instance }} 不能将归档日志传输到备库，请检查备库alert日志排查问题或排除MRP进程是否启动！"

[root@prometheus ~]# cd /opt/prometheus/
[root@prometheus ~]# ./promtool check config prometheus.yml      ###用于检查 Prometheus 配置文件（prometheus.yml）的语法和格式是否正确。

​                  

[root@prometheus ~]# curl -X POST http://localhost:9090/-/reload

[root@prometheus ~]# systemctl restart prometheus.service

​             

​                  

​              

​