[ Datadog ] Agent Install & Uninstall

수정 날짜: 수, 10월 15, 2025 시간: 3:49 PM

■ Agent Install
- ① Linux
  - 인터넷망에서 Datadog Agent 설치
  - 폐쇄망에서 Datadog Agent 설치
    - RedHat/CentOS 계열
    - Debian/Ubuntu 계열
- ② Windows
- ③ Windows AD
- ④ Kubernetes
■ Agent Uninstall

■ Agent Install

① Linux

- 인터넷망에서 Datadog Agent 설치

Datadog One Step 설치
<DATADOG API KEY>에 수집할 ORG의 API KEY로 변경하여 아래 command를 실행합니다.
```
DD_API_KEY=<DATADOG API KEY> DD_SITE="datadoghq.com" bash -c "$(curl -L https://install.datadoghq.com/scripts/install_script_agent7.sh)"
```
- 위 Command는 Integration > Fleet Automation > Install Agents 메뉴에서 OS를 선택해 확인 가능합니다.
- 해당 화면에서 Command 복사시 Application Performance Monitoring을 되도록 Off로 설정하시기 권장합니다. (Command 내에 DD_APM_INSTRUMENTATION_ENABLED=host 부분 제거)
- API Key만 확인하고자 하시는 경우, Datadog Console 계정 > Organization Settimngs > ACCESS > API Key 에서 KEY를 선택 후 팝업에서 Copy 버튼을 클릭해 API KEY를 복사하시면 됩니다.

- 폐쇄망에서 Datadog Agent 설치

RedHat/CentOS 계열 Datadog 단계별 설치
https://yum.datadoghq.com/stable/7/x86_64/ 에서 설치 패키지의 최신버전을 다운로드합니다.
datadog-agent-7.xx.x-1.x86_64.rpm 형식인 파일 중 최신 버전을 다운로드 받으시기 바랍니다.
( 2025년 6월 : https://s3.amazonaws.com/yum.datadoghq.com/stable/7/x86_64/datadog-agent-7.71.1-1.x86_64.rpm)패키지를 설치합니다
```
sudo yum localinstall datadog-agent-7.71.1-1.x86_64.rpm
혹은
sudo rpm -ivh ./ datadog-agent-7.71.1-1.x86_64.rpm3
```
- datadog agent 구성파일 복사 및 API Key를 변경, Datadog site 정보를 추가 합니다.
  API Key는 Datadog Console 계정 > Organization Settimngs > ACCESS > API Key 에서 KEY를 선택 후 팝업에서 Copy 버튼을 클릭해 API KEY를 복사하시면 됩니다.
```
sudo sh -c "sed 's/api_key:.*/api_key: XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX/' /etc/datadog-agent/datadog.yaml.example > /etc/datadog-agent/datadog.yaml"
sudo sh -c "sed -i 's/# site:.*/site: datadoghq.com/' /etc/datadog-agent/datadog.yaml"
```
- 권한을 설정합니다.
```
sudo sh -c "chown dd-agent:dd-agent /etc/datadog-agent/datadog.yaml && chmod 640 /etc/datadog-agent/datadog.yaml"
```
- Datadog Agent를 재시작 및 Agent 상태를 확인합니다.
```
sudo systemctl restart datadog-agent.service
sudo datadog-agent status
```
Debian/Ubuntu 계열 Datadog 단계별 설치
- https://apt.datadoghq.com/pool/d/da/ 에서 설치 패키지의 최신버전을 다운로드합니다.
  datadog-agent-7.xx.x-1_arm64.deb 형식인 파일 중 최신 버전을 다운로드 받으시기 바랍니다.
  ( 2025년 2월 : https://s3.amazonaws.com/apt.datadoghq.com/pool/d/da/datadog-agent_7.71.1-1_arm64.deb)
- 패키지를 설치합니다
```
sudo apt install ./datadog-agent_7.71.1-1_arm64.deb
```
- datadog agent 구성파일 복사 및 API Key를 변경, Datadog site 정보를 추가 합니다.
  API Key는 Datadog Console 계정 > Organization Settimngs > ACCESS > API Key 에서 KEY를 선택 후 팝업에서 Copy 버튼을 클릭해 API KEY를 복사하시면 됩니다.
```
sudo sh -c "sed 's/api_key:.*/api_key: XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX/' /etc/datadog-agent/datadog.yaml.example > /etc/datadog-agent/datadog.yaml"
sudo sh -c "sed -i 's/# site:.*/site: datadoghq.com/' /etc/datadog-agent/datadog.yaml"
```
- 권한을 설정합니다.
```
sudo sh -c "chown dd-agent:dd-agent /etc/datadog-agent/datadog.yaml && chmod 640 /etc/datadog-agent/datadog.yaml"
```
- Datadog Agent를 재시작 및 Agent 상태를 확인합니다.
```
sudo systemctl restart datadog-agent.service
sudo datadog-agent status
```

② Windows

본 설치 가이드는 Windows Server 2008 R2+ 이상의 내용으로 안내하며, 그 이하 버전은 지원하지 않습니다. Windows OS는 Datadog Agent Installer(msi) 파일을 다운로드 받아 설치하기 때문에 네트워크 환경에 따라 설치 방법의 차이가 없습니다.

Datadog Agent 설치 프로그램을 다운로드합니다.
https://s3.amazonaws.com/ddagent-windows-stable/datadog-agent-7-latest.amd64.msi
관리자 권한으로 datadog-agent-7-latest.amd64.msi 설치 진행합니다.
- 사용권 계약에 동의하고 Datadog ORG의 API Key를 입력 합니다.
  API Key는 Datadog Console 계정 > Organization Settimngs > ACCESS > API Key 에서 KEY를 선택 후 팝업에서 Copy 버튼을 클릭해 API KEY를 복사하시면 됩니다.
- Datadog 지역은 http://datadoghq.com 을 선택하고 설치 완료합니다.
- Datadog Agent 재시작 및 Agent 상태를 확인합니다.
  Datadog Agent Manager를 관리자 권한으로 실행합니다.
  좌측 메뉴(아래 화면)의 Settings를 클릭합니다.
  환경에 맞게 정보들을 수정 후 Save 버튼 클릭 및 Restart Agent를 실행한 후 상단의 상태가 Connected to Agent이면 정상입니다.

③ Windows AD

AD Domain Controller의 User에 Datadog Agent를 설치하는 ddagentuser를 생성하고 ‘Performance Monitoring(Performance Monitor Users)’와’Event Log Viewer(Event Log Readers)’ 그룹의 권한이 필요합니다.
참고 URL: https://docs.datadoghq.com/agent/faq/windows-agent-ddagent-user/#installation-in-a-domain-environment

ddagentuser계정을 생성합니다.
- 서버 관리자에서 ‘도구’의 ‘Active Directory 사용자 및 컴퓨터’(dsa.msc)를 선택합니다.
- Domain 정보가 있는 창의 오른쪽 빈 공간에서 마우스 우클릭을 하고, ‘새로 만들기 > 사용자’를 클릭합니다.
- 사용자 계정 정보에 ddagentuser를 입력하고, ‘Next(다음)’을 클릭합니다.
- 패스워드 및 암호 정책 설정에 보안 규칙에 맞게 적절한 비밀번호를 지정(*주의할 내용으로는 세미콜론(;)은 사용하면 안됨)하고, 옵션을 적절히 정한 후 Next(다음)’을 클릭합니다.
  옵션은 ‘User must change password at next logon(다음 로그온 시 사용자가 반드시 암호를 변경해야 함)’과 ‘Password never expires(암호 사용 기간 제한 없음)’의 체크박스를 해제하여 비밀번호를 변경할 수 없도록 합니다.
- 정보를 확인 후 ‘Finish(마침)’를 클릭합니다.
- 이후 아래와 같이 ddagentuser 사용자 속성에서 정상적으로 등록됐는지 확인합니다.
- ‘Unlock Account(계정 잠금 해제)’를 체크해서 계정 사용에 문제가 없도록 합니다.
‘Event Log Readers’ 와 ‘Performance Monitor Users’ 권한을 추가합니다.
Windows 호스트에서 datadog-agent-7-latest.amd64.msi 설치 진행합니다.
위의 ‘Windows OS 설치’의 일반적인 Datadog Agent 설치와는 다르게 user와 password를 설정해서 설치하는 방식으로 진행합니다.
- Command Prompt 창에서 datadog-agent-7-latest.amd64.msi가 있는 위치로 이동합니다. 이후 아래와 같이 명령어를 입력합니다.
```
msiexec /i datadog-agent-7-latest.amd64.msi DDAGENTUSER_NAME=<도메인컨트롤러주소>\ddagentuser DDAGENTUSER_PASSWORD=<설정한 비밀번호>
```
  - <도메인컨트롤러주소> 및 <설정한 비밀번호>부분은 각각 도메인 컨트롤러 주소와 1번에서 설정한 비밀번호로 변경 후 명령어를 실행합니다.
- 이후 API key 입력 화면이 나오면 API key 입력합니다.
  API Key는 Datadog Console 계정 > Organization Settimngs > ACCESS > API Key 에서 KEY를 선택 후 팝업에서 Copy 버튼을 클릭해 API KEY를 복사하시면 됩니다.
- Datadog 지역은 http://datadoghq.com 을 선택하고 설치 완료합니다.
- Datadog Agent 재시작 및 Agent 상태를 확인합니다.
  Datadog Agent Manager를 관리자 권한으로 실행합니다.
  좌측 메뉴(아래 화면)의 Settings를 클릭합니다.
  환경에 맞게 정보들을 수정 후 Save 버튼 클릭 및 Restart Agent를 실행한 후 상단의 상태가 Connected to Agent이면 정상입니다.

④ Kubernetes

본 설치 가이드는 AWS Elastic Kubernetes Service(EKS), Azure Kubernetes Service(AKS), Google Kubernetes Engine(GKE) 등 Kubernetes 환경에 Datadog 에이전트를 설치하는 방법 중 Helm을 이용한 방법을 제공합니다.

Kubernetes 환경의 Datadog agent 구성
Kubernetes 환경에서 Datadog agent의 구성은 아래와 같습니다.
- datadog-node-agent: daemonset으로 각 노드마다 실행되며 노드 레벨의 정보를 수집합니다.
- datadog-cluster-agent: datadog-node-agent에서 Master노드의 API 서버에 직접 쿼리를 하면 클러스터 증가 시 Master노드의 API서버 및 etcd의 로그가 증가하기 때문에 Master 노드의 서버 부하를 줄이기 위해 API서버와 node agent간의 프록시 역할을 합니다.
Datadog agent 설치
- Helm을 설치합니다.
  Datadog Helm repository를 추가 하고, repository를 최신버전으로 업데이트 합니다.
```
helm repo add datadog https://helm.datadoghq.com
helm repo update
```
- values.yaml구성 파일을 사용하여 Datadog Agent를 배포합니다.
  - Helm v3+
    helm install <RELEASE_NAME> -f values.yaml --set datadog.apiKey=<DATADOG_API_KEY> datadog/datadog --set targetSystem=<TARGET_SYSTEM>
    - <TARGET_SYSTEM>: linux 혹은 windows 등 OS명으로 변경합니다.
    - API Key는 Datadog Console 계정 > Organization Settimngs > ACCESS > API Key 에서 KEY를 선택 후 팝업에서 Copy 버튼을 클릭해 API KEY를 복사하시면 됩니다.
  - Helm v1/v2
    helm install -f values.yaml --name <RELEASE_NAME> --set datadog.apiKey=<DATADOG_API_KEY> datadog/datadog
- 설치 수분 후 metrics이 수집됩니다.

■ Agent Uninstall

Linux

RedHat/CentOS

Datadog Agent 패키지를 삭제합니다.

sudo rpm -e <패키지명 예시:datadog-agent-7.50.3-1.x86_64.rpm>
혹은
sudo yum remove datadog-agent

사용자 및 관련 디렉터리(/opt/datadog-agent, /etc/datadog-agent, /var/log/datadog) 를 삭제합니다.

sudo userdel dd-agent && sudo rm -rf /opt/datadog-agent/ && sudo rm -rf /etc/datadog-agent/ && sudo rm -rf /var/log/datadog/

Debian/Ubuntu

Datadog Agent 패키지를 삭제합니다.

sudo apt-get remove datadog-agent -y

혹은 사용자 및 관련 패키지 데이터 모두 삭제합니다.

sudo apt-get remove --purge datadog-agent -y

Windows

Windows 검색 창에서 추가(add)를 검색 후 프로그램 추가/제거(Add or remove programs)를 선택합니다.

Datadog Agent 조회 후 선택해 제거(Uninstall) 버튼을 클릭 해 제거 합니다.

Kubernetes

Helm을 이용해 Datadog agent 와 Helm Chart repository를 삭제 합니다.

helm delete <RELEASE_NAME>
helm repo remove <repo name>