[ Datadog ] Agent Install & Uninstall

인쇄

■ Agent Install

① Linux

RedHat/CentOS 계열

RedHat, CentOS, Amazon Linux, Oracle Linux, Rocky Linux, Fedora 등의 OS가 해당됩니다. 본 설치 가이드는 RedHat/CentOS 6+이상의 내용으로 안내합니다.

- 인터넷망에서 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://s3.amazonaws.com/dd-agent/scripts/install_script_agent7.sh)"
    • 위 Command는 Integration > Agent 메뉴에서 OS를 선택해 확인 가능합니다.

      image-20240221-090956.png
    • 해당 화면에서 Command 복사시 Enable APM Instrumentation(현재 Beta 기능)을 Off로 설정하시기 권장합니다. (Command 내에 DD_APM_INSTRUMENTATION_ENABLED=host 부분 제거)

    • API Key만 확인하고자 하시는 경우, Datadog Console 계정 > Organization Settimngs > ACCESS > API Key 에서 KEY를 선택 후 팝업에서 Copy 버튼을 클릭해 API KEY를 복사하시면 됩니다.

  • Datadog 단계별 설치

    • Datadog을 사용할 host의 yum repository(/etc/yum.repos.d/datadog.repo)를 생성 후 아래 내용을 추가합니다.

      [datadog]
      name=Datadog, Inc.
      baseurl=https://yum.datadoghq.com/stable/7/x86_64/
      enabled=1
      gpgcheck=1
      repo_gpgcheck=1
      gpgkey=https://keys.datadoghq.com/DATADOG_RPM_KEY_CURRENT.public 
             https://keys.datadoghq.com/DATADOG_RPM_KEY_B01082D3.public
             https://keys.datadoghq.com/DATADOG_RPM_KEY_FD4BF915.public
             https://keys.datadoghq.com/DATADOG_RPM_KEY_E09422B3.public
    • Local yum repo의 업데이트 및 Datadog Agent를 설치합니다.

      sudo yum makecache
      sudo yum remove datadog-agent-base
      sudo yum install datadog-agent
    • datadog agent 구성파일 복사 및 API Key를 변경, Datadog site 정보를 추가 합니다.

      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

- 폐쇄망에서 Datadog Agent 설치

  • Datadog 단계별 설치

    • https://yum.datadoghq.com/stable/7/x86_64/ 에서 설치 패키지의 최신버전을 다운로드합니다.
      datadog-agent-7.xx.x-1.x86_64.rpm 형식인 파일 중 최신 버전을 다운로드 받으시기 바랍니다.
      ( 2024년 2월 : https://s3.amazonaws.com/yum.datadoghq.com/stable/7/x86_64/datadog-agent-7.50.3-1.x86_64.rpm)

    • 패키지를 설치합니다

      sudo yum localinstall datadog-agent-7.50.3-1.x86_64.rpm
      혹은
      sudo rpm -ivh ./ datadog-agent-7.43.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 계열

대표적으로 Ubuntu 등의 OS가 해당됩니다. 본 설치 가이드는 Ubuntu 14.04+ 내용으로 안내합니다.

- 인터넷망에서 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://s3.amazonaws.com/dd-agent/scripts/install_script_agent7.sh)"
    • 위 Command는 Integration > Agent 메뉴에서 OS를 선택해 확인 가능합니다.

      image-20240221-090956.png
    • 해당 화면에서 Command 복사시 Enable APM Instrumentation(현재 Beta 기능)을 Off로 설정하시기 권장합니다. (Command 내에 DD_APM_INSTRUMENTATION_ENABLED=host 부분 제거)

    • API Key만 확인하고자 하시는 경우, Datadog Console 계정 > Organization Settimngs > ACCESS > API Key 에서 KEY를 선택 후 팝업에서 Copy 버튼을 클릭해 API KEY를 복사하시면 됩니다.

  • Datadog 단계별 설치

    • apt를 https를 통해 다운로드 받도록 설정하고 curl과 gnupg를 설치합니다.

      sudo apt-get update
      sudo apt-get install apt-transport-https curl gnupg
    • host의 deb repository 생성 및 Datadog archive keyring을 생성합니다.

      sudo sh -c "echo 'deb [signed-by=/usr/share/keyrings/datadog-archive-keyring.gpg] https://apt.datadoghq.com/ stable 7' > /etc/apt/sources.list.d/datadog.list"
      sudo touch /usr/share/keyrings/datadog-archive-keyring.gpg
      sudo chmod a+r /usr/share/keyrings/datadog-archive-keyring.gpg
      curl https://keys.datadoghq.com/DATADOG_APT_KEY_CURRENT.public | sudo gpg --no-default-keyring --keyring /usr/share/keyrings/datadog-archive-keyring.gpg --import --batch
      curl https://keys.datadoghq.com/DATADOG_APT_KEY_C0962C7D.public | sudo gpg --no-default-keyring --keyring /usr/share/keyrings/datadog-archive-keyring.gpg --import --batch
      curl https://keys.datadoghq.com/DATADOG_APT_KEY_F14F620E.public | sudo gpg --no-default-keyring --keyring /usr/share/keyrings/datadog-archive-keyring.gpg --import --batch
      curl https://keys.datadoghq.com/DATADOG_APT_KEY_382E94DE.public | sudo gpg --no-default-keyring --keyring /usr/share/keyrings/datadog-archive-keyring.gpg --import --batch
    • Local apt repo 업데이트 및 Datadog Agent를 설치합니다.

      sudo apt-get update
      sudo apt-get install datadog-agent datadog-signing-keys
    • datadog agent 구성파일 복사 및 API Key를 변경, Datadog site 정보를 추가 합니다.

      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

- 폐쇄망에서 Datadog Agent 설치

  • Datadog 단계별 설치

    • https://apt.datadoghq.com/pool/d/da/ 에서 설치 패키지의 최신버전을 다운로드합니다.
      datadog-agent-7.xx.x-1_arm64.deb 형식인 파일 중 최신 버전을 다운로드 받으시기 바랍니다.
      ( 2024년 2월 : https://s3.amazonaws.com/apt.datadoghq.com/pool/d/da/datadog-agent_7.50.3-1_arm64.deb)

    • 패키지를 설치합니다

      sudo apt install ./datadog-agent_7.50.3-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를 복사하시면 됩니다.

      image-20240222-050318.png
    • Datadog 지역은 http://datadoghq.com 을 선택하고 설치 완료합니다.

      image-20240222-050657.png
    • Datadog Agent 재시작 및 Agent 상태를 확인합니다.
      Datadog Agent Manager를 관리자 권한으로 실행합니다.

      image-20240222-050825.png

      좌측 메뉴(아래 화면)의 Settings를 클릭합니다.
      환경에 맞게 정보들을 수정 후 Save 버튼 클릭 및 Restart Agent를 실행한 후 상단의 상태가 Connected to Agent이면 정상입니다.

      image-20240222-050908.png

③ 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

  1. ddagentuser계정을 생성합니다.

    • 서버 관리자에서 ‘도구’의 ‘Active Directory 사용자 및 컴퓨터’(dsa.msc)를 선택합니다.

    • Domain 정보가 있는 창의 오른쪽 빈 공간에서 마우스 우클릭을 하고, ‘새로 만들기 > 사용자’를 클릭합니다.

    • 사용자 계정 정보에 ddagentuser를 입력하고, ‘Next(다음)’을 클릭합니다.

    • 패스워드 및 암호 정책 설정에 보안 규칙에 맞게 적절한 비밀번호를 지정(*주의할 내용으로는 세미콜론(;)은 사용하면 안됨)하고, 옵션을 적절히 정한 후 Next(다음)’을 클릭합니다.
      옵션은 ‘User must change password at next logon(다음 로그온 시 사용자가 반드시 암호를 변경해야 함)’과 ‘Password never expires(암호 사용 기간 제한 없음)’의 체크박스를 해제하여 비밀번호를 변경할 수 없도록 합니다.

    • 정보를 확인 후 ‘Finish(마침)’를 클릭합니다.

    • 이후 아래와 같이 ddagentuser 사용자 속성에서 정상적으로 등록됐는지 확인합니다.

    • ‘Unlock Account(계정 잠금 해제)’를 체크해서 계정 사용에 문제가 없도록 합니다.

      image-20240222-051243.png
  2. ‘Event Log Readers’ 와 ‘Performance Monitor Users’ 권한을 추가합니다.

    image-20240222-051510.png
  3. 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를 복사하시면 됩니다.

      image-20240222-050318.png
    • Datadog 지역은 http://datadoghq.com 을 선택하고 설치 완료합니다.

      image-20240222-050657.png
    • Datadog Agent 재시작 및 Agent 상태를 확인합니다.
      Datadog Agent Manager를 관리자 권한으로 실행합니다.

      image-20240222-050825.png

      좌측 메뉴(아래 화면)의 Settings를 클릭합니다.
      환경에 맞게 정보들을 수정 후 Save 버튼 클릭 및 Restart Agent를 실행한 후 상단의 상태가 Connected to Agent이면 정상입니다.

      image-20240222-050908.png

④ 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간의 프록시 역할을 합니다.

      image-20240222-052416.png

  • 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>
      • 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)를 선택합니다.

image-20240222-055447.png

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

image-20240222-055552.png

Kubernetes

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

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

온라인상담

문의하기

이 답변이 유용합니까? 아니오

Send feedback
도움이 되어드리지 못해 죄송합니다. 아티클 개선을 위해 의견을 제공해 주시기 바랍니다.