Sie können die Standardwerte der Agent-Konfigurationsdatei mit allgemeinen Parameterwerten, die in jedem Agent-Konfigurationsabschnitt für Windows- und Linux-Agenten angewendet werden, überschreiben.

Allgemeine Optionen

Optionen, die im Abschnitt [common|global] der Konfigurationsdatei liagent.ini angegeben sind, werden an alle Abschnitte weitergegeben. Optionen, die im Abschnitt [common|filelog] angegeben sind, werden an alle Filelog-Abschnitte weitergegeben und [common|winlog]-Optionen werden an alle Winlog-Abschnitte weitergegeben.

Sie können die Parameter tags, include, exclude, event_marker, charset, exclude_fields und parser in allgemeinen Abschnitten, wie in folgendem Beispiel gezeigt, definieren: Das Beispiel bezieht sich auf einen Windows-Agenten: 

[common|global]

tags = {"log_source_vm":"win-2008r2-64"}
exclude_fields = test_tag;some_other_tag
parser = auto

[common|filelog]
tags = {"collector_type":"filelog"}
exclude = *.trc

[filelog|channel_1]
directory = C:\app\log
include = *.log

...
In diesem Beispiel wird folgendes Verhalten aufzeigt:
  • Alle Protokolle der Filelog-Abschnitte enthalten die Tags log_source_vm und collector_type mit ihren entsprechenden Werten.
  • Die Tags test_tag und some_other_tag sind aus allen gesendeten Protokollen ausgeschlossen.
  • Der Parser auto wird auf alle erfassten Protokolle angewendet.
  • Standardmäßig sind bei allen Filelog-Collectors *.trc-Dateien aus der Überwachung ausgeschlossen.
Optionen im Abschnitt [common|global] werden ebenfalls auf alle Winlog-Abschnitte angewendet.

Zusammenführen und Überschreiben von Kriterien

Wenn Optionen in mehr als einem Abschnitt definiert sind, werden ihre Werte zusammengeführt oder überschrieben und der Abschnitt mit einem geringeren Umfang erhält beim Zusammenführen/Überschreiben eine höhere Priorität. So wird ein Wert aus [common|global] mit einem Wert aus [common|filelog]] zusammengeführt oder von diesem überschrieben, dieser wird wiederum mit einem Wert aus [filelog|sample_section] kombiniert oder von diesem überschrieben.

Das Zusammenführungs- und Überschreibeverhalten entspricht dabei folgenden Regeln:

  • Optionen, deren Werte aus einer Liste von Werten bestehen (Tags „include“, „exclude“ und „exclude_fields“) werden mit Werten dieser Option aus einem Abschnitt mit einer höheren Priorität zusammengeführt. Im Fall von Tags überschreiben die Werte der Tags aus Abschnitten mit einer höheren Priorität, wie zuvor beschrieben, den Wert desselben Tags aus einem Abschnitt mit einer geringeren Priorität.
  • Der Wert von Optionen, die einen einzigen Wert haben können („event_marker“, „charset“ und „parser“) wird von Werten dieser Option aus Abschnitten mit einer höheren Priorität überschrieben.

    Dies bedeutet, dass der allgemeine Wert „charset= UTF-16LE“ aus [common|global] vom Wert „charset=UTF-8“ aus [filelog|sample_section] überschrieben wird.

So wird beispielsweise bei tags={"app":"global-test"} in [common|filelog] und tags={"app":"local-test","section":"flg_test_section"} in [filelog|flg_test_section] der Wert [common|filelog] vom Wert des Tags „app“ aus dem Abschnitt [filelog|flg_test_section] überschrieben. Alle Protokolle, die über diesen Filelog-Abschnitt erfasst wurden, besitzen einen zusätzlichen Tag „app“ mit dem Wert „local-test“ und einen Tag „section“ mit dem Wert „flg_test_section“. Die Prioritätsreihenfolge für Winlog-Abschnitte ist identisch: [winlog|...]-Abschnitte haben die höchste Priorität und [common|global]-Abschnitte haben die geringste Priorität.

Wenn in allgemeinen Abschnitten ungültige Werte angegeben sind, werden diese im Allgemeinen übersprungen und nicht mit Werten vorheriger bzw. entsprechender Filelog-/Winlog-Abschnitte zusammengeführt. Bei ungültigen Werten in Tags oder exclude_fields-Optionen extrahiert der Agent so viele gültige Daten wie möglich und überspringt beim Antreffen ungültiger Daten den Rest der Datei. Alle Anomalien werden in der Agent-Protokolldatei berichtet. Konsultieren Sie beim Antreffen unerwarteten Verhaltens die Protokolldatei und korrigieren Sie alle durch den Agenten berichteten Fehler.

Wenn von Agenten ein ungültiger Wert für eine Option in einem Filelog- oder Winlog-Abschnitt erkannt wird, werden die Optionswerte aus diesem Abschnitt vom Agenten nicht mit Optionswerten aus allgemeinen Abschnitten zusammengeführt und dieser Abschnitt nicht aktiviert. Alle Fehler werden in einer Agent-Protokolldatei berichtet. Konsultieren Sie beim Antreffen unerwarteten Verhaltens die Protokolldatei und korrigieren Sie alle durch den Agenten berichteten Fehler.