[Windows][Linux]

使用 amqsrua 命令监视系统资源使用情况

您可以使用 amqsrua 命令来查询与队列管理器的系统资源使用情况相关的性能数据。

关于本任务

amqsrua 样本应用程序展示了一种使用 IBM® MQ 监视发布并显示由队列管理器发布的性能数据的方法。 此数据可以包含有关 CPU ，内存和磁盘使用情况的信息。 您还可以查看等同于 STATMQI PCF 统计数据的数据。 数据每 10 秒发布一次，并在命令运行时报告。

您可以仅使用队列管理器名称来运行该命令，并以交互方式逐步选择在每个步骤中可供队列管理器使用的 CLASS， TYPE 和 object 参数。 如果您知道要查看其信息的 CLASS， TYPE 和 object 名称，那么可以在运行 amqsrua 命令时指定这些名称。

缺省情况下， amqsrua 应用程序会查找队列管理器在主题树 $SYS/MQ/INFO/QMGR下发布的统计信息。 其他组件或应用程序可以使用类似的机制在不同的主题起点下发布。 从 IBM MQ 9.1.0开始，您可以使用 -p 参数来指定 amqsrua 在 Linux® 和 Windows上查找这些其他组件的统计信息的位置。

-m
队列管理器名称。 该队列管理器必须正在运行。 如果未指定队列管理器名称，那么将显示缺省队列管理器的统计信息。
-c
类名。 IBM MQ 资源使用情况发布与类相关联。 这些类表示元数据树中描述可用资源使用情况信息的顶级。
CPU
返回有关 CPU 使用率的信息。
磁盘
返回有关磁盘使用情况的信息。
STATMQI
返回有关 MQI 使用情况的信息。
STATQ
返回有关每个队列的 MQI 使用情况的信息。
STATAPP
返回有关指定应用程序的使用情况统计信息的信息。
有关如何为元数据指定主题树的信息，请参阅开发自己的资源监控应用程序；有关应用程序名称中可使用的字符，请参阅在支持的编程语言中使用应用程序名称。
注: 使用 -o 选项来指定正在为 STATAPP 监视的应用程序名称以及 STATQ 的队列名称。
-t
TYPE 名称。 IBM MQ 资源使用情况发布与类中的类型相关联。 每个出版物都包含允许找到 class/type/element 定义以及处理生成的出版物的类和类型。 class/type/element 描述在队列管理器启动时作为元数据发布。
-o
对象名称。 资源使用情况发布是由一系列 PCF 元素组成的 PCF 消息。 将在元数据中公布针对每个类/类型对发布的 PCF 元素。 叶子存储在树中，用于描述每个元素，从而允许处理这些元素。
-p
元数据前缀。 指定主题树起点， amqsrua 可以在该起点中查找由队列管理器发布的统计信息。 缺省主题树为 $SYS/MQ/INFO/QMGR ，但其他组件或应用程序可能会在另一主题树起点下发布统计信息。
-n
发布计数。 您可以指定在命令结束之前返回的报告数。 大约每 10 秒发布一次数据，因此如果输入值 50 ，那么该命令将在 500 秒内返回 50 个报告。 如果未指定此参数，那么该命令将运行，直到发生错误或队列管理器关闭为止。
-s
模型队列。 (可选) 指定要使用的模型队列。 (缺省情况下， amqsrua 使用 SYSTEM.DEFAULT.MODEL.QUEUE 队列。)
-h
用法

过程

  1. 从 samples 目录中，发出以下命令以显示队列管理器的可用数据:
    • [Linux]在 Linux上， MQ_INSTALLATION_PATH/samp/bin:
      ./amqsrua -m QMgrName
    • [Windows]在 Windows上， MQ_INSTALLATION_PATH\tools\c\Samples\Bin64:
      amqsrua -m QMgrName
    其中 QMgrName 指定要查询的队列管理器的名称。 该队列管理器必须正在运行。 如果未指定队列管理器名称，那么将使用缺省队列管理器。
    提供了以下选项：
    CPU : Platform central processing units
DISK : Platform persistent data stores
STATMQI : API usage statistics
STATQ : API per-queue usage statistics
Enter Class selection
==>
  2. 从 CLASS 选项列表中，输入 STATMQI。
    ==> STATMQI
CONNDISC : MQCONN and MQDISC
OPENCLOSE : MQOPEN and MQCLOSE
INQSET : MQINQ and MQSET
PUT : MQPUT
GET : MQGET
SYNCPOINT : Commit and rollback
SUBSCRIBE : Subscribe
PUBLISH : Publish
Enter Type selection
==>
  3. 从 TYPE 选项列表中，输入 PUT。
    ==>PUT
Publication received PutDate:20170329 PutTime:17045485 Interval:4 minutes,13.978 seconds
Interval total MQPUT/MQPUT1 count 22 
Interval total MQPUT/MQPUT1 byte count 25284 100/sec
Non-persistent message MQPUT count 22 
Persistent message MQPUT count 0 
Failed MQPUT count 0 
Non-persistent message MQPUT1 count 0 
Persistent message MQPUT1 count 0 
Failed MQPUT1 count 0 
Put non-persistent messages - byte count 25284 100/sec
Put persistent messages - byte count 0 
MQSTAT count 0 

Publication received PutDate:20170329 PutTime:17050485 Interval:10.001 seconds
Interval total MQPUT/MQPUT1 count 1 
Interval total MQPUT/MQPUT1 byte count 524 52/sec
Non-persistent message MQPUT count 1 
Persistent message MQPUT count 0 
Failed MQPUT count 0 
Non-persistent message MQPUT1 count 0 
Persistent message MQPUT1 count 0 
Failed MQPUT1 count 0 
Put non-persistent messages - byte count 524 52/sec
Put persistent messages - byte count 0 
MQSTAT count 0

结果

您已使用 amqsrua 样本应用程序以交互方式查看队列管理器在系统主题上的元数据前缀 $SYS/MQ/INFO/QMGR下发布的统计信息。
注: 可用于队列管理器的资源发布的类和类型可能有所不同，具体取决于其配置，版本和平台。 以交互方式使用 amqsrua 来查找可用于特定队列管理器的类，类型和元素。

后续操作

要开发自己的监控应用程序，请参阅开发自己的资源监控应用程序。