CandleMonitor 节点图标
CandleMonitor 节点是 IBM Tivoli OMEGAMON XE for Messaging: WebSphere Message Broker Monitoring 产品的一部分。它收集有关消息流性能的统计信息,并可选择产生 OMEGAMON XE 检测的事件消息。它是具有一个输入终端(“in”)和一个输出终端(“out”)的简单传递节点。CandleMonitor 节点传播消息,但从输入终端传递到输出终端不会对该消息作任何更改。
CandleMonitor 节点的主要用途是产生统计信息。在消息流中正确放入该节点,以使监视产品统计信息报告中包含有用数据,这一点很重要。为了获得最好的统计信息,设计消息流时,应紧跟在 MQInput 节点之后放入 CandleMonitor 节点。放入在该位置的节点的类型属性应该更改为“input”。如果只想在消息流中放入一个 CandleMonitor 节点,则“input”位置是最佳选择,因为大多数统计信息是从该位置生成的。但放入该节点的另一个重要位置是紧接在任何输出节点之前以允许计算输出速率,这些输出节点有 MQOutput、MQReply 或 Publication 节点等。此处节点的类型属性应该更改为“output”。
可以选择对消息流的一部分(此处称为子流)产生统计信息。子流可以是嵌入到主消息流中的单个消息流(第 I 类),或者只是流中一组节点,将其定义为使用 CandleMonitor 节点的子流(第 II 类)。
要监视第 I 类子流,应该紧跟在流中输入终端之后放入一个 CandleMonitor 节点,并且紧接在流的输出终端或其他输出之前放入另一个 CandleMonitor 节点。所有这些节点的子流名称属性都应该指定相同的值。输入位置的节点的类型应该是“subFlowInput”。输出位置的节点的类型应该是“subFlowOutput”,或者如果输出实际上是诸如 MQOutput 等节点,则为“output”,它表示沿该特定路径下行的消息的消息流结束。
要监视第 II 类子流,应该将 CandleMonitor 节点置于所需子流的开始处,其类型设置为“subFlowInput”,并且指定其子流名称属性。然后,应该将 CandleMonitor 节点置于子流的结束处,将其类型设置为“subFlowOutput”,并指定与输入节点相同的子流名称属性值。如果要监视的消息流部分具有多个输入连接器或者多个输出连接器,则需要以相同方法对同一子流名称添加多个 CandleMonitor 节点。
必须对 CandleMonitor 节点同时标记流的输入和输出,以便计算出有效的统计信息。子流中必须有“subFlowOutput”类型的 CandleMonitor 节点。这不是可选的,而当前主消息流是否有“output”类型的节点则是可选的。如果在设置子流名称属性时将类型属性设置为“input”,则可认为该节点在行为方式上是类型“input”和类型“subFlowInput”的结合。如果在设置子流名称属性时将类型属性设置为“output”,则可认为该节点在行为方式上是类型“output”和类型“subFlowOutput”的结合。
如果您只想收集消息流中的单个点的统计信息并在“CandleMonitor 节点统计信息”报告视图中查看它们,则可以将 CandleMonitor 节点放入于消息流中的其他任何地方。当以这种方式放入该节点时,该节点的类型属性应该设置为“other”。对于类型属性为“other”的节点,可以设置子流名称属性,但它的作用只是将该节点识别为子流的一部分,而不会影响生成的子流统计信息。
CandleMonitor 节点的另一个用途是产生用户定义的消息流事件,通过“OMEGAMON XE 消息流事件”情景和报告可以检测这些事件。当为了此用途而放入节点时,类型属性应该是“other”,并且事件消息属性应该设置为每次进入该节点时希望显示报告的消息文本和/或用情境进行检测的消息文本。CandleMonitor 节点还捕获事件中的其他信息以帮助确定受影响的消息流部分和发生事件时正在处理的消息。
是否出于生成消息流事件的用途而放入节点是完全由用户决定的,但 IBM 建议在视为正常处理的消息流部分不要出于此用途而放入节点。建议对于处理故障或视为非正常并触发警报情境的其他情况,在消息流路径中使用此功能。例如,在 MQInput 节点上的“failure”终端之后可出于此用途放入节点。建议不要对任何“input”或“output”类型的节点设置事件消息属性。 同样,只能对类型为“subFlowInput”或“subFlowOutput”且不处于正常处理中(例如,在错误处理子流中)的那些节点设置事件消息属性。对于 CandleMonitor 节点检测到的消息流异常,该节点都自动生成事件。请注意,由于 CandleMonitor 节点只是一个传递节点,因此它不执行任何错误恢复。在这种能力下,它只是一种报警机制。
收集队列时间属性应用于“input”类型节点,并允许关闭队列时间统计信息的收集。队列时间是用队列中消息的放入日期和时间计算的。如果消息流输入队列中的消息所带的放入日期和时间不能准确反映消息放入输入队列的时间,那么在配置 CandleMonitor“input”类型节点时,名为收集队列时间的属性应该设置为“no”,以便不对这些消息收集队列时间。如果在应用程序将消息放入消息流输入队列的过程中保留消息的原始上下文,则放入日期时间不是准确的指示器。当应用程序是消息移动者,将消息从一个队列移动到另一个队列,或者当应用程序传递或设置消息的原始上下文时,通常会发生这种情况。特别地,如果消息流 B 的输入队列是消息流 A 的输出队列,则代理程序将传递原始上下文,这样消息流 B 中消息的放入日期和时间使得无法准确计算队列时间。应该将消息流 B 中的 CandleMonitor 节点的收集队列时间属性设置为“no”。
激活节点属性允许指定 CandleMonitor 节点的激活级别,以便可以关闭它。缺省设置为“yes”,它表示该节点是活动的(未关闭)。对于 WebSphere Business Integration V5.0 及后续版本,激活节点属性是可配置的。这意味着可以在 bar 文件配置过程中进行设置,以便可以使不同的 bar 文件具有不同的设置(例如用于部署测试与生产)。另外,V5.0 允许提升属性设置,这样对于消息流中 CandleMonitor 节点的每个实例,该属性将具有相同的设置。对该属性的可能值进行设置时,支持对“该节点何时应该处于活动状态”之类的一般规则作出指定,如对于所有输入和输出类型的节点(而不是任何其他类型的节点),它应该是活动的。一般来说,当在消息流中配置 CandleMonitor 节点时,保留设置为缺省值“yes”,以在测试过程中简化节点的用法。然后,当部署到生产代理程序中时,将激活节点的 bar 文件设置配置为所需的级别,并提升该属性以便自动将流中所有节点的设置更改为该激活级别。对于 5.0 之前的版本(需要时也包含 5.0),CandleMonitor 节点插件代码接受激活节点属性的运行时覆盖设置的规范,这允许不同代理程序处于不同激活级别。有关更多信息,请参阅本产品的《用户指南》。
in | 接受消息以供节点处理的输入终端。 |
out | 消息传播到的输出终端。 |
属性 | 缺省值 | 描述 |
类型 | "other" | 指定 CandleMonitor 节点的类型。
有效值是:
|
事件消息 | "" | 如果该值设置为非 "" 的值,则输入节点时将生成事件。 |
收集队列时间 | "yes" | 指定节点是否应该收集队列计时。有效值是 yes 和 no。 |
子流名称 | "" | 指定 CandleMonitor 节点所属的子流的名称。 |
激活节点 | "yes" | 指定节点的激活级别。有效值是:
|
(C) IBM Corporation 2006. All Rights Reserved