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

Datadog Agent

원문 보기 위키 갱신

Datadog Agent는 호스트에서 실행되며 이벤트와 메트릭을 수집해 Datadog로 보내는 소프트웨어예요. 이 문서에서는 Agent가 무엇인지, 어떻게 설치·구성·관리하는지, 그리고 어디서 더 자세히 배울 수 있는지를 함께 살펴볼게요. Agent는 오픈소스라서 소스 코드도 GitHub의 DataDog/datadog-agent 저장소에서 직접 볼 수 있어요.

출처: 문서

본문

Datadog Agent는 호스트에서 실행되는 소프트웨어로, 호스트에서 이벤트와 메트릭을 수집해 Datadog로 전송해요. 전송된 데이터는 Datadog에서 모니터링과 성능 데이터로 분석할 수 있죠.

에이전트 v7이 사용 가능해요. 최신 버전으로 업그레이드하면 모든 새로운 기능을 활용할 수 있어요.

개요

Datadog Agent는 호스트에서 실행되는 소프트웨어로, 호스트에서 이벤트와 메트릭을 수집해 Datadog로 전송합니다. 전송된 데이터는 Datadog에서 모니터링과 성능 데이터로 분석할 수 있어요. Datadog Agent는 오픈소스이며, 소스 코드는 GitHub의 DataDog/datadog-agent에서 확인할 수 있어요.

플랫폼 선택하기 — Agent 사용을 시작하려면 먼저 플랫폼을 선택하세요.

Datadog은 모든 마이너·패치 릴리스마다, 적어도 매월 Agent를 업데이트할 것을 권장해요. 메이저 버전으로 업그레이드하고 계속 최신 상태를 유지하는 것이 최신 Agent 기능과 수정 사항을 받을 수 있는 유일한 공식 방법이에요.

Agent를 완전히 설치하는 것이 권장됩니다. 다만 Amazon Linux, CentOS, Debian, Fedora, Red Hat, SUSE, Ubuntu에서는 독립형 DogStatsD 패키지를 사용할 수 있어요. 이 패키지는 DogStatsD가 사이드카로 실행되는 컨테이너 환경이나, 전체 Agent 기능 없이 DogStatsD 서버만 실행하는 환경에서 사용돼요.

Fleet Automation으로 Agent 관리하기 (권장)

Fleet Automation은 대규모로 Datadog Agent를 설치·업그레이드·구성·문제 해결하기 위한 앱 내 기본 워크플로예요.

  • 구성 및 이력 보기: 단일 페이지에서 Fleet의 모든 Agent, 버전, 활성화된 제품, 구성 파일, 변경 이력을 볼 수 있어요.
  • 오래된 Agent 업그레이드: 몇 번의 클릭으로 원격 업그레이드를 트리거해 Fleet을 최신 상태로 유지할 수 있어요.
  • 지원용 플레어 보내기: 호스트의 Support 탭에서 명령줄을 사용하지 않고 플레어를 생성해 새 지원 케이스나 기존 케이스에 첨부할 수 있어요.
  • API 키 사용 감사: 특정 API 키를 사용하는 Agent를 식별하고 키를 안전하게 교체할 수 있어요.

Datadog Agent Manager GUI

참고로 Agent GUI는 32비트 Windows 플랫폼은 지원하지 않아요.

Datadog Agent Manager GUI는 다음 작업에 사용해요:

  • Agent 상태 정보 보기
  • 실행 중인 모든 체크 보기
  • Agent 로그 보기
  • Agent 구성 파일(datadog.yaml) 편집
  • Agent 체크 추가·편집
  • 플레어 보내기

Datadog Agent Manager GUI는 Windows와 macOS에서 기본으로 활성화되어 있으며 포트 5002에서 실행돼요. datadog-agent launch-gui 명령으로 기본 웹 브라우저에서 GUI를 열 수 있어요.

datadog.yaml 구성 파일에서 GUI 기본 포트를 바꿀 수 있고, 포트 값을 -1로 설정하면 GUI를 비활성화할 수 있어요. Linux에서는 GUI가 기본적으로 비활성화되어 있어요.

GUI 요구 사항:

  • 브라우저에서 쿠키가 활성화되어 있어야 해요. GUI는 브라우저에 토큰을 생성·저장하는데, 이 토큰이 GUI 서버와의 모든 통신 인증에 사용돼요.
  • GUI를 시작하려면 필요한 권한이 있어야 해요. datadog.yaml을 열 수 있다면 GUI도 사용할 수 있어요.
  • 보안상 GUI는 로컬 네트워크 인터페이스(localhost/127.0.0.1)에서만 접근할 수 있어요. 따라서 Agent가 실행되는 호스트에 있어야 하며, VM이나 컨테이너에서 Agent를 실행하면서 호스트 머신에서 접근할 수는 없어요.

명령줄 인터페이스

Agent 6부터 Agent 명령줄 인터페이스는 하위 명령(subcommand) 기반이에요. 전체 하위 명령 목록은 Agent Commands를 참고하세요.

Datadog Agent 더 알아보기

Agent 업데이트하기

주어진 호스트에서 두 마이너 버전 사이의 Datadog Agent 코어를 수동으로 업데이트하려면 해당 플랫폼에 맞는 설치 명령을 실행하면 돼요.

참고: 특정 Agent 통합 하나를 수동으로 업데이트하려면 Integration Management 가이드를 참고하세요.

구성 파일

Agent 구성 파일 문서를 참고하세요.

Datadog 사이트

Agent의 메인 구성 파일인 datadog.yaml을 편집해 site 파라미터를 설정하세요(기본값은 datadoghq.com).

site: <YOUR_DATADOG_SITE>

참고: site 파라미터에 대한 자세한 내용은 Getting Started with Datadog Sites 문서를 참고하세요.

로그 위치

Agent log files 문서를 참고하세요.

Agent 오버헤드

Datadog Agent 리소스 소비의 예시는 아래와 같아요. 테스트는 Amazon EC2 c5.xlarge 인스턴스(4 VCPU/8GB RAM)에서 진행했으며, 비슷한 리소스의 ARM64 기반 인스턴스에서도 비슷한 성능이 관찰됐어요. 기본 datadog-agent는 Agent 자체를 모니터링하는 프로세스 체크와 함께 실행됐어요. 통합을 더 활성화하면 Agent 리소스 소비가 늘어날 수 있어요. JMX 체크를 활성화하면 모니터링되는 JVM이 노출하는 빈 수에 따라 메모리를 더 사용하게 돼요. trace 및 process Agent를 활성화하면 리소스 소비도 마찬가지로 늘어나요.

  • Agent 테스트 버전: 7.34.0
  • CPU: 평균 약 0.08%
  • 메모리: 약 130MB(RSS 메모리)
  • 네트워크 대역폭: 약 140 B/s ▼ | 800 B/s ▲
  • 디스크:
    • Linux 830MB~880MB(배포판에 따라 다름)
    • Windows: 870MB

로그 수집:

아래 결과는 HTTP forwarder를 활성화한 상태에서 파일에서 초당 110KB의 로그를 수집해 얻었어요. 사용 가능한 압축 레벨별 리소스 사용량 변화를 보여줘요.

HTTP 압축 레벨 6:

  • Agent 테스트 버전: 6.15.0
  • CPU: 평균 약 1.5%
  • 메모리: 약 95MB
  • 네트워크 대역폭: 약 14 KB/s ▲

HTTP 압축 레벨 1:

  • Agent 테스트 버전: 6.15.0
  • CPU: 평균 약 1%
  • 메모리: 약 95MB
  • 네트워크 대역폭: 약 20 KB/s ▲

HTTP 무압축:

  • Agent 테스트 버전: 6.15.0
  • CPU: 평균 약 0.7%
  • 메모리: 약 90MB(RSS 메모리)
  • 네트워크 대역폭: 약 200 KB/s ▲

추가 리소스

이 섹션에는 다음 주제가 포함돼요:

더 알아보기 (Learn more)