Agent 구성

문서 > Agent > Fleet Automation > Agent 구성

Fleet Automation을 사용하여 규모에 맞게 Datadog Agent 구성을 롤아웃하고 관리하세요. UI에서 가이드가 있는 워크플로를 통해, 또는 사용자 지정 YAML 파일을 사용해 구성 변경 사항을 적용합니다.

전제 조건

조직에 Remote Configuration이 활성화되어 있음
Agent 및 OTel Collector 구성에 적합한 Agent 버전 7.73 이상(통합 및 시크릿을 구성하려면 버전 7.76 이상) Agent를 업그레이드하는 방법은 Agent 업그레이드를 참조하세요.
설치 스크립트 또는 Ansible Datadog Role을 사용하여 설치한 Linux VM, 또는 Windows VM

여러 Agent 구성

Fleet Automation에서 구성 탭을 열고 Configure Agents를 클릭합니다.
구성의 범위를 대상 Agent로 지정합니다. 호스트 정보 또는 태그를 기준으로 필터링하여 특정 그룹을 대상으로 지정합니다.
대상 Agent가 실행해야 하는 제품(예: Logs, APM 또는 NDM)을 선택합니다.
배포 계획을 검토하여 범위가 지정된 Agent 및 배포 설정(예: 롤아웃 동시성)을 확인합니다.
Deploy Configuration을 클릭하여 배포를 시작하고 배포 페이지에서 진행 상황을 추적합니다.

단일 Agent의 구성 편집

Fleet 보기로 이동합니다.
(선택 사항) 호스트 정보 또는 태그를 기준으로 필터링하여 목록 범위를 좁힙니다.
호스트를 선택하여 사이드 패널을 연 다음 Configuration 탭을 클릭합니다.
Edit를 클릭하여 구성을 수정합니다
Deploy Changes를 클릭하여 업데이트를 적용합니다

참고: 일부 구성 필드(api_key, site, notable_events 등)는 수정할 수 없습니다.

아래 예시에서는 logs_enabled 필드가 false에서 true로 변경되었으며, 이렇게 하면 배포 후 Agent에서 로그 수집이 활성화됩니다.

API를 사용하여 Agent 구성

Fleet Automation은 프로그래밍 방식으로 구성 업데이트를 적용할 수 있는 API를 제공합니다. 필터 쿼리를 사용해 모든 호스트 그룹에 변경 사항을 배포하세요. 전체 구성 파일을 제공할 수도 있고, 대상이 지정된 패치를 제공할 수도 있습니다. 온디맨드 방식으로 구성을 푸시하거나, 기존 자동화 워크플로에 통합하세요. 자세한 정보는 Fleet Automation API를 참조하세요.

참고: API는 모든 Agent 구성 필드를 지원하지는 않습니다. Agent 연결 또는 시크릿(site, api_key 및 기타 인증 파라미터)과 관련된 설정은 API를 통해 관리할 수 없습니다.

구성 우선 순위

Fleet Automation을 통해 배포된 구성 변경 사항은 대상에 따라 다른 규칙을 따릅니다.

Agent 구성(datadog.yaml): Fleet Automation이 병합 패치를 사용해 변경 사항을 적용합니다. 지정된 필드만 업데이트되고, 언급되지 않은 필드는 변함없이 유지됩니다. 필드 수준에서 충돌이 발생하는 경우, Fleet Automation 값이 모든 로컬 값보다 우선입니다.
통합 및 사용자 지정 로그 구성: Fleet Automation이 다음 두 가지 모드를 지원합니다.
- 새 구성 파일을 배포합니다.
- 병합 패치를 사용해 특정 필드만 수정하도록 기존 파일을 업데이트합니다. 병합 패치를 사용하지 않고 기존 파일 이름을 대상으로 변경 사항을 배포하면 해당 파일이 완전히 덮어쓰입니다.
두 상황 모두 소스와 관계없이(Fleet Automation, r구성 관리 도구 또는 직접 호스트 편집) 가장 최근의 변경 사항이 Agent의 활성 구성이 됩니다.

Fleet Automation Audit Trail을 사용하여 Agent의 최근 구성 변경 사항을 추적하고 해당 변경 사항에 대한 경보를 설정하세요.