本主题介绍如何为 IBM WebSphere ESB 配置监控。章节目录:
WebSphere 配置
IBM WebSphere ESB 包括基于其底层 WebSphere 应用程序服务器构建的监控功能。Parasoft SOAtest 可以订阅在处理服务组件时触发的公共基础事件,这些事件由 WebSphere 公共事件基础设施(CEI)管理。
有关在 WebSphere ESB 中监控服务组件事件和使用 WebSphere 管理控制台启用监控的信息,请参阅 IBM 监控服务组件事件主题。
若要为事件监控配置 WebSphere:
- 请在 ESB 中启用 CEI 服务。
- 为您感兴趣的服务组件选择日志级别。在 ESB 上执行此任务的步骤可以在使用管理控制台主题配置服务组件事件监控的 IBM 中找到。
为了在 SOAtest 中获得完整的事件详情,我们建议您针对感兴趣的组件启用“ALL MESSAGES AND TRACES”选项和“FINEST”日志级别,这样业务消息就会包含在 CEI 事件中。要对所有业务集成组件启用上述功能,WebSphere 管理控制台中的日志级别字符串应如下所示:
*=info: WBILocationMonitor.CEI.SCA.com.*=finest
SOAtest 配置
向 SOAtest classpath 添加所需的 Jar 文件
需要将以下 jar 文件添加到 SOAtest classpath 中:
- 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 的 classpath 中:
- 前往 Parasoft > 首选项。
- 打开 Parasoft> 系统属性页面。
- 点击添加 JARs 并找到要添加的 JAR 文件。
配置事件源
双击事件监控工具,打开工具配置面板。点击事件源选项卡,并指定以下内容:
平台 | 从平台下拉菜单中选择 IBM WebSphere Enterprise Service Bus。 |
---|---|
连接 | 指定您的 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 连接。 |
监控源 | 指定连接工厂(默认为 jms/cei/notification/AllEventsTopicConnectionFactory)。 指定目标名称(默认为 jms/cei/notification/AllEventsTopic)。这是报告所有 CEI 事件的 CEI 主题。 从接收站类型下拉菜单中选择 Queue 或 Topic。 (可选)在消息选择器字段中,输入一个值作为消息过滤器。更多提示,请参阅使用消息选择器过滤器。 如果希望 SOAtest 使用 JMS QueueBrowser API 跟踪发布在 JMS 队列上的消息而不将其从队列中删除,则启用保留消息到队列。这允许 SOAtest 在不影响事务的情况下获得对这些消息的可见性。 |
JDNI 属性 | 如果希望将任何其他 JNDI 属性应用于此部署,请在 JNDI 属性表中指定。 |
配置事件监控选项
点击选项选项卡并根据需要修改设置。
每次事件监控器执行前清除事件查看器 | 启用此选项,可在事件监控器启动监控时自动清除事件监控器事件视图(包括文本和图形)。 |
---|---|
输出到链接工具的 XML 事件中包含测试执行事件 | 启用此选项仅在事件查看器选项卡和 XML 输出显示中显示受监控的消息和事件。。此选项还指示每次测试启动和完成的时间。如果您在测试套件中有多个测试,并且希望更好地识别事件并将它们与您的测试执行关联起来,那么启用该选项非常有帮助。 |
使用 CDATA 包裹监控的消息以确保 XML 事件输出格式标准化 | 如果您不希望被监控事件的消息内容是格式良好的 XML,则启用此选项。禁用此选项将使事件中的消息可以通过 XPath 访问,从而允许 XML 转换器提取消息内容或使用 XML 断言器工具进行验证。 如果消息内容不是 XML,则启用此选项。这确保了事件监控工具的 XML 输出(即,用于将链接工具链接到事件监控的 XML 事件输出(而不是事件查看器下显示的内容)是格式良好的 XML,它转义了所有消息内容。这将使 XPath 无法访问这些消息的内容,因为从技术上讲,消息只是父元素的字符串内容。 比较工具的 XML 模式支持 XML 字符串内容。因此,比较工具仍然能够将消息区分为 XML 格式,包括使用 XPath 忽略值的功能,即使禁用了该选项。 |
等待监控器启动的最大时间 (毫秒) | 指定在 SOAtest 运行套件中的其他测试之前,事件监控器应该等待连接到事件源的最大时间长度。这使 SOAtest 能够为这些测试捕获事件,并防止在事件监控器连接到它的事件源时过度阻塞其他测试的执行。如果连接到事件源花费的时间超过默认值,则增加该值。默认为 3000 。 |
监控器最大执行时间 (毫秒) | 指定测试应该超时的点。例如,如果测试套件中的另一个测试挂起,或者没有运行其他测试(例如,如果您在测试套件之外执行事件监控测试,那么使用自定义应用程序向系统发送消息)。 |
每次测试结束执行后事件查询延迟时间 (毫秒) | 此字段不适用于 IBM WebSphere ESB。 |
查看监控事件
测试运行后,事件监控器将显示它从 WebSphere 接收的公共基础事件的 XML 表示,包括事件的原始业务数据(如果存在的话)。