Protokoll-Schlüsselwort
Durchsuche Protokolldateien unter Windows, Linux und macOS nach Schlüsselwörtern und lass dich bei neuen Treffern seit dem letzten Lauf alarmieren.
Der Check Protokoll-Schlüsselwort durchsucht Textdateien wie Anwendungsprotokolle nach Schlüsselwörtern. Er meldet nur Zeilen, die seit dem letzten Lauf neu geschrieben wurden; bereits vorhandener Inhalt löst beim Einrichten keinen Alarm aus. Der Check läuft unter Windows, Linux und macOS (jeweils als x64- und Arm64-Build), standardmäßig alle 5 Minuten. Für das Windows-Ereignisprotokoll nutze stattdessen den Check Ereignisprotokoll, für journald bzw. Unified Logging den Check Systemprotokoll.
Voraussetzungen
- Du benötigst die Berechtigung Monitoring-Check-Verwaltung.
- Das Zielgerät hat einen verbundenen octoja-Agent unter Windows, Linux oder macOS.
- Der Agent darf die Protokolldateien lesen.
Schritte
- Öffne das Gerät unter Geräte und wechsle zum Tab Checks.
- Klicke auf Check hinzufügen → Protokoll-Schlüsselwort.
- Trage unter Protokolldateien mindestens einen absoluten Pfad oder ein Muster ein, zum Beispiel
/var/log/app/*.logoderC:\Logs\app-*.log. - Trage unter Schlüsselwörter die Begriffe ein, die einen Treffer auslösen sollen, zum Beispiel
ERRORoderException. - Passe die übrigen Einstellungen bei Bedarf an.
- Klicke auf Check hinzufügen.
Der erste Lauf legt nur die Basislinie fest und meldet OK. Treffer meldet der Check ab dem nächsten Lauf. Für viele Geräte gleichzeitig nimmst du den Check in ein Konfigurationspaket auf, siehe Checks mit Konfigurationspaketen zuweisen.
Einstellungen
Schlüsselwörter werden als Teilstring gesucht, nicht als reguläre Ausdrücke. Leere Einträge und Leerzeichen am Anfang oder Ende ignoriert der Check. Passen mehrere Schlüsselwörter auf eine Zeile, zählt sie als ein Treffer.
Änderst du Protokolldateien, Scanmodus, Schlüsselwörter, Ignorierte Schlüsselwörter, Groß-/Kleinschreibung ignorieren oder Kodierung, beginnt der Check mit einer neuen Basislinie. Zeilen, die zwischen dem letzten Lauf und der Änderung geschrieben wurden, meldet er dann nicht mehr.
Ergebnisse
Das Ergebnis zeigt die Anzahl geprüfter und geänderter Dateien sowie jeden Treffer mit Dateipfad und Zeilentext. Der Zeilentext wird nach 300 Zeichen abgeschnitten. Erreicht ein Lauf Maximale Treffer, beendet der Check die Suche für diesen Lauf und kennzeichnet die Liste als gekürzt.
So erkennt der Check neue Zeilen
- Neue Dateien: Eine Datei, die der Check zum ersten Mal sieht, nimmt er nur in die Basislinie auf. Ihr vorhandener Inhalt wird nie gemeldet, auch nicht bei einer neu angelegten Datei, die ein Muster später findet. Erst danach angehängte Zeilen können Treffer auslösen.
- Unvollständige Zeilen: Eine Zeile ohne Zeilenende wertet der Check erst aus, wenn sie vollständig geschrieben ist.
- Rotation: Ist eine Datei kürzer geworden oder haben sich ihre ersten Bytes geändert, gilt sie als rotiert oder ersetzt. Der Check durchsucht sie dann von Anfang an.
- Große Zuwächse: Pro Datei und Lauf liest der Check höchstens etwa 64 MB. Den Rest liest er beim nächsten Lauf.
- Gesamte Datei bei Änderung: Ändert sich der Inhalt, durchsucht der Check die ganze Datei und meldet dabei auch ältere passende Zeilen erneut. Unveränderte Dateien überspringt er.
FAQ
Warum meldet der Check nach dem Einrichten keine Treffer, obwohl die Datei passende Zeilen enthält?
Warum meldet der Check nach dem Einrichten keine Treffer, obwohl die Datei passende Zeilen enthält?
Der erste Lauf setzt nur die Basislinie, damit alte Einträge keinen Alarm auslösen. Der Check meldet nur Zeilen, die danach geschrieben werden. Dasselbe gilt nach einer Änderung von Pfaden, Scanmodus, Schlüsselwörtern, ignorierten Schlüsselwörtern, Groß-/Kleinschreibung oder Kodierung.
Wann ist der Check nach einem Treffer wieder in Ordnung?
Wann ist der Check nach einem Treffer wieder in Ordnung?
Jeder Lauf bewertet nur die seit dem vorherigen Lauf neuen Zeilen. Kommen keine neuen Treffer hinzu, meldet der nächste Lauf wieder OK. Im Modus Gesamte Datei bei Änderung meldet der Check bei jeder Änderung der Datei alle passenden Zeilen erneut.
Siehe auch: Alarmierung für einen Check einrichten
War dies hilfreich?
Mehr in Betriebssystem & Dienste
AbsturzerkennungAngemeldeter BenutzerAusstehender NeustartCPU-AuslastungBrauchen Sie noch Hilfe? Team fragen