?? ? ? ??

[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

?? ? ? ? ? ? ?

?? ? ? ? ? ? ? ? ??

?? ? ? ? ? ? ??

?? ? ? ? ? ??