Syslog nach RFC 5424 lesen
Die Nachricht hat eine feste Hülle
RFC 5424 beschreibt eine Syslog-Nachricht als Header, Structured Data und optionalen Nachrichtentext. Im Header stehen PRI und Version sowie TIMESTAMP, HOSTNAME, APP-NAME, PROCID und MSGID. [1] Wer Logs aus Routern, Hosts und Anwendungen einsammelt, kann damit Herkunft und Ereignisklasse unterscheiden, sofern die Sender ihre Felder verlässlich befüllen. Der freie MSG-Text ist dagegen nicht das ganze Protokoll. Ein Parser, der nur nach Wörtern im Nachrichtentext sucht, verliert wichtige Struktur.
PRI enthält Facility und Severity als codierten Zahlenwert. Die IANA-Registrierung führt Facility-Codes und die acht Severity-Stufen; niedrige Severity-Zahlen stehen für schwerere Zustände. [2] Diese Klassifikation stammt vom Sender. Ein als kritisch markierter Eintrag ist nicht automatisch kritisch für deinen Dienst, während ein harmlos etikettierter Text einen echten Fehler enthalten kann. Nutze die Felder für Sortierung und Routing, aber gleiche wichtige Alarme mit beobachteter Dienstfunktion ab.
Zeit, Identität und strukturierte Angaben
TIMESTAMP erlaubt zeitliche Zuordnung, setzt aber eine brauchbar synchronisierte Uhr voraus. HOSTNAME benennt die vom Sender angegebene Herkunft; ein Relay oder Container kann andere Namen verwenden als erwartet. APP-NAME, PROCID und MSGID sollen Programm, Prozess und Ereignisart näher kennzeichnen. Das RFC erlaubt für einzelne Headerfelder einen NILVALUE, wenn Angaben nicht verfügbar sind. Ein Bindestrich ist dann nicht gleichbedeutend mit einem echten Hostnamen oder einer Anwendung namens Minus. [1]
Structured Data besteht aus Elementen mit IDs und gegebenenfalls Parametern. Die IANA-Liste enthält registrierte IDs wie timeQuality, origin und meta. [2] Parameternamen und Werte müssen beim Parsing als Struktur behandelt werden; eine naive Trennung an jedem Leerzeichen kann zitierte Werte zerstören. Der freie MSG-Bereich kann menschlich lesbar sein, ist aber je nach Sender unterschiedlich. Logs mit sensiblen Daten brauchen Rechte und Aufbewahrungsregeln, selbst wenn ihre technische Hülle korrekt ist.
Parsing mit Gegenproben absichern
Nimm echte Beispielnachrichten von mindestens zwei Geräten und markiere jedes Headerfeld, den Structured-Data-Bereich und den freien Text. Vergleiche das Ergebnis mit dem RFC-Format, nicht nur mit einer hübschen Dashboardansicht. Teste Nachrichten mit fehlenden Angaben und mit mehreren Structured-Data-Elementen. Kontrolliere, ob die eingelesene Uhrzeit und die vom Collector vergebene Empfangszeit auseinanderlaufen; eine Differenz kann auf Uhrenfehler oder Transportverzögerung hinweisen.
Für Alarme sollte die Herkunft über stabile Felder zuordenbar bleiben, auch wenn ein Prozess neu startet. Prüfe bei einem bekannten harmlosen Ereignis, ob es dem richtigen Host und Dienst zugewiesen wird und ob der Schweregrad im Collector erhalten bleibt. Grenze der Methode: RFC-Konformität prüft die Form, nicht die Wahrheit der Senderangaben. Ein falsch konfigurierter Host kann perfekte Syntax und trotzdem irreführende Daten liefern. Ein Funktionscheck des betroffenen Dienstes bleibt deshalb eine unabhängige Quelle.
Bei gemischten Sendern lohnt ein kleines Feldinventar: Welche Geräte liefern wirklich APP-NAME und MSGID, welche schreiben dort nur Platzhalter? Eine Parseränderung sollte erst an archivierten Beispielen getestet werden. Sonst können bestehende Filter plötzlich still keine Treffer mehr liefern, obwohl die Logs weiterhin im Collector ankommen.
Weiterlesen: homelab monitoring und homelab sicherheit guide.
Lege für die Parser-Abnahme ein kontrolliertes Beispiel mit Leerzeichen in einem gequoteten Structured-Data-Wert und einem zweiten Element an. Vergleiche den erhaltenen Wert samt Escape-Zeichen in Rohmeldung und Kollektor. Scheitert die Aufteilung, bleiben Host, Empfangszeit und Originalzeile erhalten; nur das betroffene Feld darf nicht als verlässliche Suchdimension gelten. RFC 5424 spezifiziert Syntax, nicht die Qualität des Senders.
Ein RFC-5424-Parser sollte bei unbekannten Sendern nicht vermuten, der freie Nachrichtentext beginne stets an der gleichen Spaltenposition. STRUCTURED-DATA kann mehrere Elemente mit Parametern enthalten; - markiert an zulässigen Stellen fehlende Werte. Prüfe für eine Stichprobe das rohe Eingangstelegramm gegen die geparsten Felder, einschließlich Zeitstempel und empfangendem Relay. IANA registriert Kennungen und Parameter für Structured Data, belegt damit aber nicht die inhaltliche Wahrheit eines vom Sender gemeldeten Ereignisses.
Offizielle Quellen und Prüfnotizen
- [1] RFC 5424: Nachrichtenformat, Abschnitt 6 – Abschnitt 6 definiert HEADER SP STRUCTURED-DATA [SP MSG] samt sieben Headerfeldern.
- [2] IANA: syslog Parameters – IANA registriert Facility-, Severity- und Structured-Data-Kennungen.

