​        

[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 orcl

DAEMON="/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" in
  start)
    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" ]; then
      echo "oracledb_orcl_exporter is running with PID: $PID"
    else
      echo "oracledb_orcl_exporter is not running"
    fi
;;

  *)
    echo "Usage: $0 {start|stop|restart|status}"
    exit 1
    ;;
esac

exit 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_name
    scrape_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_alerts
    rules:
      - alert: OracleDBDown
        expr: oracledb_up == 0
        for: 3s
        labels:
          severity: critical
        annotations:
          summary: "Oracle 数据库实例宕机"
          description: "Oracle 实例 {{ $labels.instance }} 当前不可用，请立即检查！"

      - alert: OracleSessionUsage
        expr: sum(oracledb_sessions_value) by (instance, oracle_ip, oracle_instance) / sum(oracledb_parameter_sessions_value) by (instance, oracle_ip, oracle_instance) * 100 > 90
        for: 3s
        labels:
          severity: critical
        annotations:
          summary: "Oracle 会话使用率过高"
          description: "当前 Oracle 实例 {{ $labels.instance }} 的会话与限额百分比已达到 {{ $value | printf \"%.2f\" }}%，超过 90%。请及时检查会话使用情况！"

      - alert: OracleTablespaceUsage
        expr: (1 - oracledb_tablespace_free / oracledb_tablespace_bytes) * 100 > 90
        for: 3s
        labels:
          severity: critical
        annotations:
          summary: "Oracle 表空间使用率过高"
          description: "当前 Oracle 实例 {{ $labels.instance }} 的 {{ $labels.tablespace }} 表空间使用率已达到 {{ $value | printf \"%.2f\" }}%，超过 90%。请及时检查表空间使用情况！"
         
      - alert: OracleDataGuardStatusIssue
        expr: oracledb_dataguard_status_value == 1
        for: 3s
        labels:
          severity: critical
        annotations:
          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

​             

​                  

​              

​