test

Sun Java System Message Queue 3.7 UR1 管理指南

以交互方式显示度量

Message Queue 代理可以报告以下类型的度量：

imqcmd 命令可以获取整个代理、单个连接服务以及单个物理目的地的度量信息。要获取度量数据，通常应该使用 imqcmd 的 metrics 子命令。度量数据将按照您指定的时间间隔或次数写到控制台屏幕上。

也可以使用 query 子命令查看也包含配置信息的类似数据。有关详细信息，请参见 imqcmd query。

imqcmd metrics

imqcmd metrics 的语法和选项分别如表 10–3 和表 10–4 所示。

表 10–3 imqcmd metrics 子命令语法

子命令语法 

提供的度量数据 

 
metrics bkr
   [-b hostName:portNumber]
   [-m metricType]
   [-int interval]
   [-msp numSamples]

显示默认代理的代理度量或显示指定主机和端口上的代理的代理度量。 

 
metrics svc -n serviceName
   [-b hostName:portNumber]
   [-m metricType]
   [-int interval]
   [-msp numSamples]

显示默认代理或指定主机和端口上的代理中指定服务的度量。 

 
metrics dst -t destType
   -n destName
   [-b hostName:portNumber]
   [-m metricType]
   [-int interval]
   [-msp numSamples]

显示指定类型和名称的物理目的地的度量信息。

表 10–4 imqcmd metrics 子命令选项

子命令选项 

描述 

 
-b hostName: portNumber

指定报告的度量数据所对应的代理的主机名和端口。默认为 localhost:7676。

 
-int interval

指定显示度量的时间间隔（以秒为单位）。默认为 5 秒。 

 
-m metricType

指定要显示的度量类型。 

ttl 显示流入和流出代理、服务或目的地的消息和包的度量（默认度量类型）。

rts 显示消息和包流入和流出代理、连接服务或目的地的速率的度量（以一秒为衡量单位）。

cxn 显示连接、虚拟内存堆和线程（仅适用于代理和连接服务）。

con 显示与使用方有关的度量（仅适用于目的地）。

dsk 显示磁盘使用情况度量（仅适用于目的地）。

 
-msp numSamples

指定输出中显示的样例数。默认为无限制（无穷多）。 

 
-n destName

指定报告的度量数据所对应的物理目的地（如果有）的名称。没有默认值。 

 
-n serviceName

指定报告的度量数据所对应的连接服务（如果有）。没有默认值。 

 
-t destType

指定报告的度量数据所对应的物理目的地（如果有）的类型（队列或主题）。没有默认值。 

使用 metrics 子命令显示度量数据

本节介绍使用 metrics 子命令报告度量信息的过程。

Procedure使用 metrics 子命令

  1. 启动需要度量信息的代理。

    请参见启动代理。

  2. 使用正确的 imqcmd metrics 子命令和选项，如表 10–3 和表 10–4 中所示。

度量输出：imqcmd metrics

本节包含 imqcmd metrics 子命令的输出示例。这些示例显示了代理范围、连接服务和物理目的地度量。

代理范围内的度量

要获取在 10 秒的时间间隔内流入和流出代理的消息和包的速率，请使用 metrics bkr 子命令：

imqcmd metrics bkr -m rts -int 10 -u admin

此命令产生类似如下内容的输出（请参见表 18–2 中的数据说明）：


--------------------------------------------------------
 Msgs/sec   Msg Bytes/sec   Pkts/sec    Pkt Bytes/sec   
 In   Out     In      Out     In   Out     In      Out  
--------------------------------------------------------
 0     0      27      56      0     0      38      66   
 10    0     7365     56      10    10    7457    1132  
 0     0      27      56      0     0      38      73   
 0     10     27     7402     10    20    1400    8459  
 0     0      27      56      0     0      38      73

连接服务度量

要获取 jms 连接服务所处理的消息和包的累计总数，请使用 metrics svc 子命令：

imqcmd metrics svc -n jms -m ttl -u admin

此命令产生类似如下内容的输出（请参见表 18–3 中的数据说明）：


-------------------------------------------------
  Msgs      Msg Bytes      Pkts      Pkt Bytes     
In   Out    In     Out   In   Out    In     Out  
-------------------------------------------------
164  100  120704  73600  282  383  135967  102127
657  100  483552  73600  775  876  498815  149948

物理目的地度量

要获取有关物理目的地的度量信息，请使用 metrics dst 子命令：

imqcmd metrics dst -t q -n XQueue -m ttl -u admin

此命令产生类似如下内容的输出（请参见表 18–4 中的数据说明）：


-----------------------------------------------------------------------------
  Msgs      Msg Bytes         Msg Count         Total Msg Bytes (k)     Largest
In   Out    In     Out    Current  Peak  Avg  Current  Peak     Avg    Msg (k)
-----------------------------------------------------------------------------
200  200  147200  147200     0     200    0      0      143      71        0  
300  200  220800  147200    100    200   10     71      143      64        0  
300  300  220800  220800     0     200    0      0      143      59        0

要获取有关物理目的地的使用方的信息，请使用下面的 metrics dst 子命令：

imqcmd metrics dst -t q -n SimpleQueue -m con -u admin

此命令产生类似如下内容的输出（请参见表 18–4 中的数据说明）：


------------------------------------------------------------------
  Active Consumers         Backup Consumers         Msg Count
Current  Peak  Avg      Current  Peak    Avg    Current  Peak  Avg
------------------------------------------------------------------
   1       1      0        0       0      0       944    1000  525

imqcmd query

表 10–5 中显示了 imqcmd query 的语法和选项以及该命令所提供的度量数据的说明。

表 10–5 imqcmd query 子命令语法

子命令语法 

提供的度量数据 

 

query bkr
   [-b hostName: portNumber]

有关当前存储在代理内存和持久性存储库中的消息个数和消息字节数的信息（请参见显示代理信息）。

或 

  

query svc -n serviceName
  [-b  hostName:portNumber]

有关指定的连接服务的当前已分配线程数和连接数的信息（请参见显示连接服务信息）。

或 

  

query dst -t destType
  -n destName
  [-b hostName:portNumber]

有关指定目的地当前的生成方数目、活动和备份使用方的数目以及存储在内存和持久性存储库中的消息数和消息字节数的信息（请参见显示有关物理目的地的信息）。

注 –

由于 imqcmd query 提供的度量数据有限，第 18 章，度量参考的表中未提到此工具。