Linux/Unix shell 自动发送AWR report

2023-08-28 17:47:58

观察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

上一篇：bzoj2152 (点分治）


下一篇：Linux/Unix shell 监控Oracle实例(monitor instance)