db2top - Db2 监视工具 命令

重要信息: db2top 命令已不推荐使用,并且可能不会在将来的发行版中显示。

db2top 命令在 AIX®, Linux®, HP-UX和 Solaris 操作系统上提供多分区数据库或单分区数据库的统一单系统视图。

快速识别全局问题或系统中的特定数据库分区问题。 通过组合来自每个数据库分区的快照信息,提供了正在运行的 Db2 系统的动态实时视图。

作用域

db2top 可以以交互方式或批处理方式运行。

权限

为下列其中一种权限:
  • SYSADM
  • SYSCTRL
  • SYSMAINT
  • SYSMON

需要的连接

。 在重放或客户机方式下,不需要连接。

命令语法

Read syntax diagramSkip visual syntax diagramdb2top-A-a-B-b suboption-Csuboption-Ddelimiter-ddatabase name-ffile </HH:MM:SS><+offset>-h-iinterval in seconds-k-L-mduration in minutes-nnode name-ooutfile-Pmember_number-ppassword-R-snumber-uusername-Vschema-x

命令参数

-A
启用自动性能分析。 db2top 命令生成排名前 5 位的性能报告。 在重放和后台方式下使用此选项 (-b 参数)。 典型用法包括:

以收集方式长时间运行 db2top (例如, 4 小时):

db2top -f collect.file -C -m 240

使用自动性能分析以重放方式运行 db2top 。 自动性能分析可用于后台方式下支持的任何功能,并且基于所选子选项的 .db2toprc 配置文件中指定的缺省排序条件 (自动性能分析在后台方式下也可用,即使不重放时也是如此)。 例如,要分析最活跃的会话,请发出以下命令:

db2top -f collect.file -b l -A

以重放方式运行 db2top ,跳至所需时间点以进一步分析:

db2top -f collect.file /HH:MM:SS
-a
指定仅显示活动对象。
-B
以粗体 (反向) 颜色显示活动对象。 当屏幕不支持颜色并且在 .db2toprc 配置文件中设置为 off 时,这很有用。
-b suboption
以后台方式运行 db2top 。 使用 -b 参数时, db2top 命令将以 CSV 格式显示信息。 通过使用 -f file 参数从集合文件中读取快照数据,可以在后台方式下运行 db2top 。 不支持对后台方式 (-b) 发出多个子选项。 -b 参数采用下列其中一个子选项值:
d
数据库
l
会议
t
表空间
b
缓冲池
T
D
动态 SQL
s
语句
U
锁定数
u
实用程序
F
联合
m
内存池

以下参数只能与 -b 参数一起使用: -X-L-A-s-D-o

-C
以快照收集器方式运行 db2top 。 缺省情况下,原始快照数据保存在 <db2snap-<dbname>-<Machine><bits><.bin> 中 (除非指定了 -f )。 也可以为输出而不是文件指定管道。 支持为收集器方式 (-C) 指定多个子选项。 要在集合文件中包含锁定信息,请将 -x-C配合使用。 -C 参数采用下列其中一个子选项值:
  • b: 缓冲池
  • D: 动态 SQL
  • d: 数据库
  • F: 联合
  • l: 会话
  • s: 语句
  • T: 表
  • t: 表空间
  • U: 锁定
如果未指定 -C 命令参数,那么 db2top 命令将以重放方式运行。
-D delimiter
指定字段定界符 (单个字符)。 在后台方式下使用 (-b 参数)。
-d database name
指定要监视的数据库。
-f file </HH:MM:SS><+offset>
  • 如果未指定 -f 参数,那么将以重放方式运行 db2top 。 如果指定了 -f 参数,那么它指示输出文件名。 使用 -d 参数指定的数据库名称不需要存在。 仅当要发出说明或转储数据库结构时,才会引用此参数。

    在重放方式下 (不使用-C 参数) ,如果先前已在 文件中收集快照数据,那么偏移量将跳转到文件中的特定时间点。 它可以以秒 (+10s) ,分钟 (+10m) 或小时 (+10h) 表示。 /HH:MM: SS 跳过条目,直到指定的时间点。

  • In the collector mode (-C parameter is used), you can specify the output filename. </HH:MM:SS><+offset> will be ignored if you are in collector mode

-h
显示 db2top 命令的用法信息。
-i interval in seconds
指定屏幕更新之间的延迟。 延迟时间不能小于一秒。
-k
显示实际值或增量值。 对于增量方式下的所有函数,无论指定的刷新时间间隔如何,都将每秒计算和显示增量值。
-L

指定在 -i 参数指定的每个报告时间间隔捕获当前正在执行的语句或当前会话中的最新语句。 如果 SQL 语句在时间间隔内启动和完成,那么将不包含该语句。

在后台方式下,使用 -b l -L 参数来捕获在会话中执行的 SQL 语句,并将它们输出到当前工作目录中的 ALL.sql 文件。

将在每个时间间隔 (由 -i 参数指定) 捕获当前正在执行的会话或已连接会话的最新 SQL 语句。 如果 SQL 语句在时间间隔内启动和完成,那么将不会捕获该语句。

-m duration in minutes
限制 -b-C 参数的 db2top 持续时间 (以分钟为单位)。
-n node name
指定要连接到的节点。
-o
指定输出文件名。 在后台方式下使用 (-b 参数)。
-P dbpartition number
指定将在其上发出快照的数据库分区号。 如果指定了 -P 参数并且未指定 dbpartition number ,那么 db2top 将连接到缺省数据库分区。
-p
指定用于访问数据库的密码。 如果省略并且指定了 -u 参数,那么将提示用户输入密码
-R
在启动时重置快照。
-s number
指定将显示的样本数。 仅在后台方式下受支持 (-b 参数)。
-u
指定用于访问数据库的用户名。
-V schema
指定说明中使用的缺省模式。
-x
指定是否在会话和应用程序屏幕上显示其他计数器 (可能在会话上运行速度较慢)。
-X
指定输出的格式为 XML。 在后台方式下与 -b 参数结合使用。

快照数据收集器

db2top 监视实用程序可以在重放方式下运行,这意味着它可以针对原始二进制快照数据的已保存副本运行。 要以重放方式运行,必须首先以数据收集器方式运行 db2top ,方法是通过从命令行使用 -C 参数运行 db2top ,或者通过按 C 键从交互式会话激活或取消激活数据收集,从而以批处理方式运行。 这将在当前目录中创建文件 <db2snap-hostname.bin> 。 然后,可以使用 -f 参数对 <db2snap-<dbname>-<Machine><bits>.bin> 运行 db2top 实用程序。 db2top 监视实用程序不需要以重放方式连接到 Db2 实例,这便于远程监视。 可以通过指定可用于 -C 参数的任何子选项来限制流文件的内容和大小。

示例 (批处理方式)

The command parameters are as below:
-b l          --> Run in background mode, while catching the "sessions" related 
                  info in db2top
-C            --> run db2top in snapshot collector mode 
-d CUST       --> database
-i 3          --> 3 second interval
-m 60         --> limit duration of db2top to 60 minutes
-n node       --> node 
-o db2top.xml --> output file db2top.xml
-p password   --> password
-s 10000      --> collect 10000 samples
-u userid     --> userid
-V sv9        --> Schema 
-x            --> display additional counters on session 
以下示例命令监视名为 "node" 且模式为 "sv9" 的节点上名为 "CUST" 的数据库。 数据库的用户标识为 "userid" ,密码为 "password":
  • 以下示例命令以三秒时间间隔以后台方式监视数据库 60 分钟,并将 XML 格式的会话信息输出到名为 db2top.xml的文件中:
    db2top -d CUST -n node -u userid -p password -V sv9 -i 3 -b l 
       -X -o db2top.xml -m 60
  • 以下示例命令以后台和快照收集方式监视数据库,以 XML 格式收集 10000 个会话信息样本。 输出二进制文件为 db2snap-CUST-AIX64.bin:
    db2top -d CUST -n node -u userid -p password -V sv9 -b l 
       -x -s 10000 -X -f db2snap-CUST-AIX64.bin
  • 以下示例命令将重放先前示例命令中的输出捕获:
    db2top -d CUST -f db2snap-CUST-AIX64.bin 

有关更多信息,请参阅 Db2 问题确定 (使用 db2top 实用程序) ,网址为 http://www.ibm.com/developerworks/data/library/techarticle/dm-0812wang/