Linux/Unix shell 自动发送AWR report(二)

观察Oracle数据库性能，Oracle自带的awr 功能为我们提供了一个近乎完美的解决方案，通过awr特性我们可以随时从数据库提取awr报告。不过awrrpt.sql脚本执行时需要我们提供一些交互信息，因此可以将其整合到shell脚本中来实现自动产生指定时段的awr报告并发送给相关人员。本文对Linux/Unix shell 自动发送AWR report的功能进行了完善和补充。

1、shell脚本

1. robin@SZDB:~/dba_scripts/custom/awr> more autoawr_by_time.sh
2. #!/bin/bash
3. # --------------------------------------------------------------------------+
4. #                 Generate AWR report and send mail automatically           |
5. #   Filename: autoawr_by_time.sh                                            |
6. #   Desc:                                                                   |
7. #       The script use to generate awr report by time period.               |
8. #       Three parameter for it.                                             |
9. #           para1: <ORACLE_SID>   mandatory parameter                       |
10. #           para2: [begin time]   optional parameter                        |
11. #           para3: [end time  ]   optional parameter                        |
12. #       Deploy it by crontab as requirement                                 |
13. #   Usage:                                                                  |
14. #       ./autoawr_by_time.sh <instance_name> [begin time] [end time]        |
15. #   Example:                                                                |
16. #       ./autoawr_by_time.sh TESTDB                                         |
17. #            --default,time period is from last midnight to today midnight  |
18. #       ./autoawr_by_time.sh TESTDB 2013031009                              |
19. #            --time period is from 2013031009 to now                        |
20. #       ./autoawr_by_time.sh TESTDB 2013031009 2013031012                   |
21. #            --time period by speicifed                                     |
22. #   Author : Robinson                                                       |
23. #   Blog   : http://blog.csdn.net/robinson_0612                             |
24. # --------------------------------------------------------------------------+
25. #
26. # -------------------------------
27. #  Set environment here
28. # ------------------------------
29. if [ -f ~/.bash_profile ]; then
30. . ~/.bash_profile
31. fi
32. # ------------------------------------------------------------
33. #  Check the parameter, if no specify,then use default value
34. # ------------------------------------------------------------
35. if [ -z "${1}" ] ;then
36. echo "Usage: "
37. echo "      `basename $0` <ORACLE_SID> [begin_date] [end_date]"
38. fi
39. if [ -z "${3}" ] && [ -z "${2}" ];then
40. begin_date=`date -d yesterday +%Y%m%d`'00'
41. end_date=`date +%Y%m%d`'00'
42. elif [ -z "${3}" ]; then
43. begin_date=${2}
44. end_date=`date +%Y%m%d%H`
45. else
46. begin_date=${2}
47. end_date=${3}
48. fi
49. ORACLE_SID=${1}
50. export ORACLE_SID begin_date end_date
51. export MACHINE=`hostname`
52. export MAIL_DIR=/users/robin/dba_scripts/sendEmail-v1.56
53. export MAIL_LIST='Robinson.chen@<span style="color:#000000;">12306</span>.com'
54. export AWR_CMD=/users/robin/dba_scripts/custom/awr
55. export AWR_DIR=/users/robin/dba_scripts/custom/awr/report/${ORACLE_SID}
56. export MAIL_FM='oracle@szdb.com'
57. RETENTION=31
58. echo $ORACLE_SID
59. echo $begin_date
60. echo $end_date
61. # --------------------------------------------------------------------
62. #  Check the directory for store awr report,if not exist, create it
63. # --------------------------------------------------------------------
64. if [ ! -d "${AWR_DIR}" ]; then
65. mkdir -p ${AWR_DIR}
66. fi
67. # ----------------------------------------------
68. # check if the database is running, if not exit
69. # ----------------------------------------------
70. db_stat=`ps -ef | grep pmon_$ORACLE_SID | grep -v grep| cut -f3 -d_`
71. if [ -z "$db_stat" ]; then
72. #date >/tmp/db_${ORACLE_SID}_stauts.log
73. echo " $ORACLE_SID is not available on ${MACHINE} !!!"   # >>/tmp/db_${ORACLE_SID}_stauts.log
74. MAIL_SUB=" $ORACLE_SID is not available on ${MACHINE} !!!"
75. MAIL_BODY=" $ORACLE_SID is not available on ${MACHINE} at `date` when try to generate AWR."
76. $MAIL_DIR/sendEmail -u $MAIL_SUB -f $MAIL_FM -t $MAIL_LIST -m $MAIL_BODY
77. exit 1
78. fi;
79. # ---------------------------------------------
80. #  Generate the awr report
81. # ---------------------------------------------
82. sqlplus -S "/ as sysdba" @${AWR_CMD}/autoawr_by_time.sql $begin_date $end_date
83. status=$?
84. if [ $status != 0 ];then
85. echo " $ORACLE_SID is not available on ${MACHINE} !!!"   # >>/tmp/db_${ORACLE_SID}_stauts.log
86. MAIL_SUB=" Occurred error while generate AWR for ${ORACLE_SID}  !!!"
87. MAIL_BODY=" Some exceptions encountered during generate AWR report for $ORACLE_SID on `hostname`."
88. $MAIL_DIR/sendEmail -u $MAIL_SUB -f $MAIL_FM -t $MAIL_LIST -m $MAIL_BODY
89. exit
90. fi
91. # ------------------------------------------------
92. # Send email with AWR report
93. # ------------------------------------------------
94. filename=`ls ${AWR_DIR}/${ORACLE_SID}_awrrpt_?_${begin_date}_${end_date}*`
95. if [ -e "${filename}" ];then
96. MAIL_SUB="AWR report from ${ORACLE_SID} on `hostname`."
97. MAIL_BODY="This is an AWR report from ${ORACLE_SID} on `hostname`.Time period: $begin_date,$end_date. "
98. $MAIL_DIR/sendEmail -u $MAIL_SUB -f $MAIL_FM -t $MAIL_LIST -m $MAIL_BODY -a ${filename}
99. echo ${filename}
100. fi
101. # ------------------------------------------------
102. # Removing files older than $RETENTION parameter
103. # ------------------------------------------------
104. find ${AWR_DIR} -name "*awrrpt*" -mtime +$RETENTION -exec rm {} \;
105. exit

2、产生awr report 的sql脚本

1. robin@SZDB:~/dba_scripts/custom/awr> more autoawr_by_time.sql
2. SET ECHO OFF;
3. SET VERI OFF;
4. SET FEEDBACK OFF;
5. SET TERMOUT ON;
6. SET HEADING OFF;
7. SET TRIMSPOOL ON;
8. VARIABLE rpt_options NUMBER;
9. DEFINE no_options = 0;
10. define ENABLE_ADDM = 8;
11. REM according to your needs, the value can be 'text' or 'html'
12. DEFINE report_type='html';
13. BEGIN
14. :rpt_options := &no_options;
15. END;
16. /
17. VARIABLE dbid NUMBER;
18. VARIABLE inst_num NUMBER;
19. VARIABLE bid NUMBER;
20. VARIABLE eid NUMBER;
21. BEGIN
22. SELECT snap_id
23. INTO :bid
24. FROM dba_hist_snapshot
25. WHERE TO_CHAR (end_interval_time, 'yyyymmddhh24') = '&1';
26. SELECT snap_id
27. INTO :eid
28. FROM dba_hist_snapshot
29. WHERE TO_CHAR (end_interval_time, 'yyyymmddhh24') = '&2';
30. SELECT dbid INTO :dbid FROM v$database;
31. SELECT instance_number INTO :inst_num FROM v$instance;
32. END;
33. /
34. --print dbid;
35. --print bid;
36. --print eid;
37. --print inst_num;
38. COLUMN ext NEW_VALUE ext NOPRINT
39. COLUMN fn_name NEW_VALUE fn_name NOPRINT;
40. COLUMN lnsz NEW_VALUE lnsz NOPRINT;
41. SELECT 'txt' ext
42. FROM DUAL
43. WHERE LOWER ('&report_type') = 'text';
44. SELECT 'html' ext
45. FROM DUAL
46. WHERE LOWER ('&report_type') = 'html';
47. SELECT 'awr_report_text' fn_name
48. FROM DUAL
49. WHERE LOWER ('&report_type') = 'text';
50. SELECT 'awr_report_html' fn_name
51. FROM DUAL
52. WHERE LOWER ('&report_type') = 'html';
53. SELECT '80' lnsz
54. FROM DUAL
55. WHERE LOWER ('&report_type') = 'text';
56. SELECT '1500' lnsz
57. FROM DUAL
58. WHERE LOWER ('&report_type') = 'html';
59. set linesize &lnsz;
60. COLUMN report_name NEW_VALUE report_name NOPRINT;
61. SELECT instance_name || '_awrrpt_' || instance_number || '_' ||'&&1'||'_'||'&&2'|| '.' || '&ext'
62. report_name
63. FROM v$instance a,
64. (SELECT TO_CHAR (begin_interval_time, 'yyyymmdd') timestamp
65. FROM dba_hist_snapshot
66. WHERE snap_id = :bid) b;
67. SET TERMOUT OFF;
68. SPOOL ${AWR_DIR}/&report_name;
69. --SPOOL &report_name
70. SELECT output
71. FROM TABLE (DBMS_WORKLOAD_REPOSITORY.&fn_name (:dbid,
72. :inst_num,
73. :bid,
74. :eid,
75. :rpt_options));
76. SPOOL OFF;
77. SET TERMOUT ON;
78. CLEAR COLUMNS SQL;
79. TTITLE OFF;
80. BTITLE OFF;
81. REPFOOTER OFF;
82. SET TRIMSPOOL OFF;
83. UNDEFINE report_name
84. UNDEFINE report_type
85. UNDEFINE fn_name
86. UNDEFINE lnsz
87. UNDEFINE no_options
88. exit;

3、补充说明
a、该脚本实现了基于不同时段，不同instance自动生成awr report，具体如下
b、用法为./autoawr_by_time.sh <instance_name> [begin time] [end time]，可以用于随时随地直接生成awr report
c、在省略[begin time] [end time]的情形下会自动生成昨天凌晨至今天凌晨的awr report
d、当仅仅省略[end time]时则从[begin time]开始至当前的最大snap_id来生成awr report
e、当[begin time] [end time]都被指定时则生成指定时段的awr report
f、通过调用sendEmail发送awr report，具体参考:不可或缺的 sendEmail

4、部署参考

1. #如果仅仅需要一整天的awr report，直接将其部署到crontab即可。
2. #如果需要一整天以及不同时段的awr report，则可以考虑采用如下方式来部署，将其合并到一个shell文件
3. robin@SZDB:~/dba_scripts/custom/awr> more awr.sh
4. #!/bin/bash
5. dt=`date +%Y%m%d`
6. start_date=$dt'05'
7. end_date=$dt'09'
8. /users/robin/dba_scripts/custom/awr/autoawr_by_time.sh CNMMBO               #获取一整天的awr report
9. /users/robin/dba_scripts/custom/awr/autoawr_by_time.sh CNMMBO $start_date   #获取指定起始时间至今的awr report
10. /users/robin/dba_scripts/custom/awr/autoawr_by_time.sh CNMMBO $start_date $end_date #获取指定时间段的awr report
11. exit
12. robin@SZDB:~/dba_scripts/custom/awr> crontab -l
13. # DO NOT EDIT THIS FILE - edit the master and reinstall.
14. 45  11 * * * /users/robin/dba_scripts/custom/awr/awr.sh
15. 转：http://blog.csdn.net/leshami/article/details/8687690