Schaltflächen im Log

Im agorum core support tool erscheinen auf den Overview-Seiten, etwa, wenn Sie die Funktionsbereiche Sub Statistics oder Base System öffnen, die Schaltflächen:

• Show Log
• Configure Log
• Log Actions

Show Log

---

Öffnet ein neues Fenster, in dem Sie Logs des gewählten Funktionsbereichs einsehen können.

Die Logs füllen sich, sobald ein Java-Prozess aktiv ist und Ausgaben erzeugt.

Filteroptionen

Filteroption	Beschreibung
From	Definiert das Startdatum.
To	Definiert das Enddatum.
Minimum Log Level	Definiert das niedrigste Log-Level, das erscheint.
Maximum Log Level	Definiert das maximale Log-Level, das erscheint.
Search regex	Filtert die angezeigten Logs nach dem eingegebenen Muster.
Exclude regex	Schließt Logs mit dem eingegebenen Muster aus.
Tail	Achtung: Beeinträchtigung der Systemleistung durch Aktivierung dieser Filteroption. Das System arbeitet nach Aktivierung dieser Filteroption nur noch langsam. Deaktivieren Sie diese Filteroption zügig, nachdem Sie sie verwendet haben. Bietet eine Echtzeit-Ansicht des Logs. Bei gesetztem Haken aktualisieren sich die Einträge in der Ergebnisliste in Echtzeit.

Spalte „Severity“

Die Spalte Severity in der Ergebnisliste kann diverse Informationsgrade aufweisen:

Informationsgrad	Beschreibung
Debug	Bietet etwa bei Konfigurationen eine Unterstützung. Das System gibt jegliche Informationen aus, unabhängig von deren Wichtigkeit. Diese Meldung ist im Standard deaktiviert, weil sie zulasten der Systemleistung geht und große Logfiles produziert. Unter der Schaltfläche Configure Log können Sie diese diesen Informationsgrad aktivieren.
Info	Allgemeines informatives Log
Warnings	Das System warnt vor Schwierigkeiten.
Errors	Im System sind Fehler vorhanden. Beheben Sie diese selbst, oder eröffnen Sie einen Supportfall.

Configure Log

---

Diese Schaltfläche zeigt verschiedene Severity-Level an. Sie definieren hier, welche Logs Sie sehen.

Zur Auswahl stehen:

• Debug
• Info
• Warnings
• Errors

Log Actions

---

Mit dieser Schaltfläche konfigurieren Sie die Logeinträge aus Show Log. Klicken Sie auf Add, öffnet sich folgender Dialog:

• Tragen Sie im Feld Pattern einen RegEx-Ausdruck ein, um die zu beobachtenden Logs einzugrenzen.
• Wählen Sie einen Aktionstypen (siehe Action types), um zu definieren, was mit den zu überwachenden Logs geschieht.
• Hinterlegen Sie weitere Angaben je nach Aktionstyp.

Option „Stop“

Sie können weitere Konfigurationen erstellen, sodass eventuell mehrere definierte Aktionen auf mehrere Logs zutreffen.

Durch die Option Stop unterdrücken Sie Aktionen für bestimmte Logs. Definieren Sie etwa die Aktionen SEND-MAIL und CREATE_STICKY, erhalten Sie zum einen E-Mails, zum anderen zeigt das System die Logs im Bereich Active Notifications an.

Bestätigen Sie die Option Stop mit der Aktion SEND-MAIL, verarbeitet das System einen passenden Log-Eintrag für SEND_MAIL. Diese Bearbeitung registriert das System und stellt dann fest, dass derselbe Log-Eintrag auch zum RegEx Ausdruck der Aktion CREATE_STICKY passt. Aufgrund des Stopps wird dieses Log allerdings nicht mehr von der Aktion CREATE_STICKY bearbeitet.

RegEx-Ausdruck ermitteln

Testen Sie Ihre erstellten Konfigurationen, bevor Sie sie produktiv verwenden.

Der gesetzte RegEx greift nicht nur für die angegebene Message, das System geht auch die unter Details liegenden Log-Informationen durch.

1. Klicken Sie auf Show Log, um die aktuelle Log-Ansicht zu erhalten.
   
   Eventuell müssen Sie die Severity-Level ihres Logs mit der Schaltfläche Configure Log konfigurieren, sodass die Meldungen erscheinen.
2. Tragen Sie Ihren RegEx-Ausdruck im Feld Search regex ein.
3. Korrigieren Sie den RegEx-Ausdruck so oft, bis die gewünschten Log-Einträge gefiltert erscheinen.
4. Kopieren Sie den ermittelten RegEx-Ausdruck in eine Aktion der Schaltfläche Log Actions.

Action types

---

ADD_USER_TAG

Mit diesem Aktionstyp gestalten Sie Logs verständlich oder machen sie auffindbar. Tragen Sie dazu einen Tag ein. Das System zeigt diesen wie ein Präfix vor dem gewünschten Log-Muster an.

Beispiel

Wichtige Meldung <Log>

CHANGE_LOG_LEVEL

Mit diesem Aktionstyp ändern Sie den Severity-Wert einer eigenen Konfiguration, etwa wenn Sie feststellen, dass ein Log zwar als Info ausgegeben wird, aber bereits eine Warnung darstellt.

Schreiben Sie die Severity-Stufen in Großbuchstaben:

• DEBUG
• INFO
• WARNINGS
• ERRORS

CREATE_COUNTER

Mit diesem Aktionstyp werten Sie aus, wie oft ein Log erscheint. Dazu geben Sie anhand eines RegEx-Ausdrucks die relevanten Logs ein. Sobald das System diesen Log-Eintrag mit dem entsprechenden Muster findet, erstellt es automatisch einen Zähler, der die Häufigkeit des Auftretens des Logs protokolliert. Dieser Zähler trägt als Bezeichnung das eingegebene Muster.

CREATE_STICKY

Mit diesem Aktionstyp überwachen Sie bestimmte Logs oder lassen sich Logs im Bereich Active Notifications anzeigen.

DISMISS

Mit diesem Aktionstyp verwerfen Sie Log-Einträge, die dem eingegebenen RegEx-Ausdruck entsprechen. Das System schreibt sie nicht in die Log-Datei.

Verwenden Sie zusätzlich die Log-Aktion CREATE_COUNTER für denselben Regex-Ausdruck. Sie erhalten eine Statistik, wie viele dieser Logs aufgetreten sind, ohne Speicherplatz zu verbrauchen.

SEND_MAIL

Mit diesem Aktionstyp erhalten Sie eine E-Mail mit entsprechenden Log-Einträgen. Voraussetzung ist, dass Sie den agorum core mailserver verwenden.

1. Tragen Sie die Empfänger-E-Mail-Adresse ein.
2. Setzen Sie ein zeitliches Intervall der Überprüfung.
3. Geben Sie im Feld Max count die Anzahl der maximalen Log-Einträge an.
   
   Der Wert 0 deaktiviert die Option nicht. Stattdessen erhalten Sie eine E-Mail mit der Information, dass ein Eintrag vorhanden ist. Das Log selbst wird nicht angezeigt.

Beispiel einer Log Action

---

Haben Sie einen eigenen Worker im agorum core support tool konfiguriert, der nicht wie gewünscht funktioniert, klicken Sie auf die Schaltfläche Show Log, damit Fehler erscheinen (hier etwa Error while oder Cannot parse):

Das System soll diese Fehler beim nächsten Mal abfangen, damit Sie nicht für jeden Test die Schaltfläche Show Log anklicken müssen. Stattdessen sollen die Fehlermeldungen im Bereich Active Notifications erscheinen. Sie benötigen dazu zweimal den Aktionstyp CREATE_STICKY.

1. Klicken Sie auf Log Actions.
2. Wählen Sie die Option Add.
3. Tragen Sie im Feld Pattern Ihren ersten RegEx-Ausdruck ein:
   
   CREATE_STICKY 1​​​​​​

   RegEx: Error while
   

   
   CREATE_STICKY 2​​​​​​

   Pattern: Cannot parse
   

   Die Fehlermeldung Cannot parse erscheint innerhalb der eigentlichen Fehlermeldung der Kundenakte (siehe Spalte Sub System). Um die eigentliche Fehlermeldung zu lesen, klicken Sie auf Details.
4. Wählen Sie den Action type CREATE_STICKY.
5. Schließen Sie mit einem Klick auf Add die erste Konfiguration ab.
6. Wiederholen Sie die Schritte für den zweiten Aktionstyp CREATE_STICKY mit dem Unterschied, dass Sie den zweiten RegEx-Ausdruck übernehmen.

Die dem RegEx entsprechenden Logs zeigt das System jetzt im Bereich Active Notifications: