Überwachung von Protokolldateien mit Agenten und Alert-Monitor 
Überwachung von Protokolldateien mit Agenten und Alert-Monitor
Verwendung
Zu den Funktionen der
CCMS-Agenten gehört die Überwachung von Protokolldateien. Dieser Protokolldateiagent (Logfile-Agent) ist in alle Agenten integriert. Sie können damit beliebige Textdateien (z.B. Datenbank-Alert-Protokolle, ITS-Protokolldateien) nach beliebigen Textmustern durchsuchen lassen. Die Ergebnisse werden im Monitor
Logfile Monitoring der Monitorsammlung SAP CCMS Monitors for Optional Components ausgegeben.
Falls der Agent eine gesuchten Zeile findet, übermittelt er sie an das zentrale Monitoring-System. Dabei entscheiden Sie durch Einträge in den Konfigurationsdateien des Logfile-Agenten über die Details der Meldung:
In der Datei
SAPCCMSR.INI des CCMS-Agenten geben Sie nach dem Parameter LogFile eine Konfigurationsdatei an, die die Details zur Überwachung enthält. Sie können dabei den Parameter LogFile mehrmals verwenden und so mehr als eine Datei angeben. Pro Datei können Sie ein Suchkriterium für den Namen einer Protokolldatei (das auf mehrere Protokolldateien zutreffen kann) und verschiedene Textmuster angeben, die überwacht werden sollen.Funktionsumfang
Die Konfigurationsdatei des Logfile-Agenten enthält Informationen darüber, welche Textdatei in welcher Form analysiert werden soll:
|
Parameter |
Bedeutung |
Standardwert |
|
LOGFILE_TEMPLATE |
Schlüsselwort für den Agenten; damit wird ein Suchbereich eröffnet |
|
|
DIRECTORY= |
Verzeichnis, das die Protokolldatei enthält |
|
|
FILENAME= |
Name der Protokolldatei; Maskenzeichen (Wildcards) sind möglich |
|
|
MONITOR_NEWEST_FILES |
Anzahl der Dateien, die maximal überwacht werden; falls die Anzahl der Dateien, deren Namen die Suchbedingung erfüllt, größer ist als diese Zahl, werden die <Anzahl> Dateien überwacht, die den neuesten Änderungszeitpunkt besitzen
Damit können im Laufe der Zeit verschiedene Dateien überwacht werden. Falls eine Datei aus der Überwachung genommen wird, weil andere Dateien über ein jüngeres Änderungsdatum verfügen, werden ihr Monitorbaum gelöscht und ihre Alerts zurückgesetzt. |
20 |
|
RESCANFROMBEGIN= |
Angabe, ob bei jedem neuen Lesen die Protokolldatei von Anfang an gelesen wird ( 0) oder nur die Zeilen, die seit der letzten Leseoperation durch den Logfile-Agenten hinzugekommen sind (>0) |
0 |
|
MONITOR_FILESIZE_KB= |
Wert ³ 0: Größe der Protokolldatei in KB wird im Knoten FileSize überwachtWert > 0: wenn Dateigröße den Wert übersteigt, wird ein Alert generiertWert < 0: FileSize wird nicht angelegt. |
FileSize wird nicht angelegt |
|
PATTERN_<x>= |
Suchmuster in der Protokolldatei (zwischen Groß- und Kleinschreibung wird unterschieden; Maskenzeichen sind nicht erlaubt) |
|
|
MESSAGEID_<x>= |
Meldungsnummer, die dem Alert zugeordnet ist |
|
|
VALUE_<x>= |
Farbe des Alerts innerhalb der Monitoring-Architektur |
YELLOW |
|
SEVERITY_<x>= |
Schwere des Alerts |
0 |
|
MESSAGECLASS_<x>= |
Nachrichtenklasse |
SAP-T100 |
|
CMP_FROM_BEGIN_<x>= |
Wert= 1: die Zeile muss mit dem Suchmuster beginnen (bessere Performance)Wert= 0: das Suchmuster kann sich an beliebiger Stelle in der Zeile befinden |
0 |
|
PREFIX= |
Ergänzung vor dem MTE-Knoten; dient der Unterscheidung verschiedener Protokolldateien mit unterschiedlichen Pfaden, aber gleichen Namen |
|
|
SHOWNEWLINES=[0, 1] |
Wert= 1: Alert-Monitor legt Unterknoten Newlines an, d.h. die Anzahl der pro Minute erzeugten Zeilen wird gemeldetWert= 0: Newlines wird nicht angelegt |
0 |
|
ANALYSEMETHODE= |
Analysemethode, die dem Alert zugeordnet ist |
keine |
|
MTE_CLASS= |
MTE-Klasse, die dem Alert übergeordnet ist |
Dateiname der Protokolldatei |
Beispiel
Eine Konfigurationsdatei für einen Logfile-Agenten, welcher in maximal vier Dateien, die mit dem Präfix
errorlog beginnen, die Textmuster error und warning sucht und Funde der Monitoring-Architektur übergibt, könnte so aussehen:LOGFILE_TEMPLATE
DIRECTORY="e:\mssql70b\log"
FILENAME="errorlog*"
MONITOR_NEWEST_FILES=4
MTE_CLASS="MS-SQL"
PREFIX="MS"
SHOWNEWLINES=1
ANALYZEMETHOD=""
PATTERN_0="ERROR"
VALUE_0=RED
SEVERITY_0=50
MESSAGECLASS_0="SAP-T100"
MESSAGEID_0="rt 98"
CMP_FROM_BEGIN_0=0
PATTERN_1="WARNING"
VALUE_1=YELLOW
SEVERITY_1=20
MESSAGECLASS_1="SAP-T100"
MESSAGEID_1="rt 99"
CMP_FROM_BEGIN_1=0
.
Siehe auch:
Installation der CCMS-Agenten
