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|global]의 값은 [common|filelog]]의 값으로 병합 또는 재정의된 다음 [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 섹션에서 잘못된 옵션 값을 감지하면 해당 섹션의 옵션 값을 공통 섹션의 옵션 값과 병합하지 않고 해당 섹션을 사용하도록 설정하지 않습니다. 모든 오류는 에이전트 로그 파일에 보고됩니다. 예기치 않은 동작이 발생하는 경우 로그 파일을 확인하고 에이전트에서 보고된 모든 오류를 수정하십시오.
