Linux/Unix shell 自动发送AWR report

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

1. robin@SZDB:~/dba_scripts/custom/awr> more autoawr.sh
2. #!/bin/bash
3. # --------------------------------------------------------------------------+
4. #                  CHECK ALERT LOG FILE                                     |
5. #   Filename: autoawr.sh                                                    |
6. #   Desc:                                                                   |
7. #       The script use to generate AWR report and send mail automatic.      |
8. #       The sql script autoawr.sql call by this shell script.               |
9. #       Default, the whole day AWR report will be gathered.                 |
10. #       Deploy it to crontab at 00:30                                        |
11. #       If you want to change the snap interval,please change autoawr.sql   |
12. #          and crontab configuration                                        |
13. #   Usage:                                                                  |
14. #       ./autoawr.sh $ORACLE_SID                                            |
15. #                                                                           |
16. #   Author : Robinson                                                       |
17. #   Blog   : http://blog.csdn.net/robinson_0612                             |
18. # --------------------------------------------------------------------------+
19. #
20. # --------------------------
21. #   Check SID
22. # --------------------------
23. if [ -z "${1}" ];then
24. echo "Usage: "
25. echo "      `basename $0` ORACLE_SID"
26. exit 1
27. fi
28. # -------------------------------
29. #  Set environment here
30. # ------------------------------
31. if [ -f ~/.bash_profile ]; then
32. . ~/.bash_profile
33. fi
34. export ORACLE_SID=$1
35. export MACHINE=`hostname`
36. export MAIL_DIR=/users/robin/dba_scripts/sendEmail-v1.56
37. export MAIL_LIST='Robinson.cheng@12306.com'
38. export AWR_CMD=/users/robin/dba_scripts/custom/awr
39. export AWR_DIR=/users/robin/dba_scripts/custom/awr/report
40. export MAIL_FM='oracle@szdb.com'
41. RETENTION=31
42. # ----------------------------------------------
43. # check if the database is running, if not exit
44. # ----------------------------------------------
45. db_stat=`ps -ef | grep pmon_$ORACLE_SID | grep -v grep| cut -f3 -d_`
46. if [ -z "$db_stat" ]; then
47. #date >/tmp/db_${ORACLE_SID}_stauts.log
48. echo " $ORACLE_SID is not available on ${MACHINE} !!!"   # >>/tmp/db_${ORACLE_SID}_stauts.log
49. MAIL_SUB=" $ORACLE_SID is not available on ${MACHINE} !!!"
50. MAIL_BODY=" $ORACLE_SID is not available on ${MACHINE} at `date` when try to generate AWR."
51. $MAIL_DIR/sendEmail -u $MAIL_SUB -f $MAIL_FM -t $MAIL_LIST -m $MAIL_BODY
52. exit 1
53. fi;
54. # ----------------------------------------------
55. # Generate awr report
56. # ----------------------------------------------
57. $ORACLE_HOME/bin/sqlplus /nolog<<EOF
58. connect / as sysdba;
59. @${AWR_CMD}/autoawr.sql;
60. exit;
61. EOF
62. status=$?
63. if [ $status != 0 ];then
64. echo " $ORACLE_SID is not available on ${MACHINE} !!!"   # >>/tmp/db_${ORACLE_SID}_stauts.log
65. MAIL_SUB=" Occurred error while generate AWR for ${ORACLE_SID}  !!!"
66. MAIL_BODY=" Some exceptions encountered during generate AWR report for $ORACLE_SID on `hostname`."
67. $MAIL_DIR/sendEmail -u $MAIL_SUB -f $MAIL_FM -t $MAIL_LIST -m $MAIL_BODY
68. exit
69. fi
70. # ------------------------------------------------
71. # Send email with AWR report
72. # ------------------------------------------------
73. dt=`date -d yesterday +%Y%m%d`
74. filename=`ls ${AWR_DIR}/${ORACLE_SID}_awrrpt_?_${dt}*`
75. if [ -e "${filename}" ];then
76. MAIL_SUB="AWR report from ${ORACLE_SID} on `hostname`."
77. MAIL_BODY="This is an AWR report from ${ORACLE_SID} on `hostname`."
78. $MAIL_DIR/sendEmail -u $MAIL_SUB -f $MAIL_FM -t $MAIL_LIST -m $MAIL_BODY -a ${filename}
79. echo ${filename}
80. fi
81. # ------------------------------------------------
82. # Removing files older than $RETENTION parameter
83. # ------------------------------------------------
84. find ${AWR_DIR} -name "*awrrpt*" -mtime +$RETENTION -exec rm {} \;
85. exit

2、产生awr report 的sql脚本

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

3、补充说明
a、shell脚本中首先判断指定的实例是否处于available，如果不可用则退出
b、接下来调用autoawr.sql脚本来产生awr report
c、产生awr report后，如果文件存在则自动发送邮件
d、autoawr.sql脚本中是产生awr report的主要部分，主要是调用了DBMS_WORKLOAD_REPOSITORY.&fn_name过程
e、该脚本是生成一整天awr report，即从当天的零点至第二天零点
f、sql脚本的几个参数需要确定的是dbid，实例号，以及snap的开始与结束id，rpt_options用于确定报告是否带addm项
g、可以根据需要定制所需的snap的起止id，需修改SQL来获取正确的snap id，来生成所需的报告
h、根据需要修改fn_name定制生成awr报告为txt或html类型，report_name则是确定最终文件名
i、AWR 报告的两个snap 之间不能有重启DB的操作,否则有可能错误(未测试过)
j、该脚本支持Oracle 10g/11g，有关详细的产生awr report脚本说明请参考oracle自带的awrrpt.sql,awrrpti.sql

转：http://blog.csdn.net/leshami/article/details/8655991