Auswahl der Dateiinhalte, die überwacht
werden
Verwendung
Sie können mit Hilfe von CCMS-Agenten Dateien überwachen lassen, so z. B. auf ihre Größe, Existenz, letztes Änderungsdatum oder ihren Inhalt. All dies legen Sie in Logfile-Templates fest – unter anderem, auf welche Dateiinhalte hin die Dateien überwacht werden sollen. Dies geschieht, indem Sie im Logfile-Template entsprechende Parameter setzen, die unten beschrieben sind.
Sie können die Inhalte beliebiger Textdateien überwachen, besonders nützlich ist die Funktion allerdings für Protokolldateien. Ihnen stehen u. a. die folgenden Funktionen zur Verfügung:
● Sie können nach Suchmustern suchen lassen (z. B. ERROR). Wenn der Logfile-Agent das Suchmuster findet, wird ein Alert generiert (dessen Eigenschaften, wie z. B. Farbe oder Gewichtung, Sie selbst im Logfile-Template festlegen können) und die entsprechende Zeile der überwachten Datei im Alert-Monitor ausgegeben.
● Sie können die Anzahl eines Suchmusters in einer Datei überwachen. Ein Alert wird dann generiert, wenn der von Ihnen gesetzte Schwellenwert für diese Anzahl überschritten wird.
● Sie können auch nach Suchmustern ohne Alert-Bewertung suchen lassen (z. B. RELEASE).
Daneben können Sie weitere Einstellungen zur Suchmethode vornehmen:
● Soll bei den Suchmustern Groß-/Kleinschreibung berücksichtigt werden?
● Soll bei jeder Überprüfung einer Datei vom vorne begonnen werden oder nur die neu hinzugekommenen Zeilen überprüft werden?
● Soll das Wachstum der Datei überwacht werden?
● Sollen alle Zeilen der Datei im Alert-Monitor angezeigt werden – oder nur diejenigen, wleche das Suchmuster enthalten?
● Sollen die Funde des Suchmusters kumuliert ausgegeben werden?
Funktionsumfang
Überwachte Suchmuster
Für jede überwachte Datei können Sie im Logfile-Template mehrere Suchmuster angeben, nach denen die Datei durchsucht werden soll. Geben Sie dafür für jedes Suchmuster eine Zahl <n> im Parametersuffix der folgenden Parameter ein. Beginnen Sie mit der Zahl 0.
Wenn ein entsprechendes Suchmuster gefunden wird, gibt das System einen Alert aus. Farbe, Gewichtung und zugeordnete Meldung dieses Alerts können Sie ebenfalls im Logfile-Template festlegen.
PATTERN_<n>="<Zeichenkette>" (PATTERN_0 ist notwendig) Hier setzen Sie das Suchmuster, nach der die Datei durchsucht werden soll; zwischen Groß- und Kleinschreibung wird standardmäßig unterschieden (siehe unten); Maskenzeichen sind nicht erlaubt. |
MESSAGEID_<n>="<Nachrichten-ID>" (Default = RT 149) Falls das o. a. Suchmuster gefunden wird, setzen Sie hier die Meldungsnummer, die dem Alert zugeordnet wird. |
VALUE_<n>=[RED,YELLOW,GREEN] (Default = YELLOW) Falls das o. a. Suchmuster gefunden wird, setzen Sie hier die Farbe des Alerts innerhalb der Monitoring-Infrastruktur. |
SEVERITY_<n>=[0...255] (Default = 0) Falls das o. a. Suchmuster gefunden wird, setzen Sie hier die Gewichtung des Alerts innerhalb der Monitoring-Infrastruktur. |
MESSAGECLASS_<n>="<Meldungsklasse>" (Default = SAP-T100) Falls das o. a. Suchmuster gefunden wird, setzen Sie hier die Nachrichtenklasse, die dem Alert zugeordnet wird. |
CMP_FROM_BEGIN_<n>=[0,1] (Default = 0) Sie können entscheiden, ob die o. a. Suchmuster nur gefunden werden sollen, wenn Sie am Beginn einer Zeile stehen (1), oder sich an beliebiger Stelle in der Zeile befinden können (0). Sie können so die Performance der Überwachung steigern, wenn Sie wissen, dass das Suchmuster immer zu Beginn der Zeile auftritt (z. B. ERROR bei vielen Protokolldateien). |
CUMULATIVE_ALERT_THRESHOLD_<n>=<Anzahl> (optional, Default: nicht gesetzt) Falls das Suchmuster in einer Datei sehr häufig vorkommt, wird standardmäßig eine entsprechende Anzahl von Alerts in der Monitoring-Infrastruktur generiert. In solchen Fällen wäre es besser, nur einen Alert zu erhalten, der den Benutzer darüber informiert, dass in einer Datei z. B. 140 Mal das Suchmuster WARNING gefunden wurde. Falls Sie diesen Parameter setzen, wird ein Performance-Attribut namens Matches for <Pattern> erzeugt. Über den Wert <Anzahl> des Parameters setzen Sie den Schwellenwert – wenn der Parameter z. B. den Wert 5 hat und das Suchmuster in der überwachten Datei mindestens fünfmal vorkommt, wird im Performance-Attribut ein Alert erzeugt, dessen Farbe vom Wert des Parameters VALUE (s. o.) abhängt. Die Zeilen der überwachten Datei werden immer noch in das Protokollattribut Lines found for pattern geschrieben, allerdings wird in diesen Knoten für dieses Suchmuster kein Alert mehr generiert.
Falls Sie CUMULATIVE_ALERT_THRESHOLD_<n>=0 setzen, werden die Anzahl der Fundstellen im Attribut Matches for <Pattern> ausgegeben, aber für den Knoten kein Alert erzeugt. |
Auszugebende Suchmuster (ohne Alert-Funktion)
Mit den o. a. Parametern können Sie Dateien auf Suchmuster überwachen, denen ein Alert zugewiesen werden soll (z. B. auf das Suchmuster Error). Um Suchmuster auszugeben, denen kein Alert zugewiesen sein soll (z. B. Versions- oder Datumsinformationen), ist diese Funktion nicht optimal. Im Alert-Monitor steht nämlich für alle überwachten Suchmuster nur ein Protokollattribut zur Verfügung, weshalb auch bei mehreren Suchmustern immer nur eine Zeile ausgegeben wird.
Sie haben daher eine zweite Möglichkeit, Dateien auf Suchmuster zu überwachen. Wenn ein solches Suchmuster gefunden wird, gibt der Alert-Monitor die entsprechende Zeile als Inhalt eines eigenen Textattributs aus. Den Name des Textattributs können Sie dabei frei wählen. Falls das Suchmuster mehrmals in der Protokolldatei vorkommt, wird die letzte Fundstelle ausgegeben.
APPL_INFO_<x>="<Zeichenkette>" (optionaler Parameter) Hier setzen Sie das Suchmuster, nach dem die Datei durchsucht werden soll; zwischen Groß- und Kleinschreibung wird standardmäßig unterschieden (siehe unten); Maskenzeichen sind nicht erlaubt. Falls das Suchmuster gefunden wird, wird im Alert-Monitor die Zeile der Protokolldatei ausgegeben, in dem das Suchmuster gefunden wurde. |
APPL_INFO_MTE_NAME_<x>="<MTE-Name>" (optionaler Parameter) Hier setzen Sie den Namen des Textattributs, in dem die Zeile ausgegeben wird; der komplette Knotenname ist INFO[<MTE-Name>]. |
Allgemeine Einstellungen zu den überwachten Protokolldateien
Neben den Suchmustern selbst können Sie in den folgenden Parametern allgemeine Einstellungen zur Suche festlegen.
IGNORE_CASE=[0,1] (Default: 0) Standardmäßig wird bei allen Suchmustern die Groß- und Kleinschreibung (0) beachtet. Falls bei der Suche Groß- und Kleinschreibung ignoriert werden soll, setzen Sie IGNORE_CASE=1. |
RESCANFROMBEGIN=[0,1] (Default: 0) Hier bestimmen Sie, ob bei jeder Überprüfung einer Datei durch den Logfile-Agenten am Anfang der Datei begonnen werden soll (1), oder nur die neu hinzugekommenen Zeilen überprüft werden (0). Bei den meisten Protokolldateien werden neue Zeilen einfach an die vorhandene Datei angehängt. Hier wäre es falsch, RESCANFROMBEGIN=1 zu setzen, da dann dasselbe vorhandene Suchmuster (z. B. ERROR) bei jedem Lesen der Datei durch den Logfile-Agenten einen erneuten Alert auslösen würde. |
SHOWNEWLINES=[0,1] (Default: 0) Hier bestimmen Sie, ob das Wachtstum der Datei überwacht werden soll: ○ Wert=1: Der Alert-Monitor legt den Unterknoten Newlines an, d. h. die Anzahl der pro Minute erzeugten Zeilen wird gemeldet. ○ Wert=0: Newlines wird nicht angelegt. |
REPORT_MATCHING_LINES_ONLY=[0,1] (Default: 0) Standardmäßig werden alle Zeilen der überwachten Datei in das Protokollattribut Lines found for pattern gemeldet – auch dann, wenn in der entsprechenden Zeile keine der Suchmuster enthalten ist . Falls Sie den Parameter setzen, werden nur noch die Zeilen in das Shared Memory des Agenten übernommen, die die entsprechenden Suchmuster enthalten.
Falls Sie diesen Parameter setzen und in den Eigenschaften des Protokollattributs für die Einstellung Anzeige "aktueller Wert" wie der Wert letzte eingegangene Meldung aktiv ist, wird im Alert-Monitor in der Sicht Aktueller Zustand in dem Protokollattribut immer die letzte Trefferzeile anzeigt. |
Aktivitäten
Falls Sie die Dateiüberwachung mit CCMS-Agenten verwenden möchten, erstellen Sie ein oder mehrere Logfile-Templates. Geben Sie in der Konfigurationsdatei der CCMS-Agenten SAPCCMSR.INI diese Logfile-Templates an.
Falls Sie ein Logfile-Template erstellen, beachten Sie auch die Information in Aufbau der Logfile-Templates, wo Sie eine kurze Zusammenfassung aller möglichen Parameter finden. Weitere Parameter der Logfile-Templates werden in den folgenden Abschnitten thematisch geordnet beschrieben:
● Auswahl der Dateien, die überwacht werden
● Auswahl der allgemeinen Dateieigenschaften, die überwacht werden
● Auswahl der Zeiträume für die Dateiüberwachung
● Festlegung der Knoteneigenschaften bei der Dateiüberwachung
Beispiel
Siehe Beispiele für Logfile-Templates
Startseite
CCMS-Agenten, Überwachung von
Dateien mit CCMS-Agenten