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. Wir bieten eine Programmierschnittstelle (API), die es Ihnen auch erlaubt eigene Klassen 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. |
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.