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

2022-02-03 23:07:42

观察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
上一篇：shark错误：Query returned non-zero code: -101


下一篇：C#中的局部类