LogService
Über den LogService haben Applikationen die Möglichkeit, Logmeldungen über einen standardisierten Weg in das System zu bringen.
Hierbei übernehmen LogManager die Art und Weise, wie Logmeldungen verarbeitet werden sollen. Folgende Manager stehen derzeit zur Verfügung.
|
Eingehende Logmeldungen werden ignoriert. Dieser Manager kann verwendet werden, um zu verhindern, dass der LogService Meldungen auf der Standardausgabe ausgibt, wenn kein einziger Manager gesetzt wird. Dieses Vorgehen macht beispielsweise bei automatisierten Testszenarien Sinn. |
|
|
Dateibasierter Logmanager. Dies ist der üblicherweise verwendete Manager. |
|
|
Dieser LogManager verschickt Logmeldungen per E-Mail. Logmeldungen werden hierbei bis zu einer gesetzten Maximalgröße gesammelt und per E-Mail an eine bestimmte Adresse versandt. |
|
|
Meldungen werden auf den Standardausgabeströmen STDOUT und STDERR ausgegeben. |
|
|
Manager für die Anbindung externer Loggingframeworks wie z. B. log4j. |
Weitere LogManager mit anderen Arten der Ausgabe können selbst entwickelt und dem LogService für das Ausgeben von Meldungen gegeben werden. Lobster_data bietet eine Programmierschnittstelle (API), die es Ihnen auch erlaubt eigene Komponenten in Java zu entwickeln. Hierzu bieten wir eine vertiefte Schulung an. Bei Interesse wenden Sie sich bitte an unsere Mitarbeiter im Support bzw. im Vertrieb.
XML-Konfiguration
Wichtiger Hinweis: Die Verfügbarkeit eines Services hängt von der erworbenen Lizenz ab und davon, ob der Service innerhalb der Konfigurationsdatei ./etc/factory.xml der Service-Factory eingetragen wurde (Änderungen erfordern Server-Neustart!). Dort finden Sie auch die zuständige Konfigurationsdatei für einen Service, ansonsten können Sie die Konfigurationsdatei des Services auch direkt in der GUI des Services bearbeiten (Änderungen erfordern Service-Neustart!).
Grundkonfiguration durch Nutzung der XML-Datei
Folgendes XML-Fragment mit allen möglichen Basiseinstellungen kann für die Konfiguration des LogServices verwendet werden.
<Set name="debugLevel">3</Set><Set name="defaultManager">internal</Set>Die einzelnen Parameter haben dabei die folgende Bedeutung.
|
Parameter |
Bedeutung |
|
debugLevel |
Das zu verwendende Loglevel. Siehe unten. |
|
defaultManager |
Der standardmäßig zu verwendende LogManager, wenn kein expliziter LogManager angegeben wurde. |
Loglevel
|
Wert |
Bedeutung |
|
0 |
Production. Dies ist das niedrigste Level und erzeugt die wenigsten Einträge. |
|
1 |
Low. |
|
2 |
Medium. Dies ist das Standardlevel bei Auslieferung des Integration Servers. |
|
3 |
High. |
|
4 |
All. Dies ist das Loglevel, der die meisten Einträge verursacht. |
Setzen der Parameter für das Senden von SNMP-Einträgen
Folgendes XML-Fragment setzt die notwendigen Werte für das Senden von SNMP-Einträgen an SNMP-Systeme.
<Call name="setSnmpParams"> <Arg>hostname.domain</Arg> <Arg type="int">port</Arg> <Arg>username</Arg> <Arg>password</Arg> <Arg>enterprise-oid</Arg> <Arg>trap-oid</Arg> <Arg>timeKey</Arg></Call>Dabei haben die einzelnen Parameter die folgende Bedeutung.
|
Parameter |
Bedeutung |
|
hostname.domain |
Der Hostname des SNMP-Servers. |
|
port |
Der Port, auf dem der SNMP-Server kontaktiert werden soll. |
|
username |
Der Benutzername, der für die Authentifizierung am SNMP-Server verwendet werden soll. |
|
password |
Das Passwort, das für die Authentifizierung am SNMP-Server verwendet werden soll. |
|
enterprise-oid |
Die zu verwendende Enterprise-OID, unter der die Trap-OID und andere Informationen gehängt werden sollen. |
|
trap-oid |
Die Trap-OID, unter der die weiteren Elemente, wie die zu sendende Meldung gehängt werden sollen. |
|
timeKey |
Der zu verwendende Schlüssel, unter dem die Zeit des Logeintrags abgespeichert werden soll. |
Hinzufügen eines LogManagers in der Konfigurationsdatei
Folgendes XML-Fragment fügt dem LogService einen LogManager hinzu.
<Call name="addManager"> <Arg>name</Arg> <Arg> <New class="Klassenname des zu verwendenden LogManagers]"> </New> </Arg></Call>Dabei ist der erste Parameter, der zu verwendende Name, unter dem der Manager dem LogService bekannt sein soll. Der zweite Parameter ist die instantiierte Klasse des zu verwendenden LogManagers.
Je nach verwendetem LogManager kann es möglich sein, dass dieser weitere Konfigurationsschritte nötig macht.
Allgemeine Einstellungen in der GUI
(1) Hier kann das Loglevel gesetzt werden.
(2) Liste der vorhandenen LogManager. LogManager können über das Kontextmenü gestartet, gestoppt, entfernt und hinzugefügt werden.
(3) Der ausgewählte Standard-LogManager wird für Meldungen ohne Angabe eines LogManagers verwendet.
(4) Gibt an, ob das Senden von SNMP-Einträgen an SNMP-Systeme aktiviert ist.
Hinzufügen eines neuen LogManagers in der GUI
In der Liste der LogManager kann über das Kontextmenü ein neuer LogManager hinzugefügt werden.
(1) Name des LogManagers.
(2) Typ des LogManagers wie oben beschrieben.