Wenn Sie einen Diagnoseprovider verwenden möchten, müssen Sie eine MBean mit den Methoden und Attributen konfigurieren, die erforderlich sind, um die Daten
des Anwendungsservers und der Clientanwendungen bearbeiten zu können.
Vorbereitende Schritte
Dieser Task setzt Erfahrungen in der Programmierung von MBeans voraus. Weitere Informationen zur Interaktion von MBeans mit
WebSphere Application
Server finden Sie in der Dokumentation zum Erstellen und Registrieren von Standard-, dynamischen und offenen angepassten
MBeans.
Informationen zu diesem Vorgang
Die folgenden Schritte veranschaulichen einen allgemeinen Prozess für die Implementierung eines
Diagnoseproviders.
Vorgehensweise
- Ändern Sie die Deskriptor-XML (Extensible Markup Language) der MBean. Für die Implementierung eines Diagnoseproviders benötigen Sie eine MBean. Diese MBean muss die folgende Anweisung in ihrer
Deskriptor-XML als untergeordnetes Element des Elements MBean enthalten:
<parentType type="DiagnosticProvider"/>
Dieses Element definiert die Operationen, Attribute und
Aggregatoren, die eine MBean haben muss, um als Diagnoseprovider eingesetzt zu werden. Wenn es für Sie nicht erforderlich ist, dass dieser Diagnoseprovider in z/OS-Controllern vorhanden ist, verarbeitet dieser XML-Einschluss alle z/OS-Spezifikationen für Ihre MBean.
- Ändern Sie die MBean-Implementierung. Ihre MBean sollte bereits über eine Klasse verfügen, die sie instanziiert und beim JMX-Server (JMX - Java™ Management
Extensions) registriert.
Der erste Unterschied besteht hier darin, dass Sie eine Eigenschaft
in der Klasse
Properties definieren müssen, das an die Registrierung
übergeben (und Teil des
Objektnamens) wird. Die Eigenschaft hat den Namen
diagnosticProvider=true und kann mit einer Codezeile wie der folgenden hinzugefügt werden:
MyProps.setProperty(DiagnosticProvider.DIAGNOSTIC_PROVIDER_KEY, DiagnosticProvider.DIAGNOSTIC_PROVIDER_VALUE) ;
Der zweite Unterschied besteht darin, dass diese Klasse den Diagnoseprovider beim Diagnoseservice registrieren muss. Hierfür steht eine Helper-Methode zur Verfügung:
DiagnosticProviderHelper.registerMBeanWithDiagnosticService(DiagnosticProviderPName, DiagnosticProviderId) ;
Dieser Schritt muss nach der Registrierung ausgeführt werden, wenn der
Objektname in die Zeichenfolge für
DiagnosticProviderId abgerufen werden kann.
- Implementieren Sie die Methoden für den Diagnoseprovider.