개요

Datadog Admission Controller는 Datadog Cluster Agent의 구성 요소입니다. Admission Controller의 주요 장점은 애플리케이션 포드 구성을 단순화하는 것입니다. 이를 위해 두 가지 핵심 기능을 제공합니다.

• 환경 변수(DD_AGENT_HOST, DD_TRACE_AGENT_URL, DD_ENTITY_ID 및 DD_EXTERNAL_ENV)를 주입하여 사용자의 애플리케이션 컨테이너에 DogStatsD 및 Datadog SDK를 구성합니다.
• 애플리케이션 레이블에 지정된 Datadog 표준 태그(env, service, version)를 컨테이너 환경 변수로 주입합니다.

Datadog의 Admission Controller는 MutatingAdmissionWebhook 유형입니다. Admission Controller에 대한 자세한 내용은 Admission Controller에 대한 Kubernetes 가이드를 참조하세요.

요구 사항

• Datadog Cluster Agent v7.40 이상

구성

apiVersion: datadoghq.com/v2alpha1
kind: DatadogAgent
metadata:
  name: datadog
spec:
  #(...)
  features:
    admissionController:
      enabled: true
      mutateUnlabelled: false

#(...)
clusterAgent:
  #(...)
  ## @param admissionController - object - required
  ## Enable the admissionController to automatically inject APM and
  ## DogStatsD config and standard tags (env, service, version) into
  ## your pods
  #
  admissionController:
    enabled: true

    ## @param mutateUnlabelled - boolean - optional
    ## Enable injecting config without having the pod label:
    ## admission.datadoghq.com/enabled="true"
    #
    mutateUnlabelled: false

- apiGroups:
  - admissionregistration.k8s.io
  resources:
  - mutatingwebhookconfigurations
  verbs: ["get", "list", "watch", "update", "create"]
- apiGroups: [""]
  resources: ["secrets"]
  verbs: ["get", "list", "watch", "update", "create"]
- apiGroups: ["batch"]
  resources: ["jobs", "cronjobs"]
  verbs: ["get"]
- apiGroups: ["apps"]
  resources: ["statefulsets", "replicasets", "deployments"]
  verbs: ["get"]

apiVersion: v1
kind: Service
metadata:
  name: datadog-cluster-agent-admission-controller
  labels:
    app: "datadog"
    app.kubernetes.io/name: "datadog"
spec:
  selector:
    app: datadog-cluster-agent
  ports:
  - port: 443
    targetPort: 8000

- name: DD_ADMISSION_CONTROLLER_ENABLED
  value: "true"
- name: DD_ADMISSION_CONTROLLER_SERVICE_NAME
  value: "datadog-cluster-agent-admission-controller"

# Uncomment this to configure Datadog SDKs automatically (see below)
# - name: DD_ADMISSION_CONTROLLER_MUTATE_UNLABELLED
#   value: "true"

APM 계측 라이브러리 주입

Cluster Agent(버전 7.39 이상)를 구성하여 단일 단계 계측을 사용한 계측 라이브러리 자동 주입을 사용할 수 있습니다. 자세한 내용은 단일 단계 APM 계측 설명서를 참조하세요.

단일 단계 계측을 사용하지 않으려면, Datadog Admission Controller를 사용하여 포드 수준에서 Datadog SDK를 직접 주입할 수 있습니다. 자세한 내용은 로컬 SDK 주입을 참조하세요.

APM 및 DogStatsD 환경 변수 주입

라이브러리 주입을 지원하지 않는 DogStatsD 클라이언트 또는 기타 APM 라이브러리를 구성하려면 DD_AGENT_HOST 및 DD_ENTITY_ID 환경 변수를 다음 방법 중 하나로 주입합니다.

• 포드에 admission.datadoghq.com/enabled: "true" 레이블을 추가합니다.
• Cluster Agent Admission Controller를 구성하여 mutateUnlabelled(또는 구성 방식에 따라 DD_ADMISSION_CONTROLLER_MUTATE_UNLABELLED)을 true로 설정합니다.

Helm 차트에 mutateUnlabelled: true Agent 구성을 추가하면 Cluster Agent는 레이블이 없는 모든 포드를 가로채려고 시도합니다.

포드가 환경 변수를 받지 않도록 하려면 admission.datadoghq.com/enabled: "false" 레이블을 추가하세요. 이 설정은 mutateUnlabelled: true를 사용하더라도 적용됩니다.

mutateUnlabelled가 false로 설정된 경우에는 포드 레이블을 admission.datadoghq.com/enabled: "true"로 설정해야 합니다.

가능한 옵션:

우선순위 순서

Datadog Admission Controller는 DD_VERSION, DD_ENV, DD_SERVICE 환경 변수가 이미 존재하는 경우 이를 주입하지 않습니다.

해당 환경 변수가 설정되어 있지 않은 경우 Admission Controller는 다음 순서(상위 우선순위부터)로 표준 태그 값을 사용합니다.

• 포드의 레이블
• ownerReference(ReplicaSet, DaemonSet, Deployment 등)의 레이블

APM 및 DogStatsD 통신 방식 구성

Datadog Cluster Agent v1.20.0부터 Admission Controller는 애플리케이션과 Datadog Agent 간의 다양한 통신 방식을 주입하도록 구성할 수 있습니다.

이 기능은 admission_controller.inject_config.mode을 설정하거나 admission.datadoghq.com/config.mode 포드 레이블을 사용하여 포드별 통신 모드를 지정함으로써 구성할 수 있습니다.

Helm Chart v3.22.0 및 Datadog Operator v1.1.0부터는 APM 소켓 또는 DSD 소켓이 활성화되어 있으면 통신 모드가 자동으로 socket으로 설정됩니다.

가능한 옵션:

참고: 포드별로 지정된 모드는 Admission Controller 수준에서 정의된 전역 모드보다 우선 적용됩니다.

문제 해결

자세한 내용은 Admission Controller Troubleshooting 설명서를 참조하세요.

추가 자료

추가적인 유용한 설명서, 링크 및 기사:

Datadog Cluster Agent 문제 해결설명서 Admission Controller 문제 해결설명서 Datadog APM을 사용하여 라이브러리 주입으로 Kubernetes 애플리케이션의 트레이싱을 자동 계측블로그 Datadog의 CSI 드라이버를 사용하여 보안이 강화된 Kubernetes 환경에서 고성능 관측성 구현블로그 Datadog Operator 및 Admission Controller를 사용하여 애플리케이션 계측하기아키텍처 센터 Cluster Agent를 사용하여 Datadog Admission Controller 비활성화설명서