설치

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
   						매니페스트 템플릿	매니페스트템플릿 (보안 없음)
   						매니페스트 템플릿	매니페스트 템플릿
   						매니페스트 템플릿	매니페스트 템플릿
   						매니페스트 템플릿	매니페스트 템플릿
   						[매니페스트 템플릿10	템플릿 없음
   						매니페스트 템플릿	매니페스트 템플릿

   트레이스 수집을 완전히 활성화하려면 애플리케이션 포드 설정에 추가 단계가 필요합니다. 각 기능을 개별적으로 활성화하는 방법은 로그, 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 환경 내에서 ImageStreams를 사용하는 경우 로그를 수집하도록 컨테이너 name과 함께 DD_CONTAINER_INCLUDE_LOGS를 설정합니다. 이러한 Exclude/Include 파라미터 값은 모두 정규식을 지원합니다.

2. 재시작 또는 네트워크 문제 발생 시 컨테이너 로그의 손실을 방지하기 위해 pointerdir 볼륨을 마운트합니다. 또한, /var/log/pods는 이 디렉토리에 대한 심볼릭 링크이므로 /var/lib/docker/containers를 마운트하여 Kubernetes 로그 파일을 통해 로그를 수집합니다:

     # (...)
       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입니다.

Agent가 루트 사용자가 아닌 사용자로 실행되는 경우 /var/lib/docker/containers 에 포함된 로그 파일을 직접 읽을 수 없습니다. 이 경우 Agent 컨테이너에 Docker 소켓을 마운트하여 Docker daemon에서 컨테이너 로그를 가져와야 합니다.

Cluster Agent 이벤트 수집

Datadog Cluster Agent가 Kubernetes 이벤트를 수집하도록 하려면 다음 단계를 사용하세요.

1. leader_election 변수 또는 DD_LEADER_ELECTION 환경 변수를 false로 설정하여 Node 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 태그 추출 문서를 참조하세요.

컨테이너 무시

로그 수집, 메트릭 수집 및 자동 탐지에서 컨테이너를 제외합니다. Datadog은 기본적으로 쿠버네티스(Kubernetes) 및 OpenShift pause 컨테이너를 제외합니다. 이 허용 목록과 차단 목록은 자동 탐지에만 적용됩니다. 트레이스와 DogStatsD는 영향을 받지 않습니다. 이러한 환경 변수는 값의 정규 표현을 지원합니다.

추가 예제는 Container Discover Management 페이지에서 확인할 수 있습니다.

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

자동 탐지

기타