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

Agent 업그레이드 (Upgrade Agents)

원문 보기 위키 갱신

Fleet Automation으로 개별 호스트에 직접 접근하지 않고 플릿 전체의 Datadog Agent를 원격으로 업그레이드하는 방법을 알려드릴게요. 즉시 업그레이드를 트리거하거나, 유지보수 기간에 예약하거나, API로 자동화할 수 있어요.

출처: 문서

본문

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

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

Fleet Automation을 사용하면 개별 호스트에 직접 접근하지 않고 플릿 전체의 Datadog Agent를 원격으로 업그레이드할 수 있어요. 업그레이드를 즉시 트리거하거나, 유지보수 기간에 예약하거나, API를 통해 자동화할 수 있어요.

사전 요구 사항 (Prerequisites)

  • 조직에서 Remote Configuration이 활성화되어 있을 것
  • Windows는 Agent 7.71, Linux는 7.69
  • Linux VM 또는 Windows VM
  • 초기 Agent 설치에 최소 2GB 디스크 공간, 업그레이드에 추가 2GB. (업그레이드에는 Linux의 /opt/datadog-packages에 1.3GB, Windows의 C:\ProgramData\Datadog\Installer\packages에 1.3GB가 필요해요. 추가 공간은 롤백이 필요할 때를 대비해 업그레이드 중 두 Agent 설치를 임시로 유지하는 데 사용돼요.)

컨테이너화된 워크로드의 Agent 원격 업그레이드는 지원되지 않아요.

Agent 즉시 업그레이드하기

  1. Upgrades 탭에서 Upgrade Now를 클릭해요.

  2. 업그레이드할 Agent를 선택해요. 특정 그룹을 대상으로 호스트 정보나 태그로 필터링해요.

  3. 배포 계획을 검토하고 Upgrade Agents를 클릭해 업그레이드를 시작해요.

  4. Deployments 대시보드에서 진행 상황을 추적해요. deployments 테이블에서 Agent를 클릭하면 기간, 진행 상황, 업그레이드를 시작한 사용자를 확인할 수 있어요.

Agent 업그레이드 예약하기

  1. Upgrades 탭에서 + Create Schedule을 클릭해요.

  2. Upgrade Schedule 페이지에서 Schedule 이름을 추가해요.

  3. Agent 버전을 선택해요. 최신 버전, 한 단계 이전 버전, 두 단계 이전 버전으로 업그레이드할 수 있어요.

  4. 업그레이드할 Agent를 지정해요. 특정 그룹을 대상으로 호스트 정보나 태그로 필터링해요.

  5. 이 업그레이드의 배포 기간을 설정해요. 업그레이드할 요일, 시간대, 시간대(timezone)를 선택할 수 있어요.

  6. 배포 상태 업데이트에 대한 알림을 설정해요. Slack, Teams, PagerDuty처럼 Datadog에 연결된 서비스로 팀에 알릴 수 있어요.

  7. Create Schedule을 클릭해 일정을 저장해요.

  8. 예약된 업그레이드 목록은 Upgrades 탭의 Upgrade Schedules 섹션에서 볼 수 있어요.

API로 Agent 업그레이드하기

Fleet Automation은 프로그래밍 방식이나 반복 일정으로 Agent 업그레이드를 트리거할 수 있는 API를 제공해요. 필터 쿼리로 호스트 집합의 업그레이드를 시작하거나, 정의된 유지보수 기간에 지정된 Agent 버전으로 실행되는 일정을 만들 수 있어요. 자세한 내용은 Fleet Automation API를 참고하세요.

업그레이드 프로세스

수동 업그레이드와 비슷하게 Agent가 재시작되는 동안 5~30초의 다운타임이 예상돼요. 전체 업그레이드 프로세스는 약 5분이 걸려요: 업그레이드 자체에 약 2분, 나머지 시간은 안정성 모니터링에 사용돼요. 업그레이드가 실패하면 Agent는 자동으로 이전 버전으로 되돌아가요.

업그레이드 프로세스는 주로 다음 디렉터리에 파일을 추가해요:

Linux:

  • /opt/datadog-packages
  • /etc/datadog-agent
  • /etc/systemd/system

Windows:

  • C:\ProgramData\Datadog\Installer\packages
  • C:\Program Files\Datadog\Datadog Agent

Agent가 이 파일들에 적절한 권한을 설정해요. 업그레이드 중에는 구성 파일이 변경되지 않아요.

업그레이드 우선순위 (Upgrade precedence)

Datadog은 한 번에 한 소스에서 업그레이드를 관리할 것을 권장해요. Fleet Automation이나 구성 관리 도구 중 하나를 사용하고 둘 다 사용하지 마세요. Fleet Automation으로 업그레이드된 Agent에서 구성 관리 도구를 실행하면, 도구가 Agent를 구성의 DD_AGENT_MINOR_VERSION으로 되돌려요. DD_AGENT_MINOR_VERSION이 설정되지 않았다면 Agent는 사용 가능한 최신 버전으로 업그레이드돼요.

문제 해결 (Troubleshooting)

새로 출시된 Agent 버전이 아직 업그레이드 대상으로 안 보일 때

새 Agent 버전이 출시된 뒤 Fleet Automation의 업그레이드 대상으로 나타나기까지 최대 24시간이 걸릴 수 있어요. 최근 출시된 버전이 업그레이드 선택기에 없다면 최대 24시간 기다렸다가 다시 시도하세요.

Datadog Installer가 Agent와 호환되지 않을 때 (pre-7.66)

Preview 고객으로서 Agent 7.66 이전에 원격 Agent 관리를 설정했다면 Datadog Installer가 Agent와 호환되지 않을 수 있어요.

7.66부터 installer 구성 요소가 Agent에 포함돼요. 이렇게 하면 두 구성 요소가 동기화를 유지해 원격 관리를 막을 수 있는 버전 불일치를 방지해요. 이전 Agent 버전은 installer를 포함하지 않아 호환성 문제가 생길 수 있어요.

문제를 진단하고 해결하려면:

  1. Fleet Automation에서 다음 쿼리를 사용해 영향받는 호스트를 식별해요: 
    support_remote_upgrade:datadog-installer
  2. 설정이 영향을 받았다면 각 영향받는 Agent에서 설치 스크립트를 다시 실행해 Agent 7.66 이상으로 업그레이드해요.

7.66 이상으로 업데이트하면 이후 업그레이드는 자동으로 처리돼요. 업그레이드하지 않으면 기존 Agent는 계속 작동하지만 원격 업그레이드는 사용할 수 없게 돼요.

더 알아보기 (Learn more)

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