본문 바로가기
WIKI 기술 지식 베이스

Agent 통합 구성하기 (Configure Agent Integrations)

원문 보기 위키 갱신

Fleet Automation으로 Datadog Agent 통합을 원격에서 대규모로 구성하는 방법을 알려드릴게요. 호스트별로 설정 파일을 편집하는 대신 호스트나 태그로 대상을 골라 한 번에 배포할 수 있어요.

출처: 문서

본문

app.ddog-gov.com, us2.ddog-gov.com Datadog 사이트를 사용하는 사용자를 위한 중요 참고사항

이 제품은 선택한 Datadog 사이트({% placeholder "user-datadog-site-name" /%})에서는 지원되지 않아요.

Fleet Automation은 Agent의 통합 설정 파일(conf.d)을 원격으로 배포, 업데이트, 제거할 수 있어요. 호스트나 태그로 대상 Agent를 선택하고 통합을 고른 뒤 Fleet Automation이 플릿 전체에 설정 변경을 밀어 넣어요.

사전 요구 사항 (Prerequisites)

  • 조직에서 Remote Configuration이 활성화되어 있을 것
  • Agent 7.76 이상. Agent 업그레이드 방법은 Agent 업그레이드 참고
  • Linux VM(설치 스크립트나 Ansible Datadog Role로 설치) 또는 Windows VM

컨테이너화된 워크로드의 Agent에서 통합을 구성하는 것은 지원되지 않아요.

호환성 (Compatibility)

Fleet Automation은 Redis, MySQL, Windows Certificate Store처럼 conf.d 설정 파일이 있는 기본 제공(out-of-the-box) 통합 구성을 지원해요.

커스텀 체크는 지원되지 않아요.

여러 Agent에 걸쳐 통합 구성하기

구성 마법사를 진행할 때 Configuration Summary 패널에 현재 선택된 Agent 범위가 표시돼요. 범위 내 특정 Agent의 구성 diff를 미리 보면 변경이 Agent에 어떤 영향을 주는지 확인할 수 있어요.

  1. Fleet Automation에서 Configuration 탭을 열고 Configure Agents를 클릭해요.

  2. 대상을 특정 Agent로 범위를 정해요. 특정 그룹을 대상으로 호스트 정보나 태그로 필터링해요.

  3. Agent 통합(Agent integrations)을 선택해요.

  4. 구성할 통합을 선택해요.

참고: Fleet Automation은 호스트에서 구성되지 않은 통합을 감지할 수 있어요. 사용 가능한 Datadog 통합이 있는데 활성 구성이 없는 프로세스가 호스트에서 실행 중이면 Unconfigured integrations detected on your hosts 목록에 나타나요. 이것으로 플릿 전반의 모니터링 공백을 파악할 수 있어요.

  1. 작업(operation)을 선택해요. 각 작업에 대한 자세한 내용은 How configuration changes are applied 참고:

    • Add New. 새 설정 파일의 파일 이름을 지정하고 안내에 따라 구성을 작성해요.
    • Edit & Replace. Select a file을 클릭해 교체할 설정 파일을 선택한 뒤 안내에 따라 새 구성을 작성해요.
    • Delete. Select a File to Delete를 클릭해요. 통합 구성을 작성할 때 Visual 모드와 YAML 모드를 전환할 수 있어요. YAML 모드에서는 YAML을 직접 붙여넣을 수 있어요.

  2. 배포 계획을 검토해요. Fleet Automation은 영향받는 각 Agent에 대한 구성 diff를 생성해 정확한 변경 사항을 확인할 수 있게 해 줘요.

  3. Deploy Configuration을 클릭해 배포를 시작해요. 진행 상황은 Deployments 페이지에서 추적할 수 있어요.

구성 변경이 적용되는 방식

각 작업은 통합의 conf.d 설정 파일에 다르게 변경을 적용해요:

  • Add New: 새 통합 설정 파일을 배포해요. 설정 파일이 이미 있다면 완전히 교체되고, 제공한 YAML이 대상 Agent의 해당 통합에 대한 완전한 새 구성이 돼요.

  • Edit & Replace: 지정한 필드만 수정되고, 언급하지 않은 필드는 변경되지 않아요.

참고(경고): tags 같은 배열 필드는 Edit & Replace 중에 병합되지 않고 완전히 교체돼요. 업데이트에 원하는 모든 값을 포함하세요. 누락한 값은 제거돼요.

  • Delete: 대상 Agent에서 통합 설정 파일을 제거해요.

더 알아보기 (Learn more)

도움이 되는 추가 문서, 링크, 글: