Zurück
Automatische Parser-Zuordnung für neue Logquellen in SecureVisio

Automatische Parser-Zuordnung für neue Logquellen in SecureVisio

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.

ParameterBeschreibungStandardwert
MinMemorySizeMindestanzahl an Bytes, die für die Erkennung erforderlich ist.50 kB
MaxMemorySizeMaximal erforderliche Datenmenge, die im Speicher gesammelt wird. Sobald dieser Grenzwert erreicht ist, startet die Erkennung.1 MB
MinPackageCountMindestanzahl an Paketen, die erforderlich ist, um die Erkennung nach Ablauf von AllowMinimalLevelOverTime zu starten.50
MaxPackageCountMaximal erforderliche Anzahl an Paketen. Sobald dieser Grenzwert erreicht ist, startet die Erkennung.1000
AllowMinimalLevelOverTimeZeit, nach der der Parser auch dann erkannt wird, wenn die Höchstgrenzen nicht erreicht wurden, sofern mindestens eine Mindestdatenmenge erreicht wurde.60 Minuten
AllowErrorPercentZulä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-FeldWertBeschreibung
FrameAddDate2024.03.22 12:14:18Datum und Uhrzeit der Frame-Erstellung
FrameDeviceId4030Kennung des neu hinzugefügten Geräts, also der neuen Log-Quelle
FrameId00005000060007344EABFrame-Kennung
FrameStatusparsedParsing-Status des Frames; immer gleich parsed
FrameStatusId1Kennung des Parsing-Status; 1 – parsed
Geparste Felder
Event-FeldWertBeschreibung
ClassActiondetectSysteminterner Wert
ClassCategorynewSysteminterner Wert
ClassObjectobjectSysteminterner Wert
ClassProductapplication or value from the frameWert aus demselben Frame wie VendorName und VendorProduct. Kann der Wert nicht aus dem Frame ermittelt werden, wird application gesetzt.
ClassResultsuccessSysteminterner Wert
ClassTypeinfoSysteminterner Wert
EventDescriptionMatched parser ‘PaloAlto’Information zum Namen des zugeordneten Parsers: Matched parser ‘{parserInfo.ParserName}’
EventNameNew log sourceSysteminterner Wert
MessageNew 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}’
SrcIp172.0.0.1IP-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.
VendorNameEsecureHerstellername Esecure; systeminterner Wert
VendorProductSecureVisioProduktname 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


Bitte kontaktieren Sie uns, falls Sie Fragen haben.

Erfahren Sie mehr über SecureVisio und die Vorteile, die es bietet.
Deutschland
Deutschland
+49 4186‑895991‑0
Polen
Polen
+48 17 779 6246

Füllen Sie das Formular aus, um uns zu kontaktieren.