Einen Diagnoseprovider erstellen
Mit Diagnoseprovidern können Sie die Startkonfiguration, die aktuelle Konfiguration und den aktuellen Status einer Diagnosedomäne abfragen. Darüber hinaus können Sie mithilfe der Diagnoseprovider auf alle Selbstdiagnosetests, die in einer Diagnosedomäne verfügbar sind, zugreifen.
Vorbereitende Schritte
Informationen zu diesem Vorgang
Vorgehensweise
- Bestimmen Sie Ihre Diagnosedomäne. Suchen Sie nach Konfigurations-MBeans, die eine ähnliche Domäne in derselben Komponente steuern. Die Erweiterung einer vorhandenen Konfigurations-MBean durch eine DP-Schnittstelle verhindert die Verbreitung neuer MBeans und hat den Vorteil, dass bei der Zuordnung einer Diagnose-MBean zu einer Konfigurations-MBean keine zusätzlichen Informationen erforderlich sind.
- Bestimmen Sie die Konfigurationsattribute, die Sie offen legen möchten. Geben Sie Informationen an, die zum Konfigurieren Ihrer Komponente über die Konfigurations-MBeans verwendet werden.
- Bestimmen Sie die Statusattribute, die Sie offen legen möchten. Hier können Sie alles verwenden, was Sie über den Status Ihrer Komponente für die Fehlerbehebung benötigen.
- Bestimmen Sie die Selbstdiagnosetests, die Sie offen legen möchten.
- Bestimmen Sie die Testattribute, die Sie für jede Selbstdiagnose zurückgeben.
- Erstellen Sie die XML-Datei für die DP-Registrierung.
- Erstellen Sie Ihre DP-Implementierung.
- Ein Beispiel finden Sie im Artikel Einen Diagnoseprovider implementieren. Denken Sie daran, dass die meisten Funktionen, die ein Diagnoseprovider ausführen soll, bereits in der Klasse DiagnosticProviderHelper ausgeführt werden.
- Um sicherzustellen, dass keine unerwünschten Daten erfasst werden, fügen Sie Ihrem Komponentencode mit dem Objekt DiagnosticConfig Hooks an den Stellen hinzu, an denen Sie Statusdaten erfassen möchten.
- Fügen Sie Ihrem Komponentencode Hooks an den Stellen hinzu, an denen Sie Konfigurationsdaten speichern bzw. auf diese zugreifen müssen.
- Fügen Sie Code für die Registrierung der DP-Implementierung hinzu. Gewöhnlich bietet sich hierfür die Stelle an, an der die Komponente initialisiert wird.
- Fügen Sie den protokollierten Nachrichten Diagnoseprovider-IDs (DPID) hinzu. Wenn Sie eine DPID für eine Protokollfunktion (Logger) registrieren, werden diese Informationen in allen
Nachrichten verwendet, die mit dieser Protokollfunktion aufgezeichnet werden. Damit werden Direktaufrufe im DP-Dienstprogramm für den jeweiligen Diagnoseprovider aktiviert.
- Registrieren Sie die DPID für die Protokollfunktionen (d. h. alle Protokollfunktionen, denen Sie genau eine DPID zuordnen möchten).
- Wenn Sie mehrere DPIDs für dieselbe Protokollfunktion verwenden, können Sie einzelnen Protokollierungsaufrufen an der Position parm[0] DPIDs zuordnen, anstatt genau eine DPID für eine Protokollfunktion zu registrieren. Verwenden Sie die Variable {0} nicht in den lokalisierten Nachrichten. Es wird nicht empfohlen, die DPID in den Nachrichten auszugeben, da dies nicht konsistent mit Nachrichten von Protokollfunktionen wäre, die statisch zugeordnete DPIDs haben.
Unterartikel
Extensible Markup Language des Diagnoseproviders
Im Folgenden werden verschiedene Konventionen für die XML-Deklarationen (Extensible Markup Language) von Diagnoseprovidern (DP) beschrieben.Namen des Diagnoseproviders auswählen
Zur Gewährleistung der Konsistenz bei der Auswahl von Diagnoseprovidernamen für Ihre Komponenten sollten Sie sich an die folgenden Richtlinien halten.Einen Diagnoseprovider implementieren
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.XML-Datei für die DP-Registrierung erstellen
In der XML-Datei für die Registrierung des Diagnoseproviders (DP) werden dem Dienstprogramm für den Diagnoseprovider Informationen zur offen gelegten Konfiguration, Statusangaben sowie Attribute und Tests für die Selbstdiagnose bereitgestellt. Sie wird auch verwendet, um Objekte, die später im Prozess benötigt werden, mit Daten zu füllen, und somit Filterungs- und Lokalisierungsvorgänge zu vereinfachen.


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