Automatische Parser-Zuordnung für neue Logquellen in SecureVisio
28.10.2026
Automatische Parser-Zuordnung für eine neue Quelle
Der Mechanismus zur automatischen Parser-Zuordnung dient dazu, den richtigen Parser für eine neu hinzugefügte Log-Quelle zu ermitteln. Das System sammelt eine Stichprobe von Frames aus der neuen Quelle, führt die verfügbaren Parser mit dieser Stichprobe aus und vergleicht anschließend die Parsing-Wirksamkeit. Ausgewählt wird der Parser, der die größte Anzahl von Feldern in der größtmöglichen Anzahl von Frames parst.
Quellen, für die der Parser automatisch ausgewählt wurde, werden mit einer Kennzeichnung für die automatische Zuordnung markiert. Dadurch lässt sich eine vom System vorgenommene Konfiguration von einer manuell durch den Benutzer festgelegten Konfiguration unterscheiden.
Funktionsumfang ab SV 6.0
Ab SV 6.0 wird die Parser-Erkennung in dem Prozess ausgeführt, der für das Parsen von Frames zuständig ist – in der Regel auf dem Forwarder. Auf XDR-Systemen wird diese Funktion nicht ausgeführt, da XDR-Geräte vor dem Start als vollständig konfiguriert gelten.
- Der Mechanismus gilt nur für neu hinzugefügte Geräte und höchstens für 3 Stunden ab dem Zeitpunkt des Hinzufügens.
- Die Erkennungsparameter werden von allen Log-Quellen gemeinsam verwendet.
- Das System verwendet einen gemeinsamen Mechanismus zur Parser-Erkennung und -Zuordnung für alle Quellen.
- Der Algorithmus läuft im Hintergrund in einem einzelnen Thread, damit die Parsing-Leistung nicht beeinträchtigt wird.
- Die Quellen werden in eine Warteschlange gestellt. Nach Abschluss der Erkennung für die erste Quelle beginnt das System mit dem Sammeln von Logs für die nächste.
- Wenn die ersten 100 Frames fehlerhaft geparst werden, wird der Parser verworfen, um die Analysezeit zu verkürzen.
Erkennungsparameter
Die folgende Tabelle beschreibt die bei der Parser-Erkennung verwendeten Parameter. Mindestgrenzen bestimmen, wann die Analyse nach Ablauf einer definierten Zeit beginnen darf; Höchstgrenzen erzwingen den Start des Erkennungsprozesses, sobald eine ausreichende Datenmenge gesammelt wurde.
| Parameter | Beschreibung | Standardwert |
| MinMemorySize | Mindestanzahl an Bytes, die für die Erkennung erforderlich ist. | 50 kB |
| MaxMemorySize | Maximal erforderliche Datenmenge, die im Speicher gesammelt wird. Sobald dieser Grenzwert erreicht ist, startet die Erkennung. | 1 MB |
| MinPackageCount | Mindestanzahl an Paketen, die erforderlich ist, um die Erkennung nach Ablauf von AllowMinimalLevelOverTime zu starten. | 50 |
| MaxPackageCount | Maximal erforderliche Anzahl an Paketen. Sobald dieser Grenzwert erreicht ist, startet die Erkennung. | 1000 |
| AllowMinimalLevelOverTime | Zeit, nach der der Parser auch dann erkannt wird, wenn die Höchstgrenzen nicht erreicht wurden, sofern mindestens eine Mindestdatenmenge erreicht wurde. | 60 Minuten |
| AllowErrorPercent | Zulässiger Prozentsatz fehlgeschlagener Parsing-Versuche. | 10% |
Daten für das Parsing sammeln
Eingabedaten können dem System in zwei Modellen zugeführt werden. Daher verwendet der Mechanismus zwei Arten von Indikatoren: die Anzahl der Pakete und die im Speicher gehaltene Datenmenge.
- UDP – natürliche Frame-Aufteilung: Ein Paket entspricht einem Frame. In diesem Modell werden die Parameter MinPackageCount und MaxPackageCount verwendet.
- Stream – gilt für TCP, Readers und andere streambasierte Quellen. In diesem Modell können alle Daten in einem einzigen Paket eintreffen; daher werden die Parameter MinMemorySize und MaxMemorySize verwendet.
Sobald eine der Höchstgrenzen – MaxMemorySize oder MaxPackageCount – erreicht wird, startet der Erkennungsprozess. Je nach Datenmenge und Anzahl der verfügbaren Parser kann der Vorgang mehrere Minuten dauern.
Wenn nach Ablauf von AllowMinimalLevelOverTime mindestens eine Mindestdatenmenge – MinMemorySize oder MinPackageCount – erreicht wurde, wird die Erkennung ebenfalls gestartet. Die maximal zulässige Zeit zum Erreichen des Mindestniveaus beträgt 3 Stunden.
Algorithmus zur Parser-Zuordnung
Die Parser-Zuordnung umfasst sowohl den Parser als auch die Gerätecodierung. Sind die Felder VendorName und VendorProduct in den geparsten Daten vorhanden, verwendet das System deren erstes Vorkommen aus dem am besten passenden Parser, um den Gerätenamen festzulegen.
Der vereinfachte Ablauf des Mechanismus ist wie folgt:
- Das System sammelt eine Datenstichprobe aus der neuen Log-Quelle.
- Jeder verfügbare Parser versucht, die gesammelten Frames zu parsen.
- Die Ergebnisse werden anhand der Anzahl geparster Felder, der Anzahl korrekt geparster Frames und der zulässigen Fehlerquote verglichen.
- Der Parser mit der höchsten Wirksamkeit wird als Parser der Quelle ausgewählt.
- Nach der Parser-Zuordnung sendet das System einen Informations-Frame an das Gerät.
Informations-Frame nach der Parser-Zuordnung
Nach der Zuordnung des Parsers erzeugt das System einen Informations-Frame, der bestätigt, dass für die Log-Quelle ein neuer Parser erkannt wurde. Ein Beispiel der geparsten Felder ist unten dargestellt.

Beispiel eines nach der Parser-Zuordnung erzeugten Informations-Frames
Die Struktur des Informations-Frames umfasst einen Header und eine Reihe geparster Felder. Die in der Tabelle gezeigten Werte sind Beispiele, sofern in der Beschreibung nicht angegeben ist, dass es sich um einen systeminternen Wert handelt.
Die Struktur des Informations-Frames umfasst einen Header und eine Reihe geparster Felder. Die in der Tabelle gezeigten Werte sind Beispiele, sofern in der Beschreibung nicht angegeben ist, dass es sich um einen systeminternen Wert handelt.
| Struktur des Informations-Frames | ||
| Header | ||
| Event-Feld | Wert | Beschreibung |
| FrameAddDate | 2024.03.22 12:14:18 | Datum und Uhrzeit der Frame-Erstellung |
| FrameDeviceId | 4030 | Kennung des neu hinzugefügten Geräts, also der neuen Log-Quelle |
| FrameId | 00005000060007344EAB | Frame-Kennung |
| FrameStatus | parsed | Parsing-Status des Frames; immer gleich parsed |
| FrameStatusId | 1 | Kennung des Parsing-Status; 1 – parsed |
| Geparste Felder | ||
| Event-Feld | Wert | Beschreibung |
| ClassAction | detect | Systeminterner Wert |
| ClassCategory | new | Systeminterner Wert |
| ClassObject | object | Systeminterner Wert |
| ClassProduct | application or value from the frame | Wert aus demselben Frame wie VendorName und VendorProduct. Kann der Wert nicht aus dem Frame ermittelt werden, wird application gesetzt. |
| ClassResult | success | Systeminterner Wert |
| ClassType | info | Systeminterner Wert |
| EventDescription | Matched parser ‘PaloAlto’ | Information zum Namen des zugeordneten Parsers: Matched parser ‘{parserInfo.ParserName}’ |
| EventName | New log source | Systeminterner Wert |
| Message | New parser ‘PaloAlto’ was added to 172.0.0.1 VendorName: ‘Palo Alto Networks’ VendorProduct: ‘PanOS’ | Information zum Namen des zugeordneten Parsers und zur Quell-IP-Adresse: New parser ‘{parserInfo.ParserName}’ was added to ‘{device.Source}’ VendorName: ‘{parserInfo.VendorName}’ VendorProduct: ‘{parserInfo.VendorProduct}’ |
| SrcIp | 172.0.0.1 | IP-Adresse entsprechend dem Quellentyp: bei einem Listener die IP-Adresse der sendenden Quelle; bei einem SIEM-Connector die im Source-Feld angegebene IP-Adresse ohne Portnummer; bei XDR die IP-Adresse des Geräts, auf dem XDR ausgeführt wird. |
| VendorName | Esecure | Herstellername Esecure; systeminterner Wert |
| VendorProduct | SecureVisio | Produktname SecureVisio; systeminterner Wert |
Erkannte Daten auf dem Gerät festlegen
| Erkannte Daten werden nur dann auf dem Gerät gesetzt, wenn der Benutzer sie nicht zuvor konfiguriert hat. Nach Anwendung der erkannten Daten wird das Gerät automatisch aktiviert und beginnt, die eingehenden Daten korrekt zu parsen. |
Diagnose des Mechanismus
Der Logger Esecure.Siwb.DataAccess.SysLog.ParserDetection kann auf die Stufe DEBUG gesetzt werden, um den Parser-Erkennungsprozess zu analysieren.
| <logger name=”Esecure.Siwb.DataAccess.SysLog.ParserDetection”> <level value=”DEBUG” /> </logger> |

Beispiel für Diagnose-Logs des Parser-Zuordnungsmechanismus
Copyright © 2026 Esecure sp. z o.o. Alle Rechte vorbehalten. Die in diesem Dokument enthaltenen Informationen sind auf dem Stand des auf der Titelseite angegebenen Datums. Esecure sp. z o.o. behält sich das Recht vor, diese Publikation ohne vorherige Ankündigung zu ändern, anzupassen oder zu aktualisieren.
Inhaltsverzeichnis