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

Agent 구성하기 (Configure Agents)

원문 보기 위키 갱신

Fleet Automation으로 Datadog Agent 구성을 대규모로 배포하고 관리하는 방법을 알려드릴게요. UI의 안내 워크플로우나 커스텀 YAML 파일로 구성 변경을 적용할 수 있어요.

출처: 문서

본문

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

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

Fleet Automation을 사용해 Datadog Agent 구성을 대규모로 배포하고 관리해요. UI의 안내 워크플로우나 커스텀 YAML 파일로 구성 변경을 적용할 수 있어요. Fleet Automation으로 관리할 수 있는 Agent 설정은 지원되는 datadog.yaml 구성 필드를 참고하세요.

사전 요구 사항 (Prerequisites)

  • 조직에서 Remote Configuration이 활성화되어 있을 것
  • Agent 및 OTel Collector 구성에는 Agent 7.73+ (통합과 시크릿 구성에는 7.76+). Agent 업그레이드 방법은 Agent 업그레이드 참고
  • 설치 스크립트나 Ansible Datadog Role로 설치된 Linux VM 또는 Windows VM

app.datadoghq.com, us3.datadoghq.com, us5.datadoghq.com, app.datadoghq.eu, ap1.datadoghq.com, ap2.datadoghq.com, uk1.datadoghq.com Datadog 사이트를 사용하는 사용자를 위한 중요 참고사항

Preview에 참여하세요!

컨테이너화된 워크로드의 Agent 원격 구성이 Preview 단계에 있어요. 이 기능에 관심이 있다면 양식을 작성해 액세스를 요청하세요.

액세스 요청

app.datadoghq.com, us3.datadoghq.com, us5.datadoghq.com, app.datadoghq.eu, ap1.datadoghq.com, ap2.datadoghq.com, uk1.datadoghq.com Datadog 사이트를 사용하는 사용자를 위한 중요 참고사항

Preview에 참여하세요!

Fleet Automation으로 Datadog Agent 태그를 관리하는 기능이 Preview 단계에 있어요. 이 기능에 관심이 있다면 양식을 작성해 액세스를 요청하세요.

액세스 요청

여러 Agent 구성하기

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

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

  3. 대상 Agent가 실행해야 할 제품(예: Logs, APM, NDM)을 선택해요.

  4. 배포 계획을 검토해 대상으로 정해진 Agent와 롤아웃 동시성 같은 배포 설정을 확인해요.

  5. Deploy Configuration을 클릭해 배포를 시작하고 Deployments 페이지에서 진행 상황을 추적해요.

단일 Agent의 구성 편집하기

  1. Fleet View로 이동해요.

  2. (선택 사항) 호스트 정보나 태그로 필터링해 목록을 좁혀요.

  3. 호스트를 선택해 사이드 패널을 연 뒤 Configuration 탭을 클릭해요.

  4. Edit를 클릭해 구성을 수정해요.

  5. 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로 관리할 수 없어요. 관리할 수 있는 필드는 지원되는 datadog.yaml 구성 필드를 참고하세요.

구성 우선순위 (Configuration precedence)

Fleet Automation으로 배포한 구성 변경은 대상에 따라 다른 규칙을 따라요:

  • Agent 구성(datadog.yaml): Fleet Automation은 merge patch로 변경을 적용해요. 지정한 필드만 업데이트되고 언급되지 않은 필드는 그대로 남아요. 필드 레벨에서 충돌이 발생하면 Fleet Automation 값이 로컬 값보다 우선해요.

  • 통합 및 커스텀 로그 구성: Fleet Automation은 두 가지 모드를 지원해요:

    • 새 구성 파일 배포.
    • merge patch로 기존 파일을 업데이트해 특정 필드만 수정. merge patch를 사용하지 않고 기존 파일 이름을 대상으로 변경을 배포하면 파일이 완전히 덮어써져요.

두 경우 모두 소스(Fleet Automation, 구성 관리 도구, 직접 호스트 편집)와 관계없이 가장 최근 변경이 Agent의 활성 구성이 돼요.

Fleet Automation Audit Trail을 사용해 Agent에 대한 최근 구성 변경을 추적하고 그 변경에 대한 알림을 설정하세요.

미러 및 프록시 (Mirrors and proxies)

프록시나 미러링된 저장소와 함께 원격 Agent 관리를 사용할 수 있어요.

Agent가 프록시를 사용하도록 구성하는 방법은 Agent 프록시 구성을 참고하세요. 프록시를 구성한 뒤 설정을 적용하려면 Agent를 재시작하세요.

미러링되거나 air-gapped 저장소를 사용하는 방법은 다음을 참고하세요:

더 알아보기 (Learn more)

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