您可以使用為 Windows 或 Linux 代理程式的每個代理程式組態區段套用的一般參數值，來覆寫代理程式組態檔的預設值。

一般選項

liagent.ini 組態檔的 [common|global] 區段中指定的選項會散佈到所有區段，[common|filelog] 區段中指定的選項只會散佈到所有 filelog 區段，而 [common|winlog] 選項只會散佈到所有 winlog 區段。

您可以在一般區段中定義 tags, include, exclude, event_marker, charset, exclude_fields 和 parser 參數，如下列範例所示。這是 Windows 代理程式的範例： 

[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

...
此範例會指定下列行為：
  • 所有來自 filelog 區段的記錄都具有 log_source_vm 和 collector_type 標籤及其對應值。
  • 系統會從所有傳送的記錄中排除 test_tag 和 some_other_tag 標籤。
  • 系統會將auto剖析器套用至所有收集的記錄。
  • 依預設，所有 filelog 收集器都會從監控中排除 *.trc 檔案。
系統也會將 [common|global] 中的選項套用至所有 winlog 區段。

合併和覆寫準則

如果已在多個區段中定義選項，則系統會合併或覆寫其值，且合併/覆寫時，具有較小範圍的區段會具有較高優先順序。這表示來自 [common|filelog] 的值會合併或覆寫來自 [common|global] 的值，而來自 [filelog|sample_section] 的值也會合併或覆寫該值。

合併和覆寫行為會遵循下列規則：

  • 值代表值清單 (tags、include、exclude 和 exclude_fields) 的選項會與該選項來自具有較高優先順序之區段的值合併。如先前所述，在具有標籤的情況下，來自具有較高優先順序之區段的標籤值會覆寫來自具有較低優先順序之區段的相同標籤值。
  • 選項來自具有較高優先順序之區段的值會覆寫可具有單一值 (event_marker、charset 和 parser) 的選項值。

    這表示來自 [filelog|sample_section] 的 charset=UTF-8 值會覆寫來自 [common|global] 的 charset= UTF-16LE 全域值。

因此，例如，如果您在 [common|filelog] 中具有 tags={"app":"global-test"}，且在 [filelog|flg_test_section] 中具有 tags={"app":"local-test","section":"flg_test_section"}，則來自 [filelog|flg_test_section] 區段的 "app" 標籤值會覆寫來自 [common|filelog] 的值。透過此 filelog 區段收集的所有記錄都會具有包含 "local-test" 值的額外 "app" 標籤，以及包含 "flg_test_section" 值的 "section" 標籤。winlog 區段的優先順序鏈結相同，任何 [winlog|...] 區段都具有最高優先順序，而 [common|global] 具有最低優先順序。

在一般區段中指定無效值時，系統通常會略過這些值，且不會將其與來自先前和對應之 filelog/winlog 區段的值合併。在標籤或 exclude_fields 選項具有無效值的情況下，代理程式會盡可能擷取較多的有效資料，並在遇到無效資料後略過其餘檔案。代理程式記錄檔中會報告所有異常。如果發生非預期的行為，請參閱記錄檔並修正代理程式報告的所有錯誤。

如果代理程式在 filelog 或 winlog 區段中偵測到選項的無效值，則不會合併來自該區段的選項值與來自一般區段的選項值，且不會啟用該區段。代理程式記錄檔中會報告所有錯誤。如果發生非預期的行為，請參閱記錄檔並修正代理程式報告的所有錯誤。