本主题解释如何为 IBM WebSphere ESB 配置监视。本章包含:
WebSphere 配置
IBM WebSphere ESB 包括基于其底层 WebSphere 应用程序服务器构建的监视功能。Parasoft SOAtest 可以订阅在处理服务组件时触发的公共基础事件,这些事件由 WebSphere 公共事件基础设施(CEI)管理。
有关在 WebSphere ESB 中监视服务组件事件和使用 WebSphere 管理控制台启用监视的信息,请参阅 IBM 监视服务组件事件主题。
若要为事件监视配置 WebSphere:
- 请在 ESB 中启用 CEI 服务。
- 为您感兴趣的服务组件选择日志级别。在 ESB 上执行此任务的步骤可以在使用管理控制台主题配置服务组件事件监视的 IBM 中找到。
为了快速获得完整的事件细节,我们建议您选择
"ALL MESSAGES AND TRACES” 选项和您感兴趣的组件的“最佳”日志级别,这将导致业务消息包含在 CEI 事件中。为了支持所有业务集成组件,WebSphere 管理控制台中的日志级别字符串应该如下所示:*=info: WBILocationMonitor.CEI.SCA.com.*=finest
SOAtest 配置
向 SOAtest 类路径添加所需的 Jar 文件
需要将以下 jar 文件添加到 SOAtest 类路径中:
- com.ibm.ws.ejb.thinclient_7.0.0.jar
- com.ibm.ws.orb_7.0.0.jar
- com.ws.sib.client.thin.jms_7.0.0.jar
- com.ibm.ws.emf_2.1.0.jar
jar 文件可以在 [WAS installation dir]/runtimes 下找到。
若要将这些 jar 文件添加到 SOAtest 的类路径,请完成以下操作:
- 选择 Parasoft> Preferences。
- 打开 Parasoft> System Properties 页面。
- 单击 Add JARS 按钮,选择并勾选需要添加的 JAR 文件。
配置事件源
双击 Event Monitor 工具以打开工具配置面板。单击 Event Source 选项卡,并指定以下内容:
Platform | 从 Platform 下拉菜单中选择 IBM WebSphere Enterprise Service Bus 。 |
---|---|
Connection | 指定您的 ESB 连接设置。 连接 URL 是 WebSphere 默认 JMS 提供程序的 JNDI InitialContext URL。端口号是 WebSphere 引导端口。您可以使用 Servers 下的管理控制台 WebSphere 应用程序服务器来选择 WebSphere ESB 正确的端口号,然后单击或展开“Communication”节下的“Ports”链接。要在 SOAtest 中使用的端口号是 BOOTSTRAP_ADDRESS 值。 用户名和密码是在 WebSphere ESB 中配置的凭据(在安全性下,公共事件基础设施的 WebSphere 管理控制台的业务集成安全性)。 SOAtest 使用您提供的凭据创建事件 JMS 主题的 JNDI InitialContext 并创建 JMS 连接。 |
Monitoring Source | 指定连接工厂(默认为 jms/cei/notification/AllEventsTopicConnectionFactory)。 指定目标名称(默认为 jms/cei/notification/AllEventsTopic)。这是报告所有 CEI 事件的 CEI 主题。 从 Destination Type 下拉菜单选择 Queue 或 Topic 。 (可选项)在 Message Selector 字段中,输入一个值作为消息过滤器。查阅 Using Message Selector Filters 以获得更多技巧。 如果希望 SOAtest 使用 JMS QueueBrowser API 跟踪发布在 JMS 队列上的消息,而不需要从队列中删除它们,则启用 Leave messages on the queue 选项 。这允许 SOAtest 在不影响事务的情况下获得对这些消息的可见性。 |
JDNI Properties | 如果希望将任何其他 JNDI 属性应用于此部署,请在 JNDI 属性表中指定它们。 |
配置事件监视选项
单击 Options 选项卡并根据需要修改设置。
Clear the event viewer before each event monitor run | 启用此选项,可在事件监视器启动监视时自动清除事件监视器事件视图(包括文本和图形)。 |
---|---|
Include test execution events in the XML event output to chained tools | 启用此选项 仅在事件查看器选项卡和 XML 输出显示中显示受监视的消息和事件。 。此选项还指示每次测试启动和完成的时间。如果您在测试套件中有多个测试,并且希望更好地识别事件并将它们与您的测试执行关联起来,那么启用该选项非常有帮助。 |
messages with CDATA to ensure well-formedness of the XML event output | 如果您不希望被监视事件的消息内容是格式良好的 XML,则启用此选项。禁用此选项将使事件中的消息可以通过 XPath 访问,从而允许 XML 转换器提取消息内容或使用 XML 断言器工具进行验证。 如果消息内容不是 XML,则启用此选项。这确保了事件监控工具的 XML 输出(即,用于将链接工具链接到事件监视器的 XML 事件输出(而不是事件查看器下显示的内容)是格式良好的 XML,它转义了所有消息内容。这将使 XPath 无法访问这些消息的内容,因为从技术上讲,消息只是父元素的字符串内容。 Diff 工具的 XML 模式支持 XML 字符串内容。因此,Diff 工具仍然能够将消息区分为 XML 格式,包括使用 XPath 忽略值的功能,即使禁用了该选项。 |
Maximum time to wait for the monitor to start (milliseconds) | 指定在 SOAtest 运行套件中的其他测试之前,事件监视器应该等待连接到 事件源的最大时间长度。这使 SOAtest 能够为这些测试捕获事件,并防止在事件监视器连接到它的事件源时过度阻塞其他测试的执行。如果连接到事件源花费的时间超过默认值,则增加该值。默认为 3000 。 |
Maximum monitor execution duration (milliseconds) | 指定测试应该超时的点。例如,如果测试套件中的另一个测试挂起,或者没有运行其他测试(例如,如果您在测试套件之外执行事件监视器测试,那么使用自定义应用程序向系统发送消息)。 |
Event polling delay after each test finishes execution (milliseconds) | 此字段不适用于 IBM WebSphere ESB。 |
查看监控事件
测试运行后,事件监视器将显示它从 WebSphere 接收的公共基础事件的 XML 表示,包括事件的原始业务数据(如果存在的话)。