Para utilizar un proveedor de diagnósticos, debe configurar un MBean con
los métodos y atributos necesarios para manejar los datos desde el servidor de
aplicaciones y las aplicaciones cliente.
Antes de empezar
Esta tarea da por supuesto que tiene conocimientos de programación de la creación de MBeans. Para obtener más información sobre la interacción de MBeans con WebSphere Application
Server, consulte cómo crear y registrar información MBeans personalizados estándares, abiertos y dinámicos.
Acerca de esta tarea
Los pasos siguientes describen un proceso general para implementar un proveedor de diagnósticos (DP).
Procedimiento
- Modifique el archivo XML (Extensible Markup Language) del descriptor MBean. Para implementar un proveedor de diagnósticos, debe tener un MBean, y el
MBean debe incluir esta sentencia en el XML descriptor como hijo directo del elemento MBean:
<parentType type="DiagnosticProvider"/>
Esto
define las operaciones, atributos y agregadores necesarios para que un MBean sea un proveedor de diagnósticos. Si no necesita que este DP exista en los controladores z/OS, esta inclusión XML maneja todos los específicos z/OS para el MBean.
- Modifique la implementación de MBean. El MBean ya debe tener
una clase que crea una instancia y la registra con el servidor JMX (Java™ Management
Extensions).
La primera diferencia es que debe definir una propiedad en la clase
Properties que se pasa al registro
(y pasa a formar parte de
ObjectName). La propiedad es
diagnosticProvider=true y se puede añadir con una línea de código, como, por ejemplo:
MyProps.setProperty(DiagnosticProvider.DIAGNOSTIC_PROVIDER_KEY, DiagnosticProvider.DIAGNOSTIC_PROVIDER_VALUE) ;
La segunda diferencia es que esta clase debe registrar este proveedor de diagnósticos con el servicio de diagnóstico. Esta disponible un método de ayudante para hacer esto:
DiagnosticProviderHelper.registerMBeanWithDiagnosticService(DiagnosticProviderPName, DiagnosticProviderId) ;
Obviamente, esto se debe realizar después del registro, cuando puede recuperarse
ObjectName en la serie
DiagnosticProviderId.
- Implemente los métodos del proveedor de diagnósticos.