설치

DaemonSets를 사용해 모든 노드(또는 nodeSelectors를 사용한 특정 노드)에서 Datadog Agent를 배포할 수 있습니다.

Datadog 에이전트를 쿠버네티스 클러스터에 설치하려면:

1. 에이전트 권한을 설정합니다: 쿠버네티스에 역할 기반 액세스 제어(RBAC)가 활성화되어 있는 경우, Datadog 에이전트 서비스 계정에 대한 RBAC 권한을 설정합니다. 쿠버네티스 1.6 이상부터는 RBAC가 기본적으로 활성화됩니다. 다음 명령으로 적절한 ClusterRole, ServiceAccount, ClusterRoleBinding을 생성합니다:

   kubectl apply -f "https://raw.githubusercontent.com/DataDog/datadog-agent/master/Dockerfiles/manifests/rbac/clusterrole.yaml"
   
   kubectl apply -f "https://raw.githubusercontent.com/DataDog/datadog-agent/master/Dockerfiles/manifests/rbac/serviceaccount.yaml"
   
   kubectl apply -f "https://raw.githubusercontent.com/DataDog/datadog-agent/master/Dockerfiles/manifests/rbac/clusterrolebinding.yaml"
   

   참고: 이러한 RBAC 설정은 default네임스페이스를 위한 것입니다. 커스텀 네임스페이스인 경우 적용하기 전에 namespace 매개 변수를 업데이트하세요.

2. Datadog 에이전트 매니페스트를 생성합니다. 다음 템플릿 중 하나를 사용하여 datadog-agent.yaml 매니페스트를 생성하세요:

   메트릭	로그	APM	프로세스	NPM	보안	Linux	Windows
   						Manifest 템플릿	Manifest 템플릿 (보안 없음)
   						매니페스트 템플릿	매니페스트 템플릿
   						Manifest 템플릿	Manifest 템플릿
   						Manifest 템플릿	Manifest 템플릿
   						Manifest 템플릿	템플릿 없음
   						Manifest 템플릿	Manifest 템플릿

   트레이스 수집을 완전히 활성화하려면 애플리케이션 포드 구성에서 추가 단계가 필요합니다. 각 기능을 개별적으로 활성화하는 방법은 로그, APM (애플리케이션 성능 모니터링), 프로세스, 클라우드 네트워크 모니터링, 보안 설명서 페이지도 참조하세요.

   참고: 이러한 매니페스트는 default 네임스페이스를 위한 것입니다. 커스텀 네임스페이스인 경우 metadata.namespace 매개 변수를 업데이트한 후에 적용하세요.

3. secret-api-key.yaml 매니페스트에서 PUT_YOUR_BASE64_ENCODED_API_KEY_HERE를 base64로 인코딩된 Datadog API 키로 바꿉니다. API 키의 base64 버전을 얻으려면 다음을 실행하세요:

   echo -n '<Your API key>' | base64
   

4. datadog-agent-all-features.yaml 매니페스트 템플릿을 사용하는 경우 secret-cluster-agent-token.yaml 매니페스트에서 PUT_A_BASE64_ENCODED_RANDOM_STRING_HERE를 base64의 임의 문자열로 교체합니다. base64 버전을 가져오려면 다음을 실행합니다.

   echo -n 'Random string' | base64
   

   참고: 클러스터 에이전트 간 통신을 보호하려면 임의 문자열에 영숫자 32자 이상이 포함되어야 합니다.

5. datadog-agent.yaml 매니페스트에서 DD_SITE 환경 변수를 사용하여 Datadog 사이트를 로 설정합니다.

   참고: DD_SITE 환경 변수가 명시적으로 설정되지 않은 경우 기본값은 US 사이트 datadoghq.com입니다. 다른 사이트를 사용하는 경우 잘못된 API 키 메시지가 표시됩니다. 사용 중인 사이트에 적합한 설명서를 보려면 설명서 사이트 선택기를 사용하세요.

6. 명령어와 함께 데몬셋을 배포합니다:

   kubectl apply -f datadog-agent.yaml
   

7. 확인: Datadog 에이전트가 사용자 환경에서 데몬셋으로 실행되고 있는지 확인하려면, 다음을 실행합니다:

   kubectl get daemonset
   

   에이전트가 배포되면 아래 텍스트와 유사한 출력이 표시되며, DESIRED와 CURRENT는 클러스터에서 실행 중인 노드 수와 동일합니다.

   NAME      DESIRED   CURRENT   READY     UP-TO-DATE   AVAILABLE   NODE SELECTOR   AGE
   datadog   2         2         2         2            2           <none>          10s
   

설정

트레이스 수집

  # (...)
  containers:
  - name: trace-agent
    # (...)
    env:
    - name: DD_APM_ENABLED
      value: "true"
    - name: DD_APM_RECEIVER_SOCKET
      value: "/var/run/datadog/apm.socket"
  # (...)
    volumeMounts:
    - name: apmsocket
      mountPath: /var/run/datadog/
  volumes:
  - hostPath:
      path: /var/run/datadog/
      type: DirectoryOrCreate
  # (...)

로그 수집

참고: 이 옵션은 Windows에서 지원되지 않습니다. 대신 Helm 옵션을 사용하세요.

DaemonSet으로 로그 수집을 활성화하는 방법:

1. datadog.yaml Agent 매니페스트의 env 섹션에서 DD_LOGS_ENABLED 및 DD_LOGS_CONFIG_CONTAINER_COLLECT_ALL 변수를 true로 설정합니다:

    # (...)
     env:
       # (...)
       - name: DD_LOGS_ENABLED
         value: "true"
       - name: DD_LOGS_CONFIG_CONTAINER_COLLECT_ALL
         value: "true"
       - name: DD_CONTAINER_EXCLUDE_LOGS
         value: "name:datadog-agent"
    # (...)
   

   참고: DD_CONTAINER_EXCLUDE_LOGS를 설정하면 Datadog Agent에서 자체 로그를 수집하고 전송하지 않습니다. Datadog Agent 로그를 수집하려면 이 파라미터를 제거하세요. 자세한 내용은 컨테이너 무시용 환경 변수를 참조하세요. OpenShift 환경 내에서 ImageStream을 사용하는 경우, name 컨테이너와 함께 DD_CONTAINER_INCLUDE_LOGS를 설정하여 로그를 수집하세요. 이 두 Exclude/Include 파라미터 값은 모두 정규식을 지원합니다.

2. 재시작 또는 네트워크 문제 시 컨테이너 로그의 손실을 방지하기 위해 pointerdir 볼륨을 마운트하고, /var/log/pods가 디렉터리의 symlink이므로 Kubernetes 로그 파일을 통해 로그를 수집할 수 있도록 /var/lib/docker/containers 볼륨도 마운트합니다.

     # (...)
       volumeMounts:
         # (...)
         - name: pointerdir
           mountPath: /opt/datadog-agent/run
         - name: logpodpath
          mountPath: /var/log/pods
         # Docker runtime directory, replace this path
         # with your container runtime logs directory,
         # or remove this configuration if `/var/log/pods`
         # is not a symlink to any other directory.
         - name: logcontainerpath
          mountPath: /var/lib/docker/containers
     # (...)
     volumes:
       # (...)
       - hostPath:
           path: /opt/datadog-agent/run
         name: pointerdir
       - hostPath:
           path: /var/log/pods
         name: logpodpath
       # Docker runtime directory, replace this path
       # with your container runtime logs directory,
       # or remove this configuration if `/var/log/pods`
       # is not a symlink to any other directory.
       - hostPath:
           path: /var/lib/docker/containers
         name: logcontainerpath
       # (...)
   

   pointerdir는 Agent가 로그를 수집하는 모든 컨테이너에 포인터가 있는 파일을 저장하는 데 사용됩니다. 이는 Agent가 재시작되거나 네트워크 문제가 발생했을 때 손실이 없도록 보장하기 위한 것입니다.

권한 없음

(선택 사항) 권한 없는 설치를 실행하려면 포드 템플릿에 다음을 추가하세요.

  spec:
    securityContext:
      runAsUser: <USER_ID>
      supplementalGroups:
        - <DOCKER_GROUP_ID>

<USER_ID>는 에이전트를 실행할 UID이며, <DOCKER_GROUP_ID>는 도커 또는 컨테이너화된 소켓을 소유한 그룹 ID입니다.

에이전트가 비루트 사용자로 실행되는 경우 /var/lib/docker/containers에 포함된 로그 파일을 직접 읽을 수 없습니다. 이 사례에서는 에이전트 컨테이너에 도커 소켓을 마운트하여 도커 데몬에서 컨테이너 로그를 가져올 수 있도록 해야 합니다.

Cluster Agent 이벤트 수집

Datadog Cluster Agent에서 Kubernetes 이벤트를 수집하려면 다음 단계를 따르세요.

1. leader_election 변수 또는 DD_LEADER_ELECTION 환경 변수를 false로 설정하여 노드 Agent 에서 리더 선출을 비활성화합니다.

2. Cluster Agent 배포 파일에서 DD_COLLECT_KUBERNETES_EVENTS 및 DD_LEADER_ELECTION 환경 변수를 true로 설정합니다.

     - name: DD_COLLECT_KUBERNETES_EVENTS
       value: "true"
     - name: DD_LEADER_ELECTION
       value: "true"
   

위 단계에 따라 리더 선출을 구성하여 단 하나의 Cluster Agent가 해당 이벤트를 수집하도록 합니다.

또는 Node Agent에서 Kubernetes 이벤트를 수집하려면 Agent 매니페스트에서 환경 변수 DD_COLLECT_KUBERNETES_EVENTS 및 DD_LEADER_ELECTION을 true로 설정하세요.

- name: DD_COLLECT_KUBERNETES_EVENTS
  value: "true"
- name: DD_LEADER_ELECTION
  value: "true"

환경 변수

다음은 DaemonSet을 사용하여 Datadog Agent에 사용할 수 있는 환경 변수 목록입니다.

전역 옵션

프록시 설정

Agent v6.4.0(및 Trace Agent는 v6.5.0)부터 다음 환경 변수를 사용하여 Agent 프록시 설정을 재정의할 수 있습니다.

프록시 설정에 관한 자세한 내용은 Agent v6 프록시 설명서를 참조하세요.

DogStatsD(커스텀 메트릭)

StatsD 프로토콜을 사용하여 커스텀 메트릭을 전송합니다.

Unix 도메인 소켓을 통한 DogStatsD에 대해 자세히 알아보세요.

태깅

Datadog는 자동으로 Kubernetes에서 공통 태그를 수집합니다. 더 많은 태그를 추출하려면 다음 옵션을 사용하세요.

자세한 내용은 Kubernetes 태그 추출 설명서를 참조하세요.

컨테이너 무시

로그 수집, 메트릭 수집, Autodiscovery에서 컨테이너 제외 Datadog는 기본적으로 Kubernetes 및 OpenShift pause 컨테이너를 제외합니다. 이러한 허용 목록과 차단 목록은 Autodiscovery에만 적용되며, 추적과 DogStatsD는 영향을 받지 않습니다. 이러한 환경 변수는 값에 정규식을 지원합니다.

추가 예시는 컨테이너 발견 관리 페이지에서 확인할 수 있습니다.

참고: kubernetes.containers.running, kubernetes.pods.running, docker.containers.running, .stopped, .running.total 및 .stopped.total 메트릭은 이러한 설정의 영향을 받지 않습니다. 모든 컨테이너가 집계됩니다.

자동탐지

기타