Adapter für unmittelbare Anwendungsüberwachung konfigurieren

Der generische Protokolladapter stellt eine Ausgabeprogrammklasse zur Verfügung, die es ermöglicht, die vom Adapter generierten Common Base Event-Objekte an einen Protokollierungsagenten zu senden. Die Protokoll- und Traceanalysefunktion kann dem Protokollierungsagenten zugeordnet werden, um das Anwendungsprotokoll in Echtzeit zu überwachen und zu analysieren.

Voraussetzungen:

Regelbasierten Adapter erstellen oder Statischen Adapter erstellen
Hyades-Datenerfassungsagenten installieren

Um den Adapter für Überwachung zu konfigurieren, sind die folgenden Schritte erforderlich:

Ausgabeprogrammkomponente konfigurieren
Kontextexemplar konfigurieren
Java-Prozess zum Ausführen des Adapters starten
Verbindung zum Protokollierungsagenten mit Hilfe der Protokoll- und Traceanalysefunktion herstellen

Ausgabeprogrammkomponente aktualisieren

Hinweis: Eine neu erstellte Adapterkonfigurationsdatei wird standardmäßig für die Verwendung der Klasse 'CBELogOutputter' konfiguriert. Wenn Sie diese Einstellung nicht geändert haben, können Sie diese Prozedur überspringen.

Die Ausgabeprogrammkomponente in der Adapterkonfigurationsdatei muss entsprechend aktualisiert werden, damit sie die Klasse 'CBELogOutputter' verwendet, die die Common Base Event-Objekte an einen Protokollierungsagenten schreibt. Sie können entweder die vorhandene Ausgabeprogrammkomponente aktualisieren oder eine neue Ausgabeprogrammkomponente hinzufügen.

Um eine neue Ausgabeprogrammkomponente hinzuzufügen, gehen Sie wie folgt vor:

Um die Adapterkonfigurationsdatei zu bearbeiten, wählen Sie die Adapterkonfigurationsdatei im Teilfenster 'Navigator' aus. Klicken Sie die rechte Maustaste an und wählen Sie Öffnen mit > Editor für Adapterkonfiguration aus. Die Datei wird dann im Editor geöffnet.
Erweitern Sie im Fenster 'Editor für Adapterkonfiguration' den Knoten Adapter > Konfiguration > Kontextexemplar.
Klicken Sie das Kontextexemplar mit der rechten Maustaste an und wählen Sie Hinzufügen > Ausgabeprogramm aus. Im Kontextexemplar wird dann ein neues Ausgabeprogramm erstellt.
Wählen Sie im Feld Ausgabeprogrammtyp die Option LoggingAgentOutputter aus.
Klicken Sie die Eigenschaft agentName (Agentenname) an. Die Details zu dieser Eigenschaft werden dann im rechten Teilfenster angezeigt.
Aktualisieren Sie den Wert der Eigenschaft mit dem Namen des gewünschten Protokollierungsagenten. Dies ist der Name, der in der Protokoll- und Traceanalysefunktion als zu überwachender Protokollierungsagent angezeigt wird.
Wenn das Ausgabeprogramm warten soll, bevor es Informationen für die Klasse 'CBELogOutputter' protokolliert, müssen Sie die Eigenschaft waitUntilLoggingTime hinzufügen und den Wert dieser Eigenschaft auf die gewünschte Zeit in Millisekunden einstellen. Um die Eigenschaft hinzuzufügen, klicken Sie das neu erstellte Ausgabeprogramm mit der rechten Maustaste an und wählen Sie Hinzufügen > Eigenschaft aus. Unterhalb des Knotens 'Ausgabeprogramm' wird eine neue Eigenschaft erstellt.
Um die Klasse 'CBELogOutputter' zu aktivieren, müssen Sie die zugeordnete Ausgabeprogrammkomponente für 'Kontexte: Basiskontextimplementierung' erstellen. Öffnen Sie hierzu entsprechend Kontexte > Kontext: Basiskontextimplementierung.
Klicken Sie Kontext: Basiskontextimplementierung mit der rechten Maustaste an und wählen Sie Hinzufügen > Komponente aus. Dem Kontext wird dann eine neue Komponente hinzugefügt.

Konfigurieren Sie die neue Komponente anhand der folgenden Werte:

Name:	Name des Ausgabeprogramms im Kontext
Beschreibung:	Beschreibung der Funktion dieses Ausgabeprogramms
Ausführbare Klasse:	org.eclipse.hyades.logging.adapter.outputters.CBELogOutputter
Protokollebene:	Die Ebene der internen Protokollierung, die die Ausgabeprogrammkomponente verwenden sollte. Ein Wert von 99 bedeutet, dass das Ausgabeprogramm keine Nachrichten protokolliert. Ein Wert von 0 bedeutet, dass das Ausgabeprogramm Nachrichten aller Wertigkeiten protokolliert. Der empfohlene Wert ist 50 und bedeutet, dass nur kritiche oder fatale interne Ausgabeprogrammfehlernachrichten protokolliert werden.
Berechtigungsklasse:	Ausgabeprogramm
Eindeutige ID:	Muss auf das Ausgabeprogramm verweisen, das im Kontextexemplar in Schritt 2 definiert wurde. Verwenden Sie die Schaltfläche Durchsuchen, um die korrekte ID auszuwählen.

Speichern Sie die Änderungen an der Adapterkonfigurationsdatei.

Kontextexemplar aktualisieren

Soll der Protokollparser die Protokolldatei ununterbrochen überwachen, müssen Sie die Eigenschaften des Kontextexemplars in der Adapterkonfigurationsdatei entsprechend für unterbrechungsfreie Operation aktualisieren.

Um die Adapterkonfigurationsdatei zu bearbeiten, wählen Sie die Adapterkonfigurationsdatei in der Perspektive 'Navigator' aus. Klicken Sie die rechte Maustaste an und wählen Sie Öffnen mit > Editor für Adapterkonfiguration aus. Die Datei wird dann im Editor geöffnet.
Wählen Sie im Editierfenster nacheinander die Optionen Adapter > Konfiguration > Kontextexemplar aus. Die Details zum Kontextexemplar werden dann im rechten Teilfenster angezeigt.
Wählen Sie das Markierungsfeld Unterbrechungsfreie Operation aus.
Konfigurieren Sie die Felder 'Maximale Leerlaufzeit' und 'Pausenintervall' entsprechend Ihren Anforderungen.
Speichern Sie die Änderungen an der Adapterkonfigurationsdatei.

Java-Prozess zum Ausführen des Adapters starten

Der von Ihnen erstellte Protokolladapter kann entweder extern über eine Stapeldatei in der Windows-Umgebung oder über ein Shell-Script in Nicht-Windows-Umgebungen ausgeführt werden. Nachstehend finden Sie einige Beispieldateien, die Sie verwenden können, um den Java-Prozess zu starten, der Ihren Protokolladapter ausführt.
Hinweis: Um den den generischen Protokolladapter auf einem System auszuführen, muss Hyades auf diesem System installiert sein.

Windows-Stapeldatei:

@rem SYNTAX:  runregex
@rem Ändern Sie die folgenden Zeilen, damit sie auf das Verzeichnis verweisen, in dem die Laufzeit dekomprimiert wurde,
@rem und auf das Verzeichnis, in dem sich der Protokolladapter befindet. 
SET HYADES_HOME=d:\hyadesDC
SET ADAPTER_VERZEICHNIS=MyAdapterDirectory
SET KONFIGURATIONSDATEI=%HYADES-AUSGANGSVERZEICHNIS%\%ADAPTER-VERZEICHNIS%\myadapter.adapter
PUSHD %HYADES-AUSGANGSVERZEICHNIS%\%ADAPTER-VERZEICHNIS%
java -classpath "%HYADES_HOME%\lib\glaconfigs.jar;%HYADES_HOME%\lib\hexr.jar;%HYADES_HOME%\lib\hgla.jar;%HYADES_HOME%\lib\hglaconfig.jar;%HYADES_HOME%\lib\hlcore.jar;%HYADES_HOME%\lib\hlevents.jar;%HYADES_HOME%\lib\hparse.jar;;%HYADES_HOME%\lib\logparsers.jar;%HYADES_HOME%\lib\xalan.jar;" org.eclipse.hyades.logging.adapter.Adapter -ac "%CONFIG_FILE%" -cc "%CONFIG_FILE%"
POPD

Nicht-Windows-Stapeldatei:

#!/bin/sh
# SYNTAX:  runregex_example.sh
# Ändern Sie die folgende Zeile, damit sie auf das Verzeichnis verweist, in dem die Laufzeit dekomprimiert wurde.
HYADES_HOME=/home/hyadesDC
export HYADES-AUSGANGSVERZEICHNIS
IHR_VERZEICHNIS=/yourdirectory
export IHR_VERZEICHNIS

KONFIGURATIONSDATEI=$HYADES-AUSGANGSVERZEICHNIS/$IHR_VERZEICHNIS/myadapter.adapter
export KONFIGURATIONSDATEI

AKTUELLES_VERZEICHNIS=`pwd`
export AKTUELLES_VERZEICHNIS

cd $HYADES-AUSGANGSVERZEICHNIS/$IHR_VERZEICHNIS

java -classpath "$HYADES_HOME\lib\glaconfigs.jar;$HYADES_HOME\lib\hexr.jar;$HYADES_HOME\lib\hgla.jar;$HYADES_HOME\lib\hglaconfig.jar;$HYADES_HOME\lib\hlcore.jar;$HYADES_HOME\lib\hlevents.jar;$HYADES_HOME\lib\hparse.jar;;$HYADES_HOME\lib\logparsers.jar;$HYADES_HOME\lib\xalan.jar;" org.eclipse.hyades.logging.adapter.Adapter -ac "$CONFIG_FILE" -cc "$CONFIG_FILE"
cd $AKTUELLES_VERZEICHNIS

Konfigurieren Sie die Datei entsprechend Ihren Anforderungen, um den Java-Prozess zu starten, der Ihren Adapter ausführt.

Anwendungsprotokoll unmittelbar überwachen

Sie können das Anwendungsprotokoll nun unmittelbar überwachen.

Stellen Sie sicher, dass die Protokollierung in den Benutzervorgaben aktiviert ist.
1. Wählen Sie in der Hauptsymbolleiste die Optionen Fenster > Benutzervorgaben aus. Der Assistent 'Benutzervorgaben' wird geöffnet.
2. Wählen Sie im linken Teilfenster Profilermittlung und Protokollierung aus. Die Benutzervorgaben für Profilermittlung und Protokollierung werden dann im rechten Teilfenster geladen.
3. Wählen Sie Protokollierung aktivieren unter den Optionen für Profilermittlung und Protokollierung aus.
4. Wählen Sie OK aus, um die Änderungen anzuwenden.
Klicken Sie in der Perspektive 'Profilermittlung und Protokollierung' das Symbol 'Profilermittlung' in der Symbolleiste an und wählen Sie Profil aus. Der Profilassistent wird geöffnet.
Wählen Sie Zuordnen - Java-Prozess aus und klicken Sie anschließend die Schaltfläche Neu am Ende der Liste an. Es wird eine neue Java-Prozesskonfiguration erstellt.
Klicken Sie die Registerkarte Hosts an und wählen Sie den Host aus, auf dem sich das Anwendungsprotokoll befindet.
Hinweis: Um das Anwendungsprotokoll unmittelbar überwachen zu können, muss die Hyades-Datenerfassungssteuerkomponente auf demselben System wie die Anwendung aktiv sein.
Klicken Sie die Registerkarte Agenten an und verwenden Sie die Pfeiltasten, um den von Ihnen konfigurierten Protokollierungsagent auszuwählen.
Klicken Sie Anwenden an.
Klicken Sie Ausführen an, um eine Zuordnung zum Protokollierungsagenten herzustellen.
Wählen Sie in der Perspektive 'Profilermittlung und Protokollierung' der Sicht 'Profilermittlung - Überwachung' den Protokollierungsagenten aus.
Klicken Sie den Agenten mit der rechten Maustaste an und wählen Sie Überwachung starten aus.
Klicken Sie den Agenten mit der rechten Maustaste an und wählen Sie Öffnen mit > Sicht 'Protokoll' aus. Die Protokollereignisse aus dem Anwendungsprotokoll werden in die Sicht 'Protokoll' geladen.

Verwandte Tasks
Protokollparser erstellen