创建诊断提供程序
使用诊断提供程序来查询诊断域的启动配置、当前配置和当前状态。诊断提供程序还允许您访问诊断域中提供的任何自我诊断测试。
开始之前
关于此任务
过程
- 确定诊断域。 查找在同一个组件中用来控制类似域的配置 MBean。使用 DP 接口扩展现有的配置 MBean 避免了增加新 Mbean,以及从一个诊断 MBean 映射至一个配置 MBean 时不需要附加信息。
- 确定要显示的配置属性。 包含用来从配置 MBean 配置组件的信息。
- 确定要显示的状态属性。 在此处,可以找到您可能需要知道有关故障诊断的组件状态信息。
- 确定要显示的自诊断测试。
- 确定将为每个自诊断返回的测试属性。
- 创建您的 DP 注册可扩展标记语言 (XML) 文件。
- 创建您的 DP 实现。
- 要查看示例,请参阅实现诊断提供程序,并记住已在 DiagnosticProviderHelper 类中为您完成一个诊断提供程序应该做的大部分事情。
- 要确保不会收集不想要的数据,使用 DiagnosticConfig 对象在您的组件代码中需要收集状态数据的地方添加挂钩。
- 在您的组件代码中需要存储或者能够访问配置数据的地方添加挂钩。
- 添加代码以注册您的 DP 实现。 通常,组件初始化的位置最适合执行这个操作。
- 添加诊断提供程序标识 (DPID) 至所记录的消息。 使用记录器注册一个 DPID 使得该信息可存在于任何使用此记录器记录的消息中。这允许 DP
实用程序中的快速路径在此特定的诊断提供程序上起作用。
- 使用您的记录器注册 DPID(对于任何仅需要和单个 DPID 关联的记录器)。
- 当使用具有相同记录器的多个 DPID 时,可以(代替使用记录器注册单个 DPID)在 parm[0] 位置将 DPID 添加至单独的日志记录调用。 不要将 {0} 放入相应的本地化消息中。将 DPID 放入消息中是不好的行为,这是因为这将与具有静态分配 DPID 的记录器中的消息不一致。
子主题
诊断提供程序可扩展标记语言
对于诊断提供程序 (DP) 可扩展标记语言 (XML) 声明,需要遵守一些约定。选择诊断提供程序名称
要确保在选择与组件配合使用的诊断提供程序名时保持一致,应考虑下面的准则。实现诊断提供程序
要使用诊断提供程序,必须使用处理应用程序服务器和客户机应用程序中的数据所需的方法和属性来配置 MBean。创建诊断提供程序注册 XML 文件
诊断提供程序注册 XML 用于提供有关显示的配置、状态以及自诊断属性和对该诊断提供程序实用程序的测试。它还用来填充以后在处理中需要的对象、辅助过滤以及辅助本地化。


http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-mp&topic=ttrb_createdp
文件名:ttrb_createdp.html