원스텝 설치

원스텝 명령은 Datadog Agent용 APT 패키지를 설치하고 비밀번호를 묻는 메시지를 표시합니다. Agent가 시스템에 아직 설치되어 있지 않고 설치 후 자동으로 시작되지 않도록 하려면 Agent를 실행하기 전에 DD_INSTALL_ONLY=true를 명령 앞에 추가하세요.

MY_API_KEY를 Datadog API 키로 바꿔서 다음 명령을 실행합니다.

DD_API_KEY=MY_API_KEY bash -c "$(curl -L https://raw.githubusercontent.com/DataDog/dd-agent/master/packaging/datadog-agent/source/install_agent.sh)"

단계별 설치

1. HTTPS를 통해 다운로드하고 curl과 gnupg를 설치할 수 있도록 APT를 설정합니다.

   sudo apt-get update
   sudo apt-get install apt-transport-https curl gnupg
   

2. 시스템에 Datadog Debian 리포지토리를 설정하고 Datadog 아카이브 키링을 만듭니다.

   sudo sh -c "echo 'deb [signed-by=/usr/share/keyrings/datadog-archive-keyring.gpg] https://apt.datadoghq.com/ stable main' > /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_06462314.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
   

3. Debian 8 이하를 실행하는 경우 키링을 /etc/apt/trusted.gpg.d에 복사하세요.

   sudo cp -a /usr/share/keyrings/datadog-archive-keyring.gpg /etc/apt/trusted.gpg.d/
   

4. 로컬 APT 리포지토리를 업데이트하고 Agent를 설치합니다.

   sudo apt-get update
   sudo apt-get install datadog-agent datadog-signing-keys
   

5. 다음 명령을 실행하여 예시 구성을 헤당 위치에 복사합니다. MY_API_KEY를 Datadog API 키로 바꿉니다.

   sudo sh -c "sed 's/api_key:.*/api_key:MY_API_KEY /' /etc/dd-agent/datadog.conf.example > /etc/dd-agent/datadog.conf"
   

6. Agent를 시작합니다.

   sudo /etc/init.d/datadog-agent start
   

원스텝 설치

원스텝 명령은 Datadog Agent용 APT 패키지를 설치하고 비밀번호를 묻는 메시지를 표시합니다. Agent가 시스템에 아직 설치되어 있지 않고 설치 후 자동으로 시작되지 않도록 하려면 Agent를 실행하기 전에 DD_INSTALL_ONLY=true를 명령 앞에 추가하세요.

MY_API_KEY를 Datadog API 키로 바꿔서 다음 명령을 실행합니다.

DD_API_KEY=MY_API_KEY bash -c "$(curl -L https://raw.githubusercontent.com/DataDog/dd-agent/master/packaging/datadog-agent/source/install_agent.sh)"

단계별 설치

1. HTTPS를 통해 다운로드하고 curl과 gnupg를 설치할 수 있도록 APT를 설정합니다.

   sudo apt-get update
   sudo apt-get install apt-transport-https curl gnupg
   

2. 시스템에 Datadog Debian 리포지토리를 설정하고 Datadog 아카이브 키링을 만듭니다.

   sudo sh -c "echo 'deb [signed-by=/usr/share/keyrings/datadog-archive-keyring.gpg] https://apt.datadoghq.com/ stable main' > /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_06462314.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
   

3. Debian 8 이하를 실행하는 경우 키링을 /etc/apt/trusted.gpg.d에 복사하세요.

   sudo cp -a /usr/share/keyrings/datadog-archive-keyring.gpg /etc/apt/trusted.gpg.d/
   

4. 로컬 APT 리포지토리를 업데이트하고 Agent를 설치합니다.

   sudo apt-get update
   sudo apt-get install datadog-agent datadog-signing-keys
   

5. 다음 명령을 실행하여 예제 구성을 복사합니다. MY_API_KEY를 Datadog API 키로 바꿉니다.

   sudo sh -c "sed 's/api_key:.*/api_key:MY_API_KEY /' /etc/dd-agent/datadog.conf.example > /etc/dd-agent/datadog.conf"
   

6. Agent를 시작합니다.

   sudo /etc/init.d/datadog-agent start
   

설치 제거

에이전트를 삭제하려면 다음 명령을 실행합니다.

sudo apt-get remove datadog-agent -y

이 명령어를 사용하면 Agent가 삭제되나, 다음은 삭제되지 않습니다.

• datadog.yaml 설정 파일
• /etc/dd-agent 설정 폴더에 있는 사용자 생성 파일
• /opt/datadog-agent 폴더에서 사용자가 생성한 파일
• dd-agent 사용자
• Datadog 로그 파일

이들 요소도 제거하려면 에이전트 제거 후 이 명령을 실행합니다.

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

원스텝 설치

원스텝 명령은 Datadog Agent용 YUM 패키지를 설치하고 비밀번호를 묻는 메시지를 표시합니다. Agent가 시스템에 아직 설치되어 있지 않고 설치 후 자동으로 시작되지 않도록 하려면, Agent를 실행하기 전에 DD_INSTALL_ONLY=true를 명령 앞에 추가하세요.

MY_API_KEY를 Datadog API 키로 바꿔서 다음 명령을 실행합니다.

DD_API_KEY=MY_API_KEY bash -c "$(curl -L https://raw.githubusercontent.com/DataDog/dd-agent/master/packaging/datadog-agent/source/install_agent.sh)"

단계별 설치

1. 다음에 따라 /etc/yum.repos.d/datadog.repo를 생성해 Datadog YUM 리포지토리를 구성합니다.

   [datadog]
   name=Datadog, Inc.
   baseurl=https://yum.datadoghq.com/rpm/x86_64/
   enabled=1
   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
   

   참고: i386/i686 아키텍처의 경우 “x86_64"를 “i386"로 변경하세요.

2. 로컬 Yum 저장소를 업데이트하고 Agent를 설치하세요.

   sudo yum makecache
   sudo yum install datadog-agent
   

3. 예시 구성을 해당 위치에 복사합니다. MY_API_KEY를 Datadog API 키로 바꿉니다.

   sudo sh -c "sed 's/api_key:.*/api_key:MY_API_KEY /' /etc/dd-agent/datadog.conf.example > /etc/dd-agent/datadog.conf"
   

4. Agent를 재시작합니다.

   sudo /etc/init.d/datadog-agent restart
   

설치 제거

에이전트를 삭제하려면 다음 명령을 실행합니다.

sudo yum remove datadog-agent

이 명령어를 사용하면 Agent가 삭제되나, 다음은 삭제되지 않습니다.

• datadog.yaml 설정 파일
• /etc/dd-agent 설정 폴더에 있는 사용자 생성 파일
• /opt/datadog-agent 폴더에서 사용자가 생성한 파일
• dd-agent 사용자
• Datadog 로그 파일

이들 요소도 제거하려면 에이전트 제거 후 이 명령을 실행합니다.

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

원스텝 설치

원스텝 명령은 Datadog Agent용 YUM 패키지를 설치하고 비밀번호를 묻는 메시지를 표시합니다. Agent가 시스템에 아직 설치되어 있지 않고 설치 후 자동으로 시작되지 않도록 하려면, Agent를 실행하기 전에 DD_INSTALL_ONLY=true를 명령 앞에 추가하세요.

MY_API_KEY를 Datadog API 키로 바꿔서 다음 명령을 실행합니다.

DD_API_KEY=MY_API_KEY bash -c "$(curl -L https://raw.githubusercontent.com/DataDog/dd-agent/master/packaging/datadog-agent/source/install_agent.sh)"

단계별 설치

1. 다음에 따라 /etc/yum.repos.d/datadog.repo를 생성해 Datadog YUM 리포지토리를 구성합니다.

   [datadog]
   name=Datadog, Inc.
   baseurl=https://yum.datadoghq.com/rpm/x86_64/
   enabled=1
   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
   

   참고: i386/i686 아키텍처의 경우 “x86_64"를 “i386"로 변경하세요.

2. 로컬 YUM 리포지토리를 업데이트하고 Agent를 설치합니다.

   sudo yum makecache
   sudo yum remove datadog-agent-base 
   sudo yum install datadog-agent
   

3. 예시 구성을 헤당 위치에 복사합니다. MY_API_KEY를 Datadog API 키로 바꿉니다.

   sudo sh -c "sed 's/api_key:.*/api_key:MY_API_KEY /' /etc/dd-agent/datadog.conf.example > /etc/dd-agent/datadog.conf"
   

4. Agent를 재시작합니다.

   sudo /etc/init.d/datadog-agent restart
   

설치 제거

에이전트를 삭제하려면 다음 명령을 실행합니다.

sudo yum remove datadog-agent

이 명령어를 사용하면 Agent가 삭제되나, 다음은 삭제되지 않습니다.

• datadog.yaml 설정 파일
• /etc/dd-agent 설정 폴더에 있는 사용자 생성 파일
• /opt/datadog-agent 폴더에서 사용자가 생성한 파일
• dd-agent 사용자
• Datadog 로그 파일

이들 요소도 제거하려면 에이전트 제거 후 이 명령을 실행합니다.

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

원스텝 설치

원스텝 명령은 Datadog Agent용 YUM 패키지를 설치하고 비밀번호를 묻는 메시지를 표시합니다. Agent가 시스템에 아직 설치되어 있지 않고 설치 후 자동으로 시작되지 않도록 하려면, Agent를 실행하기 전에 DD_INSTALL_ONLY=true를 명령 앞에 추가하세요.

MY_API_KEY를 Datadog API 키로 바꿔서 다음 명령을 실행합니다.

DD_API_KEY=MY_API_KEY bash -c "$(curl -L https://raw.githubusercontent.com/DataDog/dd-agent/master/packaging/datadog-agent/source/install_agent.sh)"

단계별 설치

1. 다음에 따라 /etc/yum.repos.d/datadog.repo를 생성해 Datadog YUM 리포지토리를 구성합니다.

   [datadog]
   name=Datadog, Inc.
   baseurl=https://yum.datadoghq.com/rpm/x86_64/
   enabled=1
   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
   

   참고: i386/i686 아키텍처의 경우 “x86_64"를 “i386"로 변경하세요.

2. 로컬 YUM 리포지토리를 업데이트하고 Agent를 설치합니다.

   sudo yum makecache
   sudo yum install datadog-agent
   

3. 예시 구성을 헤당 위치에 복사합니다. MY_API_KEY를 Datadog API 키로 바꿉니다.

   sudo sh -c "sed 's/api_key:.*/api_key:MY_API_KEY /' /etc/dd-agent/datadog.conf.example > /etc/dd-agent/datadog.conf"
   

4. Agent를 재시작합니다.

   sudo /etc/init.d/datadog-agent restart
   

설치 제거

에이전트를 삭제하려면 다음 명령을 실행합니다.

sudo yum remove datadog-agent

이 명령어를 사용하면 Agent가 삭제되나, 다음은 삭제되지 않습니다.

• datadog.yaml 설정 파일
• /etc/dd-agent 설정 폴더에 있는 사용자 생성 파일
• /opt/datadog-agent 폴더에서 사용자가 생성한 파일
• dd-agent 사용자
• Datadog 로그 파일

이들 요소도 제거하려면 에이전트 제거 후 이 명령을 실행합니다.

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

원스텝 설치

원스텝 명령은 Datadog Agent용 YUM 패키지를 설치하고 비밀번호를 묻는 메시지를 표시합니다. Agent가 시스템에 아직 설치되어 있지 않고 설치 후 자동으로 시작되지 않도록 하려면, Agent를 실행하기 전에 DD_INSTALL_ONLY=true를 명령 앞에 추가하세요.

MY_API_KEY를 Datadog API 키로 바꿔서 다음 명령을 실행합니다.

DD_API_KEY=MY_API_KEY bash -c "$(curl -L https://raw.githubusercontent.com/DataDog/dd-agent/master/packaging/datadog-agent/source/install_agent.sh)"

단계별 설치

1. 다음에 따라 /etc/yum.repos.d/datadog.repo를 생성해 Datadog YUM 리포지토리를 구성합니다.

   [datadog]
   name=Datadog, Inc.
   enabled=1
   baseurl=https://yum.datadoghq.com/suse/rpm/x86_64
   type=rpm-md
   gpgcheck=1
   repo_gpgcheck=0
   gpgkey=https://keys.datadoghq.com/DATADOG_RPM_KEY_B01082D3.public
   gpgkey=https://keys.datadoghq.com/DATADOG_RPM_KEY_FD4BF915.public
   

2. 로컬 Zypper 리포지토리를 업데이트하고 Agent를 설치합니다.

   sudo zypper refresh
   sudo zypper install datadog-agent
   

3. 예시 구성을 헤당 위치에 복사합니다. MY_API_KEY를 Datadog API 키로 바꿉니다.

   sudo sh -c "sed 's/api_key:.*/api_key: MY_API_KEY/' /etc/dd-agent/datadog.conf.example > /etc/dd-agent/datadog.conf"
   

4. Agent를 재시작합니다.

   sudo /etc/init.d/datadog-agent restart
   

설치 제거

에이전트를 삭제하려면 다음 명령을 실행합니다.

sudo zypper remove datadog-agent

이 명령어를 사용하면 Agent가 삭제되나, 다음은 삭제되지 않습니다.

• datadog.yaml 설정 파일
• /etc/dd-agent 설정 폴더에 있는 사용자 생성 파일
• /opt/datadog-agent 폴더에서 사용자가 생성한 파일
• dd-agent 사용자
• Datadog 로그 파일

이들 요소도 제거하려면 에이전트 제거 후 이 명령을 실행합니다.

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

원스텝 설치

원스텝 명령은 Datadog Agent용 최신 BFF 패키지를 설치하고 필요 시 비밀번호를 묻는 메시지를 표시합니다. Agent가 시스템에 아직 설치되어 있지 않고 설치 후 자동으로 시작되지 않도록 하려면, Agent를 실행하기 전에 DD_INSTALL_ONLY=true를 명령 앞에 추가하세요.

MY_API_KEY를 Datadog API 키로 바꿔서 다음 명령을 실행합니다.

DD_API_KEY=MY_API_KEY bash -c "$(curl -L https://raw.githubusercontent.com/DataDog/dd-agent/master/packaging/datadog-agent/source/install_agent.sh)"

이전 설치에서 업그레이드

기존 구성을 유지하면서 Agent를 설치하려면 다음 명령을 실행합니다.

DD_UPGRADE=true ksh -c "$(curl -L https://raw.githubusercontent.com/DataDog/datadog-unix-agent/master/scripts/install_script.sh)"

사용 가능한 설치 스크립트 환경 변수의 전체 목록은 AIX용 기본 Agent 사용법을 참조하세요.

단계별 설치

1. datadog-unix-agent 리포지토리 릴리스에서 선호하는 BFF를 다운로드하세요.
2. installp로 루트 권한으로 아티팩트를 설치합니다.

   installp -aXYgd datadog-unix-agent-latest.powerpc.aix..bff datadog-unix-agent
   

3. 기존 구성 파일이 없는 경우 예시 구성을 해당 위치에 복사합니다. MY_API_KEY를 Datadog API 키로 바꿉니다.

   sudo sh -c "sed 's/api_key:.*/api_key: MY_API_KEY/' /etc/datadog-agent/datadog.yaml.example > /etc/datadog-agent/datadog.yaml"
   

4. Datadog Agent에 올바른 권한이 있는지 확인합니다.

   sudo sh -c "chown dd-agent:dd-agent /etc/datadog-agent/datadog.yaml && chmod 660 /etc/datadog-agent/datadog.yaml"
   

5. 서비스형 Agent를 중지합니다.

   sudo stopsrc -s datadog-agent
   

6. 서비스형 Agent가 중지되었는지 확인합니다.

   sudo lssrc -s datadog-agent
   

7. 서비스형 Agent를 재시작합니다.

   sudo startsrc -s datadog-agent
   

설치 제거

에이전트를 삭제하려면 다음 명령을 실행합니다.

설치된 에이전트를 제거하려면 다음 installp 명령을 실행하세요.

installp -e dd-aix-uninstall.log -uv datadog-unix-agent

참고: 에이전트 설치 제거 로그는 dd-aix-install.log 파일에서 찾을 수 있습니다. 이 로깅을 비활성화하려면 설치 제거 명령에서 ‘-e’ 매개변수를 제거하세요.

에이전트 설치

DaemonSets로 설치

Kubernetes 버전 1.1.0 이하를 실행하는 경우, DaemonSets를 활용하여 Datadog Agent를 모든 노드에 자동 배포할 수 있습니다.

1. API 키가 포함된 시크릿을 생성합니다. 해당 시크릿은 Datadog Agent 배포를 위한 매니페스트에서 사용됩니다. MY_API_KEY를 Datadog API 키로 바꿉니다.

   kubectl create secret generic datadog-secret --from-literal api-key =" MY_API_KEY"
   

2. dd-agent.yaml이라는 이름의 다음 매니페스트를 생성합니다.

   apiVersion: extensions/v1beta1
   kind: DaemonSet
   metadata:
   name: dd-agent
   spec:
   template:
      metadata:
         labels:
         app: dd-agent
         name: dd-agent
      spec:
         containers:
         - image: gcr.io/datadoghq/docker-dd-agent:latest
         imagePullPolicy: Always
         name: dd-agent
         ports:
            - containerPort: 8125
               name: dogstatsdport
               protocol: UDP
         env:
            - name: DD_API_KEY
               valueFrom:
               secretKeyRef:
                  name: datadog-secret
                  key: api-key
            - name: KUBERNETES
               value: "yes"
            - name: SD_BACKEND
               value: docker
            # Uncomment this variable if the agent has issues reaching kubelet
            # - name: KUBERNETES_KUBELET_HOST
            #   valueFrom:
            #     fieldRef:
            #       fieldPath: status.hostIP  # Kubernetes >= 1.7
            #       # or
            #       # fieldPath: spec.nodeName  # Kubernetes < 1.7
         resources:
            requests:
               memory: "256Mi"
               cpu: "200m"
            limits:
               memory: "256Mi"
               cpu: "200m"
         volumeMounts:
            - name: dockersocket
               mountPath: /var/run/docker.sock
            - name: procdir
               mountPath: /host/proc
               readOnly: true
            - name: cgroups
               mountPath: /host/sys/fs/cgroup
               readOnly: true
         livenessProbe:
            exec:
               command:
               - ./probe.sh
            initialDelaySeconds: 15
            periodSeconds: 5
         volumes:
         - hostPath:
               path: /var/run/docker.sock
            name: dockersocket
         - hostPath:
               path: /proc
            name: procdir
         - hostPath:
               path: /sys/fs/cgroup
            name: cgroups
   

3. DaemonSet을 배포합니다.

   kubectl create -f dd-agent.yaml
   

Docker 컨테이너로 Agent 실행

Kubernetes 1.1.0 이상 버전을 실행하지 않거나 DaemonSets를 사용하지 않으려면, 모니터링하려는 각 노드에서 Agent를 Docker 컨테이너로 실행합니다. 다음 명령을 실행하여 MY_API_KEY를 Datadog API 키로 바꿉니다.

docker run -d --name dd-agent -h `hostname` -v /var/run/docker.sock:/var/run/docker.sock:ro -v /proc/:/host/proc/:ro -v /sys/fs/cgroup/:/host/sys/fs/cgroup:ro -e API_KEY=MY_API_KEY -e KUBERNETES=yes -e SD_BACKEND=docker gcr.io/datadoghq/docker-dd-agent:latest

커스텀 메트릭 전송하기

DogStatsD를 사용해 커스텀 메트릭을 전송하려는 경우

1. 매니페스트의 ports 섹션에 hostPort를 추가하여 컨테이너의 StatsD 포트를 노드의 IP 주소에 바인딩합니다.

   ports:
     - containerPort: 8125
       hostPort: 8125
       name: dogstatsdport
       protocol: UDP
   

2. 클라이언트 라이브러리가 노드의 IP로 UDP 패킷을 전송하도록 구성합니다. 브리지 네트워킹을 사용하는 경우 애플리케이션 컨테이너의 기본 게이트웨이는 노드의 IP와 일치합니다. 하향 API로 노드의 호스트 이름을 환경 변수로 노출할 수도 있습니다.

Agent 구성 커스텀하기

Agent 구성을 커스텀하려면 Agent 5 docker-dd-agent 리포지토리의 문서를 참조하세요. Autodiscovery 구성을 조정하려면 Kubernetes 통합 Autodiscovery를 참조하세요. Autodiscovery를 비활성화하려면 매니페스트에서 SD_BACKEND 환경 변수를 삭제하세요.

메트릭 수집, 서비스 점검, 이벤트에 대한 자세한 내용은 Kubernetes 통합 문서를 참조하세요.

원스텝 설치

원스텝 설치는 Datadog Agent가 내장된 Docker 컨테이너를 실행하여 호스트를 모니터링합니다. Docker 통합은 기본적으로 활성화되며, 자동 구성 모드에서는 autodiscovery도 활성화됩니다. autodiscovery를 비활성화하려면 원스텝 설치 명령에서 SD_BACKEND 변수를 삭제하세요.

Amazon Linux

MY_API_KEY를 Datadog API 키로 바꿔서 다음 명령을 실행합니다.

docker run -d --name dd-agent -v /var/run/docker.sock:/var/run/docker.sock:ro -v /proc/:/host/proc/:ro -v /cgroup/:/host/sys/fs/cgroup:ro -e API_KEY=MY_API_KEY -e SD_BACKEND=docker gcr.io/datadoghq/docker-dd-agent:latest

기타 운영체제

MY_API_KEY를 Datadog API 키로 바꿔서 다음 명령을 실행합니다.

docker run -d --name dd-agent -v /var/run/docker.sock:/var/run/docker.sock:ro -v /proc/:/host/proc/:ro -v /sys/fs/cgroup/:/host/sys/fs/cgroup:ro -e API_KEY=MY_API_KEY -e SD_BACKEND=docker gcr.io/datadoghq/docker-dd-agent:latest

트러블슈팅

원스텝 설치 명령이 작동하지 않을 경우에는 시스템이 cgroup 디렉터리를 예상치 못한 위치에 마운트했거나, 메모리 관리에 CGroup을 사용하지 않기 때문일 수 있습니다. Docker 점검을 성공적으로 실행하려면 CGroup이 필요합니다. CGroup을 활성화하려면 docker-dd-agent 리포지토리의 문서를 참조하세요. 예상치 못한 cgroup 디렉터리 위치로 인해 점검에 실패하는 경우는 다음을 참고하세요.

1. mount | grep "cgroup type tmpfs"를 실행해 cgroup 디렉터리 위치를 불러옵니다.
2. 원스텝 설치 명령에서 나오는 첫 번째 /sys/fs/cgroup를 cgroup 디렉터리 위치로 변경합니다.

커스텀 메트릭 전송하기

DogStatsD를 사용해 커스텀 메트릭을 전송하는 방법

1. 설치 명령에 -p 8125:8125/udp 옵션을 추가합니다. 이렇게 하면 컨테이너의 StatsD 포트가 호스트 IP 주소에 바인딩됩니다.
2. 클라이언트 라이브러리를 구성하여 호스트 IP 주소로 UDP 패킷을 전송합니다.

Agent 구성 커스텀하기

Agent 구성을 커스텀하려면 Agent 5 docker-dd-agent 리포지토리의 문서를 참조하세요. Autodiscovery 구성을 조정하려면 Docker 통합 Autodiscovery를 참조하세요. Autodiscovery를 비활성화하려면 원스텝 설치 명령에서 SD_BACKEND 환경 변수를 삭제하세요.

CoreOS Container Linux는 Docker 런타임 실행이 지원됩니다. 설치 방법은 Docker 문서를 참고하세요.

Kubernetes에서 CoreOS Tectonic을 실행하려면 Kubernetes를 참조하세요.

Datadog을 OpenShift에 설치하는 방법에 관한 내용은 datadog-openshift 리포지토리를 참조하세요.

1. BOSH Director에 Datadog Agent 릴리스 업로드

   # BOSH CLI v1
   bosh upload release https://cloudfoundry.datadoghq.com/datadog-agent/datadog-agent-boshrelease-latest.tgz
   
   # BOSH CLI v2
   bosh upload-release https://cloudfoundry.datadoghq.com/datadog-agent/datadog-agent-boshrelease-latest.tgz
   

2. 런타임 구성에서 Datadog을 애드온으로 구성합니다. MY_API_KEY를 Datadog API 키로 바꿉니다.

   # runtime.yml
   ---
   releases:
   - name: datadog-agent
      version: $UPLOADED_VERSION # e.g. 1.0.5140
   
   addons:
   - name: datadog
   jobs:
   - name: dd-agent
      release: datadog-agent
   properties:
      dd:
         use_dogstatsd: yes
         dogstatsd_port: 18125 # Many Cloud Foundry deployments have their own StatsD listening on port 8125
         api_key: MY_API_KEY
         tags: ["my-cloud-foundry-deployment"] # optional. Add any tags you wish
         # Optionally, enable any Agent Checks here
         # integrations:
         #   directory:
         #     init_config: {}
         #     instances:
         #       directory: "."
   

3. 런타임 구성에 런타임을 추가합니다.

   # BOSH cli v1
   bosh update runtime-config runtime.yml
   
   # BOSH cli v2
   bosh update-runtime-config runtime.yml
   

4. 기존 배포를 재배포합니다.

   # BOSH cli v1
   bosh deployment myDeployment.yml
   bosh -n deploy
   
   # BOSH cli v2
   bosh -n -d myDeployment deploy myDeployment.yml
   

사전 필수 조건

윈도우즈(Windows)

Datadog Ansible Collection으로 Windows 호스트를 관리하려면 먼저 ansible.windows 컬렉션을 설치합니다.

ansible-galaxy collection install ansible.windows

openSUSE 및 SLES

Datadog Ansible Collection으로 openSUSE/SLES 호스트를 관리하려면 먼저 community.general 컬렉션을 설치합니다.

ansible-galaxy collection install community.general

Datadog 설치

1. Ansible 서버의 Ansible Galaxy에서 Datadog Ansible Collection을 설치합니다.

   ansible-galaxy collection install datadog.dd
   

   • Datadog Ansible Collection은 Red Hat의 공식 인증을 받은 Red Hat Automation Hub를 통해서도 제공됩니다.
   • Collection을 설치할 것을 권장합니다. 필요한 경우 독립 실행 역할로 Datadog을 설치할 수도 있습니다.

2. Datadog Agent를 호스트에 배포하려면 Datadog 역할과 API 키를 플레이북에 추가합니다. MY_API_KEY를 Datadog API 키로 바꿉니다.

   - hosts: servers
   tasks:
      - name: Import the Datadog Agent role from the Datadog collection
         import_role:
         name: datadog.dd.agent
   vars:
      datadog_api_key: "MY_API_KEY"
      datadog_agent_major_version: 5
   

   Agent가 호스트를 그룹화하게 하려면, Datadog Agent이 추적 중인 노드 호스트 이름만 사용합니다. 다음 명령으로 Agent가 추적하는 호스트 이름을 확인할 수 있습니다.

   service datadog-agent info
   

특정 Agent 점검

노드 중 하나에서 특정 Agent를 점검하거나 통합을 사용하려면 datadog_checks 변수를 활용합니다. 다음은 프로세스 점검 예시입니다.

- hosts: servers
  tasks:
    - name: Import the Datadog Agent role from the Datadog collection
      import_role:
        name: datadog.dd.agent
  vars:
    datadog_api_key: "MY_API_KEY"
    datadog_agent_major_version: 5
    datadog_checks:
      process:
        init_config:
        instances:
          - name: ssh
            search_string: ['ssh', 'sshd']
          - name: syslog
            search_string: ['rsyslog']
            cpu_check_interval: 0.2
            exact_match: true
            ignore_denied_access: true

독립 실행 역할에 관한 Github 리포지토리에서 더 많은 Agent 역할 사용 예시를 찾을 수 있습니다.

메트릭 및 이벤트

Ansible 실행 후 Datadog에서 메트릭 및 이벤트를 가져오려면 Ansible 콜백 프로젝트의 Github Page를 참조하세요.

1. Puppet의 Puppet Forge에서 datadog_agent 모듈을 설치하세요.

   • 새로 설치하려면 module install command를 실행하세요.

     puppet module install datadog-datadog_agent
     

   • 모듈이 이미 설치되어 있는 경우 업그레이드합니다.

     puppet module upgrade datadog-datadog_agent
     

2. Datadog Agent를 노드에 배포하려면 이 매니페스트에 파라미터화된 클래스를 추가합니다. MY_API_KEY를 Datadog API 키로 바꿉니다.

   node "db1.mydomain.com" {
      class { "datadog_agent":
         api_key => "MY_API_KEY"
      }
   }
   

   Agent가 호스트를 그룹화하게 하려면, Datadog Agent이 추적 중인 노드 호스트 이름만 사용합니다. 다음 명령으로 Agent가 추적하는 호스트 이름을 확인할 수 있습니다.

   service datadog-agent info
   

3. Puppet 서버에서 Datadog으로 리포트를 활성화합니다.

   1. /etc/puppet/puppet.conf에 다음 파라미터를 추가합니다.

      [master]
      report = true
      reports = datadog_reports
      pluginsync = true
      
      [agent]
      report = true
      pluginsync = true
      

   2. 매니페스트에서 Puppet 서버에 puppet_run_reports 옵션을 추가합니다. 예시:

      node "puppet" {
         class { "datadog_agent":
            api_key            => "MY_API_KEY",
            puppet_run_reports => true
            }
      }
      

4. Puppet 서버에서 Puppet을 실행하여 필요한 모든 종속성을 설치합니다.

5. Puppet 서버를 재시작하여 Datadog에서 Puppet 데이터 수신을 시작합니다.

특정 Agent 점검

노드 중 하나에서 특정 Agent를 점검하거나 통합을 사용하려면 통합 매니페스트에서 코드 예시를 확인하세요. 다음은 Elasticsearch 통합 예시입니다.

node "elastic-node1.mydomain.com" {
    class { "datadog_agent":
        api_key => ""
    }
    include "datadog_agent::integrations::elasticsearch"
}

1. Datadog 쿡북을 추가합니다.

   • Berkshelf를 사용하는 경우 Berkfile에 쿡북을 추가합니다.

     cookbook 'datadog'
     

   • Berkshelf를 사용하지 않는 경우 Knife를 사용하여 리포지토리에 쿡북을 설치합니다.

     knife cookbook site install datadog 
     

2. 역할, 환경 또는 다른 레시피에서 Datadog 특정 속성을 설정합니다. MY_API_KEY를 Datadog API 키로 바꿉니다.

   node.default['datadog']['api_key'] = "MY_API_KEY"
   # Use an existing application key or create a new one for Chef
   node.default['datadog']['application_key'] = "Generate Application Key"
   

3. 업데이트된 쿡북을 Chef 서버에 업로드합니다.

   berks upload
   # or
   knife cookbook upload datadog
   knife cookbook list | grep datadog && 
   echo -e "e[0;32mdatadog cookbook - OKe[0m" ||
   echo -e "e[0;31mmissing datadog cookbook - OKe[0m"
   

4. 노드의 run_list 또는 role에 쿡북을 추가합니다.

   "run_list": [
    "recipe[datadog::dd-agent]"
   ]
   

5. 다음 chef-client 실행 일정까지 기다립니다.

gitfs_remotes를 사용해 설치하기

1. Salt Master 설정 파일(기본 설정: /etc/salt/master)에서 gitfs_remotes 옵션을 사용하여 Salt Master 노드의 베이스 환경에 Datadog 포뮬러를 설치합니다.

   fileserver_backend:
   - roots # Active by default, necessary to be able to use the local salt files we define in the next steps
   - gitfs # Adds gitfs as a fileserver backend to be able to use gitfs_remotes
   
   gitfs_remotes:
   - https://github.com/DataDog/datadog-formula.git:
     - saltenv:
       - base:
       - ref: 3.0 # Pin here the version of the formula you want to use
   

2. Salt Master 서비스를 재시작

   systemctl restart salt-master
   

   또는

   service salt-master restart
   

Datadog 포뮬러를 복제하여 설치

1. Salt Master 노드에 Datadog 포뮬러를 복제합니다.

   mkdir -p /srv/formulas && cd /srv/formulas git clone https://github.com/DataDog/datadog-formula.git
   

2. 복제한 포뮬러를 Salt Master 구성 파일(기본값: /etc/salt/master)의 file_roots 기본 환경에 추가합니다.

   file_roots:
     base:
       - /srv/salt/
       - /srv/formulas/datadog-formula/
   

호스트에 Agent 배포하기

1. Datadog 포뮬러를 상단 파일에 추가합니다(기본값: /srv/salt/top.sls).

   base:
     '*':
       - datadog
   

2. datadog.sls Pillar 파일을 Pillar 디렉터리(기본값: /srv/pillar/)에 추가하고 API 키를 추가합니다. MY_API_KEY를 Datadog API 키로 바꿉니다.

   datadog:
     config:
       api_key: MY_API_KEY
     install_settings:
       agent_version: <AGENT5_VERSION>
   

3. datadog.sls Pillar 파일을 상단 Pillar 파일(기본값: /srv/pillar/top.sls)에 추가합니다.

   base:
     '*':
       - datadog
   

4. 호스트 중 하나에서 특정 Agent를 점검하거나 통합을 사용하려면 점검 변수를 활용합니다. 다음은 디렉터리 통합의 예시입니다.

   datadog:
     config:
       api_key: MY_API_KEY
     install_settings:
       agent_version: <AGENT5_VERSION>
     checks:
       directory:
         config:
           instances:
             - directory: "/srv/pillar"
               name: "pillars"
   

로그 구성, 점검 예시, 고급 사용 사례는 포뮬러 Github 리포지토리를 참조하세요.