监视服务

代理中包含一些用于监视和诊断应用程序及代理性能的组件。其中包括：

• 生成数据的组件，包括度量生成器和记录事件的代理代码

• 将输出信息写入多个输出通道的记录程序组件

• 度量消息生成方，将包含度量信息的 JMS 消息发送到主题目的地，以供 JMS 监视客户端使用

图 4–3 中显示的是常规模式。 监视属性中列出了用于配置监视服务的代理属性。

图 4–3 监视支持

度量生成器

度量生成器提供有关代理活动的信息，如流入流出代理的消息、代理内存中的消息数及其使用的内存量、打开的连接数以及正在使用的线程数。 布尔型代理属性 imq.metrics.enabled 控制是否记录此类信息；imq.metrics.interval 指定记录的频率。

记录程序

出错时，记录程序获取代理代码和度量生成器生成的信息，并将这些信息写入标准输出（控制台）、日志文件以及 syslog 守护进程（在 Solaris 平台上）中。要使用的日志文件由 imq.log.file.dirpath 和 imq.log.file.filename 代理属性标识； imq.log.console.stream 指定将控制台输出定向到 stdout 还是 stderr。

imq.log.level 属性控制记录程序收集的度量信息的类别： ERROR、WARNING 或 INFO。每个级别都包括高于它的级别，因此，如果您指定 WARNING 作为日志记录级别，则将同时记录错误消息。imq.log.console.output 和 imq.log.file.output 属性分别控制将哪些指定类别写入控制台和日志文件。 但在这种情况下，类别并不包括高于它的类别；因此，如果您要将错误和警告写入日志文件，而将信息性消息写入控制台，则必须明确地将 imq.log.file.output 设置为 ERROR|WARNING，将 imq.log.console.output 设置为 INFO。在 Solaris 平台上，使用另一个属性 imq.log.syslog.output 来指定要写入 syslog 守护进程的度量信息的类别。 此外还有一个 imq.destination.logDeadMsgs 属性，该属性指定当停用消息被丢弃或移动到停用消息队列时是否进行记录。

对于日志文件，可以指定何时关闭文件并将输出转移到新文件。 当日志文件达到指定的大小 (imq.log.file.rolloverbytes) 或生存期 (imq.log.file.rolloversecs) 之后，将保存该文件并创建一个新的日志文件。

有关与日志记录相关的其他代理属性，请参见监视属性；有关如何配置记录程序以及如何使用它来获取性能信息的更多详细信息，请参见配置和使用代理日志记录。

度量消息生成方 (Enterprise Edition)

度量消息生成方以一定的时间间隔从度量生成器接收信息，并将该信息写入度量消息，然后根据消息中包含的度量信息类型，将度量消息发送到多个度量主题目的地之一（请参见表 4–2）。订阅这些度量主题目的地的 Message Queue 客户端可以使用这些消息并处理消息中包含的度量数据。 这样，开发者就可以创建自定义监视工具来支持消息传送应用程序。有关在每种类型的度量消息中报告的度量数量的详细信息，请参见 Message Queue Developer's Guide for Java Clients。

代理属性 imq.metrics.topic.enabled 和 imq.metrics.topic.interval 分别控制是否将消息发送到度量主题目的地以及发送的频率。 imq.metrics.topic.timetolive 和 imq.metrics.topic.persist 属性分别指定此类消息的生命周期和持久性。

除了包含在度量消息主体中的信息之外，每个消息头中还包含提供以下附加信息的属性：

• 消息类型

• 发送消息的代理的地址（主机名和端口号）

• 度量样例的取样时间

这些属性对于处理不同类型（或来自不同代理）度量消息的客户端应用程序非常有用。