在知识库中专注阅读，并随时返回相关工具与课程
大家好，这里是 Lucifer三思而后行，专注于提升数据库运维效率。 @TOC目录 Oracle 数据库巡检通常需要消耗大量时间和精力，包括收集数据库以及主机的相关信息。针对 Word 报告的样式调整，也是重复和费事的，所以我针对 Oracle 巡检所需检查的信息以及报告模板，写了一套自动巡检并且生成报告的脚本。巡检人员只需要执行脚本，脚本会自动生成一个完整的 Word 报告（样式格式都无需调整）
大家好，这里是 Lucifer三思而后行，专注于提升数据库运维效率。
本章目标：掌握本章核心知识点 前置要求：完成前序章节学习 预计时长：60 分钟
Oracle 数据库巡检通常需要消耗大量时间和精力，包括收集数据库以及主机的相关信息。针对 Word 报告的样式调整，也是重复和费事的，所以我针对 Oracle 巡检所需检查的信息以及报告模板，写了一套自动巡检并且生成报告的脚本。巡检人员只需要执行脚本，脚本会自动生成一个完整的 Word 报告（样式格式都无需调整），只需要检查报告中是否存在问题即可。
本文演示一套 19C RAC 的集群数据库自动巡检。
Oracle 一键巡检脚本可将巡检结果一键生成为 Word 报告！本脚本通过 python 将巡检结果生成为 Word 报告，分为两部分：
Word 报告内容主要包括：主机巡检，数据库巡检，DataGuard 同步检查，Rman 备份检查， rac 集群检查，数据库性能分析（awr 内部 sql 获取），抓取 alert日志，抓取 awr 报告等，内容极其丰富。如果是 rac，会抓取所有节点报告。
咨询巡检脚本可扫码进微信群或者添加作者微信 Lucifer-0622：
Oracle 数据库主机只需需要上传对应 DB 的巡检脚本：
1[oracle@rac01:/home/oracle/check]$ ll2-rw-r--r-- 1 root root 202369 Mar 15 09:12 dbcheck10g.sql3-rw-r--r-- 1 root root 206342 Mar 15 09:12 dbcheck11g.sql4-rw-r--r-- 1 root root 207786 Mar 15 09:12 dbcheck12c.sql5-rw-r--r-- 1 root root 24819 Mar 15 09:13 oscheck.shoscheck.sh 是用来巡检主机相关信息以及配置检查。 dbcheck*.sql 是用来巡检数据库相关信息，12c 包括 12c 以后的版本。
Oracle 数据库其中一个节点上传巡检脚本（本文选择节点一）：
1[root@rac01:/root]$ chown -R oracle:oinstall /home/oracle/check/2[oracle@rac01:/home/oracle/check]$ chmod +x oscheck.sh 3[oracle@rac01:/home/oracle/check]$ ll4total 2325-rw-r--r-- 1 oracle oinstall 207786 Mar 15 09:12 dbcheck12c.sql6-rwxr-xr-x 1 oracle oinstall 24819 Mar 15 09:13 oscheck.sh执行脚本一键巡检 Oracle 数据库：
1## 如果一台主机上有多个实例，可以通过参数 -o 来指定，例如：2sh oscheck.sh -o orcl,lucifer,test3## 确保 ORACLE_SID 正确后，执行脚本4[oracle@rac01:/home/oracle/check]$ sh oscheck.sh56#==============================================================# 7Oracle数据库主机检查 8#==============================================================# 910收集主机 OS 层信息 ... 11收集数据库补丁信息 ... 12收集数据库监听信息 ... 1314#==============================================================# 15检查数据库实例：luciferdg1 16#==============================================================# 1718收集数据库ALERT日志 ... 19收集数据库AWR报告 ... 2021Note1: Information about Instance2223 INST_ID DBID NAME DATABASE_ROLE CREATED LOG_MODE OPEN_MODE VERSION SESSIONID24---------- ---------- ---------- -------------------- -------------------- ------------- -------------------- ---------- --------------------25 1 4019382963 LUCIFER PRIMARY 2024-03-13 10:21:39 ARCHIVELOG READ WRITE 19.0.0.0.0 392,13105,3018226 2 4019382963 LUCIFER PRIMARY 2024-03-13 10:21:39 ARCHIVELOG READ WRITE 19.0.0.0.0 392,13105,30182272829Note2: Information abount Recyclebin3031+------------------------------------------------------------------------------------------------------------+32| Oracle Database health Check script |33|------------------------------------------------------------------------------------------------------------+34| Copyright (c) 2022-2100 lpc. All rights reserved. |35+------------------------------------------------------------------------------------------------------------+3637DBHealthCheck Author: Lucifer3839+----------------------------------------------------------------------------+40Now DBCheck staring, the time cost depending on size of database.41Begining ......50042+----------------------------------------------------------------------------+4344-----Oracle Database Check STRAT, Starting Collect Data Dictionary Information----45start...Set Environment Variables, Configure html headers.....46start collect...Database Informaion...47start collect......Overview of Instance Informaion...48start collect......Overview of Database Informaion...49start collect......Database Version Informaion...50start collect......Database Component and Patch Informaion...51start collect......Database Parameter Informaion...52start collect......Database Resource Informaion...53start collect......Database ControlFile Informaion...54start collect......Database LogFile Informaion...55start collect......Archive Log Size in last 10 Days...56start collect......Invalid Object Informaion...57start collect......Tablespace Usage Informaion...58start collect......Top10 Index Informaion...59start collect......Range Partition Extend Check Informaion...60start collect......Object in System TableSpace Informaion...61start collect......BitCoin Attack Check...62start collect......SYSAUX Objects Informaion...63start collect......Flashback Database Parameters...64start...OverView Database User Information...65start collect......System Manager Role Informaion...66start collect......Schema Informaion...67start collect......Profile Informaion...68start collect......Directory Informaion...69start collect......Job Informaion...70start collect......Database Link Informaion...71start collect......Autotask Informaion...72start...OverView Database of Backup and Recover Information...73start collect......Dataguard Parameter...74start collect......Dataguard Applied Status...75start collect......Dataguard Status...76start collect......RMAN Backup Info...77start collect......Orphaned DataPump Jobs...78start collect......Instacne Alert Log...79start...OverView Database of ASM Information...80start collect......ASM Instance Informaion...81start collect......ASM Diskgroup Attribute...82start collect......ASM Disk Group...83start...OverView Database Performace Information...84start collect......AWR Configure Informaion...85start collect......Awrrpt Snap Informaion...86start collect......Awrrpt Load Profile Informaion...87start collect......Instance Efficiency Percentages...88start collect......TOP 10 Wait Event...89start collect......System Time Model...90start collect......TOP 10 SQL Order by Elapsed Time...91start collect......Awrcrt Informaion...92Database script execution ends....9394压缩包位置: /home/oracle/check/dbcheck_rac01_20240315.tar.gz执行完之后会在当前目录生成一个 tar 压缩包：
1[oracle@rac01:/home/oracle/check]$ ll2total 6403-rw-r--r-- 1 oracle oinstall 207786 Mar 15 09:12 dbcheck12c.sql4drwxr-xr-x 2 oracle oinstall 227 Mar 15 09:28 dbcheck_rac01_202403155-rw-r--r-- 1 oracle oinstall 417254 Mar 15 09:28 dbcheck_rac01_20240315.tar.gz6-rwxr-xr-x 1 oracle oinstall 24819 Mar 15 09:13 oscheck.sh这个就是脚本获取到的所有信息集合，包含以下内容：
1[oracle@rac01:/home/oracle/check]$ cd dbcheck_rac01_20240315/2[oracle@rac01:/home/oracle/check/dbcheck_rac01_20240315]$ ll3## 节点1的 alert 日志4-rw-r--r-- 1 oracle oinstall 54530 Mar 15 09:27 alert_luciferdg1.log5## 节点2的 alert 日志6-rw-r--r-- 1 oracle oinstall 3785318 Mar 15 09:27 alert_luciferdg2.log7## 节点1的 awrrpt 报告8-rw-r--r-- 1 oracle oinstall 1506483 Mar 15 09:27 awrrpt_luciferdg1_13_46.html9## 节点2的 awrrpt 报告10-rw-r--r-- 1 oracle oinstall 1455454 Mar 15 09:27 awrrpt_luciferdg2_13_46.html11## Oracle Database 巡检报告 html 格式12-rw-r--r-- 1 oracle oinstall 121960 Mar 15 09:28 dbcheck_4019382963_LUCIFER_19.0.0.0.0_20240315.html13## Oracle 主机巡检报告 txt 格式14-rw-r--r-- 1 oracle oinstall 12823 Mar 15 09:27 oscheck_rac01_20240315.txt接下来就是将 tar 文件获取到本地，进行 word 报告一键生成程序即可。
通过 sftp 等工具获取到 tar 报告，放到 checkfiles 目录下：
1╭─lucifer@Lucifer-2 /Volumes/DBA/Github/OracleHealthCheck/checkfiles ‹main●›2╰─$ ll3total 8164-rw-r--r-- 1 lucifer staff 407K 3 15 09:38 dbcheck_rac01_20240315.tar.gz5-rw-r--r--@ 1 lucifer staff 0B 1 22 10:19 请将巡检文件移动到此目录下.txt前置工作（必须满足）：
pip install -r requirements.txt 即可Word 报告一键生成程序是通过 Python 来写的，完整程序目录如下：
1╭─lucifer@Lucifer-2 /Volumes/DBA/Github/OracleHealthCheck ‹main●›2╰─$ tree -N3.4├── README.md5├── checkfiles6│ └── 请将巡检文件移动到此目录下.txt7├── example8│ └── example.md9├── reports10│ └── word 巡检报告将在此目录下生成.txt11├── requirements.txt12├── resources13│ ├── chromedriver14│ ├── config.ini15│ ├── images16│ │ └── Oracle.png17│ ├── js18│ │ └── crt21.js19│ └── templates20│ ├── Oracle数据库巡检报告模板_周.docx21│ ├── Oracle数据库巡检报告模板_季.docx22│ └── Oracle数据库巡检报告模板_月.docx23├── scripts24│ ├── db25│ │ ├── dbcheck10g.sql26│ │ ├── dbcheck11g.sql27│ │ └── dbcheck12c.sql28│ └── os29│ └── oscheck.sh30└── src31 ├── awrcrt.py32 ├── create_config.py33 ├── create_desc.py34 ├── create_report.py35 ├── main.py36 └── parse_file.py运行 Python 脚本需要安装 Python 运行环境，去官方下载最新的安装包即可：Download Python，注意：在安装 Python 时勾选 "Add Python to PATH" 复选框，安装程序会自动添加环境变量，否则需要手动配置。
安装好 Python 之后，运行命令安装依赖包：
1## 命令行窗口进入到 requirements.txt 所在目录运行2╭─lucifer@Lucifer-2 /Volumes/DBA/Github/OracleHealthCheck ‹main●›3╰─$ pip install -r requirements.txt等待安装完成即可。
接下来还需要下载 chromedriver 以及 Google Chrome 浏览器： Chrome for Testing availability
image.png
下载稳定版本后进行安装即可，chromedriver 下载解压后放到 resources 目录下（Windows的是有后缀的）：
1╭─lucifer@Lucifer-2 /Volumes/DBA/Github/OracleHealthCheck/resources ‹main●›2╰─$ ll3-rwxr-xr-x@ 1 lucifer staff 15M 3 12 07:17 chromedriver4-rw-r--r--@ 1 lucifer staff 2.0K 2 29 14:00 config.ini5drwxr-xr-x@ 4 lucifer staff 128B 1 22 12:28 images6drwxr-xr-x@ 3 lucifer staff 96B 1 22 10:19 js7drwxr-xr-x@ 5 lucifer staff 160B 1 22 10:19 templates至此，脚本所需 Python 环境就配置好了。
进入到 main.py 所在的目录 src：
1╭─lucifer@Lucifer-2 /Volumes/DBA/Github/OracleHealthCheck/src ‹main●›2╰─$ ll3-rw-r--r--@ 1 lucifer staff 3.2K 1 22 10:19 awrcrt.py4-rw-r--r--@ 1 lucifer staff 3.0K 1 22 10:19 create_config.py5-rw-r--r--@ 1 lucifer staff 14K 1 22 10:19 create_desc.py6-rw-r--r--@ 1 lucifer staff 5.1K 1 22 10:19 create_report.py7-rwxr-xr-x@ 1 lucifer staff 8.2K 1 22 10:19 main.py8-rw-r--r--@ 1 lucifer staff 5.3K 1 22 10:19 parse_file.py运行脚本调用图形化程序：
1╭─lucifer@Lucifer-2 /Volumes/DBA/Github/OracleHealthCheck/src ‹main●›2╰─$ python main.py运行完之后会弹出一个图形化报告生成工具：
工具页面包含可编辑选项：
根据自己实际情况填写后，本文按照默认配置选择季度巡检，点击 生成报告 即可，查看运行过程：
1解压 /Volumes/DBA/Github/OracleHealthCheck/checkfiles/dbcheck_rac01_20240315.tar.gz 到临时目录2复制 crt21.js 到临时目录 $_tmp3启动谷歌游览器并设置宽度4访问 html 文件 file:///Volumes/DBA/Github/OracleHealthCheck/src/$_tmp/dbcheck_4019382963_LUCIFER_19.0.0.0.0_20240315.html5正在截取 awrcrt 性能分析图，请稍等...6截图已完成7关闭游览器8保存到 /Volumes/DBA/Github/OracleHealthCheck/reports/Lucifer 有限公司-Oracle数据库4019382963_LUCIFER巡检报告_20240315.docx9删除图片临时目录10删除临时目录11执行完成！运行完成后在 reports 目录下已自动生成 Word 报告：
1╭─lucifer@Lucifer-2 /Volumes/DBA/Github/OracleHealthCheck/reports ‹main●›2╰─$ ll3total 11924-rw-r--r--@ 1 lucifer staff 594K 3 15 09:59 Lucifer 有限公司-Oracle数据库4019382963_LUCIFER巡检报告_20240315.docx5-rw-r--r--@ 1 lucifer staff 0B 1 22 10:19 word 巡检报告将在此目录下生成.txt至此，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三思而后行，欢迎点赞+关注，我会持续分享数据库知识、运维技巧。