手工生成AWR报告方法记录

AWR（Automatic Workload Repository）报告是我们进行日常数据库性能评定、问题SQL发现的重要手段。熟练掌握AWR报告，是做好开发、运维DBA工作的重要基本功。

AWR报告的原理是基于Oracle数据库的定时镜像功能。默认情况下，Oracle数据库后台进程会以一定间隔（一小时）收集系统当前状态镜像，并且保存在数据库中。生成AWR报告时，只需要指定进行分析的时间段（开始镜像编号和结束镜像编号），就可以生成该时间段的性能分析情况。AWR镜像保存在数据库中的时间为一个月左右。

目前Oracle10g之后，AWR报告取代了原先的Statspack报告成为一个主流性能分析报告。通常可以从OEM（Oracle Enterprise Manager Console）平台上生成查看AWR报告。在OEM中，使用图形化方法更加容易。本篇中介绍使用手工脚本方式生成AWR的方法，脱离OEM的限制。

1、  运行脚本

首先，准备一个目录作为AWR生成报告的路径。

[oracle@bspdev /]$ ls -l | grep test

drwxr-xr-x.   2
oracle
oinstall  4096 Jun
21 13:01 test

[oracle@bspdev /]$ cd test

启动sqlplus等开发工具，调用生成脚本。程序脚本一般保存在$ORACLE_HOME下的rdbms/admin中，名称为awrrpt.sql。

[oracle@bspdev test]$ sqlplus /nolog

SQL*Plus: Release 11.2.0.1.0 Production on Tue Jun 21
13:04:44 2011

Copyright (c) 1982, 2009,
Oracle.  All rights
reserved.

SQL> conn / as sysdba

Connected.

--调用脚本，生成文件

SQL> @?/rdbms/admin/awrrpt.sql

之后进入报告参数输入模块。

2、输入报告参数

之后，要持续输入一系列的报告参数。

输入生成报告类型，目前AWR提供txt和html两种格式。需要确认生成格式，默认是html格式。

Current Instance

~~~~~~~~~~~~~~~~

DB
Id    DB
Name      Inst
Num Instance

----------- ------------ -------- ------------

4143510747
ORA11G              1
ora11g

Specify the Report Type

~~~~~~~~~~~~~~~~~~~~~~~

Would you like an HTML report, or a plain text
report?

Enter 'html' for an HTML report, or 'text' for plain
text

Defaults to 'html'

报告涉及天数范围

启动报告后，会显示生成实例的名称等基本信息。

默认情况下，AWR会将镜像信息保留一个月。手工生成的时候，需要确认生成AWR报告的时间范围。一般情况下，特别是生产环境下，我们通常设置1-7天也就够用了。

Instances in this Workload Repository schema

~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

DB
Id     Inst
Num DB
Name      Instance     Host

------------ -------- ------------ ------------
------------

*
4143510747        1
ORA11G       ora11g       bspdev.local

domain

Using 4143510747 for database Id

Using          1
for instance number

Specify the number of days of snapshots to choose
from

~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

Entering the number of days (n) will result in the most
recent

(n) days of snapshots being
listed.  Pressing without

specifying a number lists all completed
snapshots.

Enter value for
num_days: 3

输入开始和结束的snapshot编号

输入天数信息后，AWR生成代码会将天数范围内的snapshot镜像点列出，供输入选择。

Listing the last 3 days of Completed Snapshots

Snap

Instance     DB
Name        Snap
Id    Snap
Started    Level

------------ ------------ --------- ------------------
-----

ora11g       ORA11G            1789
20 Jun 2011
13:01      1

1790
20 Jun 2011
14:00      1

1791
20 Jun 2011
15:00      1

1792
20 Jun 2011
16:00      1

（篇幅原因，有省略……）

1811
21 Jun 2011
11:00      1

1812
21 Jun 2011
12:00      1

1813
21 Jun 2011
13:00      1

Specify the Begin and End Snapshot Ids

~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

之后，我们需要根据列出的时间范围，输入开始和结束的snap编号。

Specify the Begin and End Snapshot Ids

~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

Enter value for
begin_snap: 1796

Begin Snapshot Id specified: 1796

Enter value for
end_snap: 1813

确定报告名称

最后就是确定生成报告的名称。一般采用默认的名称就可以了。

Specify the Report Name

~~~~~~~~~~~~~~~~~~~~~~~

The default report file name is
awrrpt_1_1796_1813.html.  To
use this name,

press to continue, otherwise enter an
alternative.

Enter value for report_name:

之后输出内容很多，此处不加以累述。最后提示报告生成成功。

Report written to awrrpt_1_1796_1813.html

于是，指定目录上可以看到相应的报告文件。

[oracle@bspdev test]$ ls -l

total 508

-rw-r--r--. 1 oracle oinstall 515262 Jun 21 13:10
awrrpt_1_1796_1813.html

3、说明两个问题

首先，此处生成的html格式的报表。如果要求生成txt格式，就在生成过程中选择text格式报表。

Specify the Report Type

~~~~~~~~~~~~~~~~~~~~~~~

Would you like an HTML report, or a plain text
report?

Enter 'html' for an HTML report, or 'text' for plain
text

Defaults to 'html'

Enter value for report_type: text

Type
Specified:  text

End of Report

Report written to awrrpt_1_1789_1800.txt

[oracle@bspdev test]$ ls -l

total 692

-rw-r--r--. 1 oracle oinstall 180601 Jun 21 13:27
awrrpt_1_1789_1800.txt

-rw-r--r--. 1 oracle oinstall 515262 Jun 21 13:10
awrrpt_1_1796_1813.html

第二个就是调用脚本的方式问题。调用时使用的sqlplus客户端可以在Oracle服务器本机上（远程登录），也可以在客户端机器本机上。笔者建议是在客户端本机上进行生成，这样可以避免报告文件来回拷贝的工作。但是最好要保证客户端版本与服务器版本相匹配。

4、结论

手工生成AWR报告，可以避免受到OEM的限制约束，而且灵活度高。本篇记录，权当备忘。