大家好，这里是 Lucifer三思而后行，专注于提升数据库运维效率。
目录
前言
Oracle 数据库巡检通常需要消耗大量时间和精力，包括收集数据库以及主机的相关信息。针对 Word 报告的样式调整，也是重复和费事的，所以我针对 Oracle 巡检所需检查的信息以及报告模板，写了一套自动巡检并且生成报告的脚本。巡检人员只需要执行脚本，脚本会自动生成一个完整的 Word 报告（样式格式都无需调整），只需要检查报告中是否存在问题即可。
本文演示一套 19C RAC 的集群数据库自动巡检。
介绍
Oracle 一键巡检脚本可将巡检结果一键生成为 Word 报告！本脚本通过 python 将巡检结果生成为 Word 报告，分为两部分：
- 第一部分通过 shell 和 sql 脚本生成巡检压缩包
- 第二部分通过 python 解析巡检压缩包生成 Word 巡检报告
Word 报告内容主要包括：主机巡检，数据库巡检，DataGuard 同步检查，Rman 备份检查， rac 集群检查，数据库性能分析（awr 内部 sql 获取），抓取 alert日志，抓取 awr 报告等，内容极其丰富。如果是 rac，会抓取所有节点报告。
- 报告可选：周/月/季三种类型，生成的 Word 可直接交付客户
- 支持所有操作系统，所有版本
- 支持Oracle 10/11/12/18/19/21 等版本
- 支持 non-cdb/cdb 架构
- 如果一台主机有多个实例，支持一键巡检多个实例，生成一个巡检文件，方便快捷
- 支持一键生成多个数据库 Word 报告
- Word 报告生成支持自定义客户名称，巡检公司名称，巡检人员名称，巡检公司 LOGO等，直接解放双手
- Word 报告生成后根据数据库巡检结果，在 Word 中直接提供巡检建议，全程智能巡检
- 数据库主机无需安装任何第三方软件，只需要上传巡检脚本，一键执行生成巡检文件即可
- 脚本持续更新
咨询巡检脚本可扫码进微信群或者添加作者微信 Lucifer-0622：
Oracle 数据库主机只需需要上传对应 DB 的巡检脚本：
[oracle@rac01:/home/oracle/check]$ ll -rw-r--r-- 1 root root 202369 Mar 15 09:12 dbcheck10g.sql -rw-r--r-- 1 root root 206342 Mar 15 09:12 dbcheck11g.sql -rw-r--r-- 1 root root 207786 Mar 15 09:12 dbcheck12c.sql -rw-r--r-- 1 root root 24819 Mar 15 09:13 oscheck.sh复制
oscheck.sh 是用来巡检主机相关信息以及配置检查。
dbcheck*.sql 是用来巡检数据库相关信息，12c 包括 12c 以后的版本。
演示
Oracle 数据库巡检
Oracle 数据库其中一个节点上传巡检脚本（本文选择节点一）：
[root@rac01:/root]$ chown -R oracle:oinstall /home/oracle/check/ [oracle@rac01:/home/oracle/check]$ chmod +x oscheck.sh [oracle@rac01:/home/oracle/check]$ ll total 232 -rw-r--r-- 1 oracle oinstall 207786 Mar 15 09:12 dbcheck12c.sql -rwxr-xr-x 1 oracle oinstall 24819 Mar 15 09:13 oscheck.sh复制
执行脚本一键巡检 Oracle 数据库：
## 如果一台主机上有多个实例，可以通过参数 -o 来指定，例如：
sh oscheck.sh -o orcl,lucifer,test
## 确保 ORACLE_SID 正确后，执行脚本
[oracle@rac01:/home/oracle/check]$ sh oscheck.sh
#==============================================================#
Oracle数据库主机检查
#==============================================================#
收集主机 OS 层信息 ...
收集数据库补丁信息 ...
收集数据库监听信息 ...
#==============================================================#
检查数据库实例：luciferdg1
#==============================================================#
收集数据库ALERT日志 ...
收集数据库AWR报告 ...
Note1: Information about Instance
INST_ID DBID NAME DATABASE_ROLE CREATED LOG_MODE OPEN_MODE VERSION SESSIONID
---------- ---------- ---------- -------------------- -------------------- ------------- -------------------- ---------- --------------------
1 4019382963 LUCIFER PRIMARY 2024-03-13 10:21:39 ARCHIVELOG READ WRITE 19.0.0.0.0 392,13105,30182
2 4019382963 LUCIFER PRIMARY 2024-03-13 10:21:39 ARCHIVELOG READ WRITE 19.0.0.0.0 392,13105,30182
Note2: Information abount Recyclebin
+------------------------------------------------------------------------------------------------------------+
| Oracle Database health Check script |
|------------------------------------------------------------------------------------------------------------+
| Copyright (c) 2022-2100 lpc. All rights reserved. |
+------------------------------------------------------------------------------------------------------------+
DBHealthCheck Author: Lucifer
+----------------------------------------------------------------------------+
Now DBCheck staring, the time cost depending on size of database.
Begining ......500
+----------------------------------------------------------------------------+
-----Oracle Database Check STRAT, Starting Collect Data Dictionary Information----
start...Set Environment Variables, Configure html headers.....
start collect...Database Informaion...
start collect......Overview of Instance Informaion...
start collect......Overview of Database Informaion...
start collect......Database Version Informaion...
start collect......Database Component and Patch Informaion...
start collect......Database Parameter Informaion...
start collect......Database Resource Informaion...
start collect......Database ControlFile Informaion...
start collect......Database LogFile Informaion...
start collect......Archive Log Size in last 10 Days...
start collect......Invalid Object Informaion...
start collect......Tablespace Usage Informaion...
start collect......Top10 Index Informaion...
start collect......Range Partition Extend Check Informaion...
start collect......Object in System TableSpace Informaion...
start collect......BitCoin Attack Check...
start collect......SYSAUX Objects Informaion...
start collect......Flashback Database Parameters...
start...OverView Database User Information...
start collect......System Manager Role Informaion...
start collect......Schema Informaion...
start collect......Profile Informaion...
start collect......Directory Informaion...
start collect......Job Informaion...
start collect......Database Link Informaion...
start collect......Autotask Informaion...
start...OverView Database of Backup and Recover Information...
start collect......Dataguard Parameter...
start collect......Dataguard Applied Status...
start collect......Dataguard Status...
start collect......RMAN Backup Info...
start collect......Orphaned DataPump Jobs...
start collect......Instacne Alert Log...
start...OverView Database of ASM Information...
start collect......ASM Instance Informaion...
start collect......ASM Diskgroup Attribute...
start collect......ASM Disk Group...
start...OverView Database Performace Information...
start collect......AWR Configure Informaion...
start collect......Awrrpt Snap Informaion...
start collect......Awrrpt Load Profile Informaion...
start collect......Instance Efficiency Percentages...
start collect......TOP 10 Wait Event...
start collect......System Time Model...
start collect......TOP 10 SQL Order by Elapsed Time...
start collect......Awrcrt Informaion...
Database script execution ends....
压缩包位置: /home/oracle/check/dbcheck_rac01_20240315.tar.gz
复制执行完之后会在当前目录生成一个 tar 压缩包：
[oracle@rac01:/home/oracle/check]$ ll total 640 -rw-r--r-- 1 oracle oinstall 207786 Mar 15 09:12 dbcheck12c.sql drwxr-xr-x 2 oracle oinstall 227 Mar 15 09:28 dbcheck_rac01_20240315 -rw-r--r-- 1 oracle oinstall 417254 Mar 15 09:28 dbcheck_rac01_20240315.tar.gz -rwxr-xr-x 1 oracle oinstall 24819 Mar 15 09:13 oscheck.sh复制
这个就是脚本获取到的所有信息集合，包含以下内容：
[oracle@rac01:/home/oracle/check]$ cd dbcheck_rac01_20240315/
[oracle@rac01:/home/oracle/check/dbcheck_rac01_20240315]$ ll
## 节点1的 alert 日志
-rw-r--r-- 1 oracle oinstall 54530 Mar 15 09:27 alert_luciferdg1.log
## 节点2的 alert 日志
-rw-r--r-- 1 oracle oinstall 3785318 Mar 15 09:27 alert_luciferdg2.log
## 节点1的 awrrpt 报告
-rw-r--r-- 1 oracle oinstall 1506483 Mar 15 09:27 awrrpt_luciferdg1_13_46.html
## 节点2的 awrrpt 报告
-rw-r--r-- 1 oracle oinstall 1455454 Mar 15 09:27 awrrpt_luciferdg2_13_46.html
## Oracle Database 巡检报告 html 格式
-rw-r--r-- 1 oracle oinstall 121960 Mar 15 09:28 dbcheck_4019382963_LUCIFER_19.0.0.0.0_20240315.html
## Oracle 主机巡检报告 txt 格式
-rw-r--r-- 1 oracle oinstall 12823 Mar 15 09:27 oscheck_rac01_20240315.txt
复制接下来就是将 tar 文件获取到本地，进行 word 报告一键生成程序即可。
生成 Word 报告
放入巡检文件
通过 sftp 等工具获取到 tar 报告，放到 checkfiles 目录下：
╭─lucifer@Lucifer-2 /Volumes/DBA/Github/OracleHealthCheck/checkfiles ‹main●› ╰─$ ll total 816 -rw-r--r-- 1 lucifer staff 407K 3 15 09:38 dbcheck_rac01_20240315.tar.gz -rw-r--r--@ 1 lucifer staff 0B 1 22 10:19 请将巡检文件移动到此目录下.txt复制
配置 Python 环境
前置工作（必须满足）：
- 建议下载安装 Python 3 最新版本，并且配置好 Python 环境
- 下载安装 chrome 浏览器以及 chromedriver
- 需要安装以下 Python 模块，在根目录下执行：
pip install -r requirements.txt即可
Word 报告一键生成程序是通过 Python 来写的，完整程序目录如下：
╭─lucifer@Lucifer-2 /Volumes/DBA/Github/OracleHealthCheck ‹main●› ╰─$ tree -N . ├── README.md ├── checkfiles │ └── 请将巡检文件移动到此目录下.txt ├── example │ └── example.md ├── reports │ └── word 巡检报告将在此目录下生成.txt ├── requirements.txt ├── resources │ ├── chromedriver │ ├── config.ini │ ├── images │ │ └── Oracle.png │ ├── js │ │ └── crt21.js │ └── templates │ ├── Oracle数据库巡检报告模板_周.docx │ ├── Oracle数据库巡检报告模板_季.docx │ └── Oracle数据库巡检报告模板_月.docx ├── scripts │ ├── db │ │ ├── dbcheck10g.sql │ │ ├── dbcheck11g.sql │ │ └── dbcheck12c.sql │ └── os │ └── oscheck.sh └── src ├── awrcrt.py ├── create_config.py ├── create_desc.py ├── create_report.py ├── main.py └── parse_file.py复制
运行 Python 脚本需要安装 Python 运行环境，去官方下载最新的安装包即可：Download Python，注意：在安装 Python 时勾选 “Add Python to PATH” 复选框，安装程序会自动添加环境变量，否则需要手动配置。
安装好 Python 之后，运行命令安装依赖包：
## 命令行窗口进入到 requirements.txt 所在目录运行
╭─lucifer@Lucifer-2 /Volumes/DBA/Github/OracleHealthCheck ‹main●›
╰─$ pip install -r requirements.txt
复制等待安装完成即可。
接下来还需要下载 chromedriver 以及 Google Chrome 浏览器： Chrome for Testing availability
下载稳定版本后进行安装即可，chromedriver 下载解压后放到 resources 目录下（Windows的是有后缀的）：
╭─lucifer@Lucifer-2 /Volumes/DBA/Github/OracleHealthCheck/resources ‹main●› ╰─$ ll -rwxr-xr-x@ 1 lucifer staff 15M 3 12 07:17 chromedriver -rw-r--r--@ 1 lucifer staff 2.0K 2 29 14:00 config.ini drwxr-xr-x@ 4 lucifer staff 128B 1 22 12:28 images drwxr-xr-x@ 3 lucifer staff 96B 1 22 10:19 js drwxr-xr-x@ 5 lucifer staff 160B 1 22 10:19 templates复制
至此，脚本所需 Python 环境就配置好了。
生成 Word 报告
进入到 main.py 所在的目录 src：
╭─lucifer@Lucifer-2 /Volumes/DBA/Github/OracleHealthCheck/src ‹main●› ╰─$ ll -rw-r--r--@ 1 lucifer staff 3.2K 1 22 10:19 awrcrt.py -rw-r--r--@ 1 lucifer staff 3.0K 1 22 10:19 create_config.py -rw-r--r--@ 1 lucifer staff 14K 1 22 10:19 create_desc.py -rw-r--r--@ 1 lucifer staff 5.1K 1 22 10:19 create_report.py -rwxr-xr-x@ 1 lucifer staff 8.2K 1 22 10:19 main.py -rw-r--r--@ 1 lucifer staff 5.3K 1 22 10:19 parse_file.py复制
运行脚本调用图形化程序：
╭─lucifer@Lucifer-2 /Volumes/DBA/Github/OracleHealthCheck/src ‹main●› ╰─$ python main.py复制
运行完之后会弹出一个图形化报告生成工具：
工具页面包含可编辑选项：
- 客户公司名称
- 服务公司名称
- 巡检人员
- 服务公司 logo
- 巡检类型：根据不同巡检类型生成不同的报告内容
- 周
- 月
- 季
- Word 报告保存位置（默认建议不改动）
根据自己实际情况填写后，本文按照默认配置选择季度巡检，点击 生成报告 即可，查看运行过程：
解压 /Volumes/DBA/Github/OracleHealthCheck/checkfiles/dbcheck_rac01_20240315.tar.gz 到临时目录
复制 crt21.js 到临时目录 $_tmp
启动谷歌游览器并设置宽度
访问 html 文件 file:///Volumes/DBA/Github/OracleHealthCheck/src/$_tmp/dbcheck_4019382963_LUCIFER_19.0.0.0.0_20240315.html
正在截取 awrcrt 性能分析图，请稍等...
截图已完成
关闭游览器
保存到 /Volumes/DBA/Github/OracleHealthCheck/reports/Lucifer 有限公司-Oracle数据库4019382963_LUCIFER巡检报告_20240315.docx
删除图片临时目录
删除临时目录
执行完成！
复制运行完成后在 reports 目录下已自动生成 Word 报告：
╭─lucifer@Lucifer-2 /Volumes/DBA/Github/OracleHealthCheck/reports ‹main●› ╰─$ ll total 1192 -rw-r--r--@ 1 lucifer staff 594K 3 15 09:59 Lucifer 有限公司-Oracle数据库4019382963_LUCIFER巡检报告_20240315.docx -rw-r--r--@ 1 lucifer staff 0B 1 22 10:19 word 巡检报告将在此目录下生成.txt复制
至此，Word 报告已经生成完成。
Word 报告演示
Word 报告可以查看：Lucifer 有限公司-Oracle数据库4019382963_LUCIFER巡检报告_20240315.pdf
注意：脚本默认读取 checkfiles 下的所有 dbcheck 开头的 html 和 tar.gz 文件，并根据一个数据库一个 word 报告的方式批量生成报告。
往期精彩文章
Oracle 一键巡检自动生成 Word 报告
Oracle 一键安装合集
Oracle一键安装脚本的 21 个疑问与解答
Oracle一键巡检脚本的 21 个疑问与解答
全网首发：Oracle 23ai 一键安装脚本（非 RPM）
Oracle 19C 最新 RU 补丁 19.24 ，一键安装！
Oracle Linux 7.9 一键安装 Oracle 19C
RedHat 9.4(aarch64) 一键安装 Oracle 19C
openEuler 22.03 LTS SP4 一键安装 Oracle 19C RAC
RHEL 7.9 一键安装 Oracle 19C 19.23 RAC
Oracle DataGuard GAP 修复手册
优化 Oracle：最佳实践与开发规范
DBA 必备：Linux 软件源配置全攻略
Linux 一键配置时钟同步全攻略
感谢您的阅读，这里是 Lucifer三思而后行，欢迎点赞+关注，我会持续分享数据库知识、运维技巧。
最后修改时间：2024-11-15 07:10:48
「喜欢这篇文章，您的关注和赞赏是给作者最好的鼓励」
关注作者
【版权声明】本文为墨天轮用户原创内容，转载时必须标注文章的来源（墨天轮），文章链接，文章作者等基本信息，否则作者和墨天轮有权追究责任。如果您发现墨天轮中有涉嫌抄袭或者侵权的内容，欢迎发送邮件至：contact@modb.pro进行举报，并提供相关证据，一经查实，墨天轮将立刻删除相关内容。
评论
抖草
1年前
评论
0群超200
，楼主请拉一下可以吗？谢谢。luorui655957
，楼主请拉一下可以吗？谢谢。luorui6559571年前
点赞 评论
小AI
1年前
评论
0三哥好 小迷弟上线
1年前
点赞 评论
相关阅读
2025年4月中国数据库流行度排行榜：OB高分复登顶，崖山稳驭撼十强
墨天轮编辑部
2034次阅读
2025-04-09 15:33:27
【MySQL 30周年庆】MySQL 8.0 OCP考试限时免费！教你免费领考券
墨天轮小教习
1632次阅读
2025-04-25 18:53:11
【DBA坦白局】第一期：在小城市和一线城市做DBA，是“躺”还是“卷”？
墨天轮编辑部
1367次阅读
2025-04-10 14:17:22
Oracle Concepts（Oracle 19c）：07 SQL
Ryan Bai
1023次阅读
2025-04-09 10:57:11
2025年3月国产数据库大事记
墨天轮编辑部
910次阅读
2025-04-03 15:21:16
数据库国产化替代深化：DBA的机遇与挑战
代晓磊
858次阅读
2025-04-27 16:53:22
2025 DBA 薪资观察：做 DBA 还香吗？
墨天轮编辑部
826次阅读
2025-04-24 15:53:21
MySQL 30 周年庆！MySQL 8.4 认证免费考！这次是认真的。。。
严少安
623次阅读
2025-04-25 15:30:58
2025年3月国产数据库中标情况一览：TDSQL大单622万、GaussDB大单581万……
通讯员
623次阅读
2025-04-10 15:35:48
月薪快6万的DBA，有命干不一定有命花
多明戈教你玩狼人杀
597次阅读
2025-04-18 10:36:38
