Agent

Agent v7을 사용할 수 있습니다. 최신 버전으로 업그레이드하여 모든 새로운 기능을 활용하세요.

개요

Datadog Agent는 호스트에서 실행되는 소프트웨어입니다. 호스트로부터 이벤트와 메트릭을 수집하여 모니터링 및 성능 데이터를 분석할 수 있는 Datadog으로 보냅니다. Datadog Agent는 오픈 소스이며, 소스 코드는 GitHub의 DataDog/datadog-agent에서 사용할 수 있습니다.

에이전트를 사용하려면 플랫폼을 선택합니다.

Datadog은 Datadog Agent를 마이너 릴리스와 패치 릴리스별로, 또는 적어도 매월 업데이트하시길 권장합니다.

주요 Datadog Agent 버전으로 업그레이드하고 업데이트를 유지하는 것이 최신 Datadog Agent 기능과 수정 사항을 이용할 수 있는 유일한 지원 방법입니다.

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

Agent 관리

Fleet Automation을 통한 Agent 관리(권장)

Fleet Automation은 대규모로 Datadog Agent를 설치, 업그레이드, 구성 및 문제를 해결하는 기본적인 인앱 워크플로입니다.

Fleet Automation 뷰를 통해 한 곳에서 Datadog Agent를 중앙에서 관리할 수 있습니다.

구성 및 이력 보기: 한 페이지에서 플릿에 있는 모든 Agent와 그 버전, 활성화된 제품, 구성 파일 및 변경 내역을 확인하세요.
오래된 Agent 업그레이드: 몇 번의 클릭으로 Agent를 원격으로 업그레이드하여 플릿을 최신 상태로 유지하세요.
지원을 위한 플레어 전송: 호스트의 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에서 실행됩니다. 기본 웹 브라우저에서 GUI를 열려면 datadog-agent launch-gui 명령을 사용하세요.

GUI의 기본 포트는 datadog.yaml 구성 파일에서 변경할 수 있습니다. GUI를 비활성화하려면 포트 값을 -1로 설정하세요. Linux에서는 기본적으로 GUI가 비활성화되어 있습니다.

GUI 요구 사항:

브라우저에서 쿠키를 활성화한 상태여야 합니다. GUI는 브라우저에서 토큰을 생성하고 저장합니다. 이 토큰은 GUI 서버와의 모든 커뮤니케이션을 인증하는 데 사용됩니다.
GUI를 시작하려면 사용자에게 필수 권한이 있어야 합니다. datadog.yaml을 열 수 있으면 GUI를 사용할 수 있는 것입니다.
보안상의 이유로 오직 로컬 네트워크 인터페이스(localhost/127.0.0.1)에서만 GUI에 액세스할 수 있으므로 Agent가 실행 중인 호스트에서 작업해야 합니다. VM이나 컨테이너에서 Agent를 실행하고 호스트 시스템에서 액세스할 수 없습니다.

명령줄 인터페이스

Agent 6 이상 버전부터 Agent 명령줄 인터페이스는 하위 명령을 기반으로 합니다. Agent 하위 명령의 전체 목록은 Agent 명령을 참조하세요.

Datadog Agent로 더 나아가기

Agent 업데이트

지정된 호스트의 부차 버전 두 개 사이에서 Datadog Agent 코어를 수동으로 업데이트하려면 플랫폼에 해당하는 설치 명령을 실행합니다.

참고: 특정 Agent 통합을 수동으로 업데이트하려면 통합 관리 가이드를 참조하세요.

구성 파일

Agent 구성 파일 설명서를 참조하세요.

Datadog 사이트

Agent 주 구성 파일 datadog.yaml을 수정해 site 파라미터를 설정하세요(기본값: datadoghq.com).

site:

참고: site 파라미터에 대한 자세한 내용은 Datadog 사이트 시작하기 설명서를 참조하세요.

로그 위치

Agent 로그 파일 설명서를 참조하세요.

Agent 오버헤드

다음은 Datadog Agent 리소스 소비량 예시입니다. 테스트는 Amazon EC2 머신 c5.xlarge 인스턴스(4 VCPU/8GB RAM)에서 수행되었으며 유사한 리소스를 가진 ARM64 기반 인스턴스에서도 비슷한 성능이 관찰되었습니다. Agent 자체를 모니터링하기 위해 기본 datadog-agent가 프로세스 검사와 함께 실행되었습니다. 통합을 더 활성화하면 Agent 리소스 소비량이 늘어날 수 있습니다. JMX 검사를 활성화하면 모니터링 중인 JVM이 노출하는 빈의 개수에 따라 Agent의 메모리 사용량이 늘어납니다. 트레이스 및 프로세스 Agent를 활성화해도 리소스 소비량이 늘어납니다.

Agent 테스트 버전: 7.34.0
CPU: 평균적으로 CPU의 약 0.08% 사용
메모리: RAM 약 130MB 사용(RSS 메모리)
네트워크 대역폭: 약 140B/s ▼ | 800B/s ▲
디스크:
- Linux 830MB~880MB(분포에 따라 결정됨)
- Windows: 870MB

로그 수집:

아래는 파일 하나에서 HTTP 포워더를 활성화하여 초당 로그 110KB를 수집해 얻은 결과입니다. 리소스 사용량의 변화를 사용할 수 있는 여러 압축 수준에서 보여줍니다.