개요

DatadogInstrumentation 사용자 지정 리소스(CR)를 사용하면 포드 주석 대신 단일 Kubernetes 리소스로 Autodiscovery 검사 및 로그를 구성할 수 있습니다. 이 접근 방식을 통해 Agent 또는 애플리케이션을 편집하고 롤아웃을 트리거하지 않고도 통합 구성을 활성화, 업데이트 및 제거할 수 있습니다.

다음과 같은 작업을 수행하고 싶은 경우 DatadogInstrumentation CR을 사용하세요.

• 워크로드 매니페스트를 수정하거나 주석을 추가하지 않고 검사 및 로그를 구성합니다.
• 주석의 원시 JSON 대신 검증이 포함된 구조화된 리소스 사양을 사용합니다.
• 워크로드별 Autodiscovery 구성을 전용 버전 관리 Kubernetes 리소스로 중앙에서 관리합니다.
• 애플리케이션 포드를 재시작하지 않고 Autodiscovery 구성을 업데이트하거나 제거합니다.

DatadogInstrumentation 리소스를 생성하거나 업데이트하면 Datadog Cluster Agent가 대상을 검증하고 리소스 상태를 보고하며 대상 워크로드에 Autodiscovery 구성을 적용합니다.

요구 사항

Datadog Agent 및 Cluster Agent를 v7.82 이상으로 업그레이드하고 다음 중 하나를 사용하여 DatadogInstrumentation CRD를 설치합니다.

• Datadog Operator v1.29 이상
• Datadog Helm Chart v3.236.0 이상

설정

DatadogInstrumentation 컨트롤러는 Cluster Agent에서 실행되며 기본적으로 비활성화되어 있습니다. Datadog Operator 또는 Helm에서 활성화하세요.

helm repo update

helm upgrade datadog-operator datadog/datadog-operator

apiVersion: datadoghq.com/v2alpha1
kind: DatadogAgent
metadata:
  name: datadog
  annotations:
    agent.datadoghq.com/instrumentation-crd-enabled: "true"
spec:
  global:
    [...]

kubectl apply -f datadog-agent.yaml

helm repo update

datadog:
  instrumentationCrd:
    enabled: true

helm upgrade -f datadog-values.yaml <RELEASE_NAME> datadog/datadog

리소스를 생성하기 전에 DatadogInstrumentation CRD가 설치되어 있는지 확인하세요.

kubectl get crd datadoginstrumentations.datadoghq.com

Datadog CRD를 별도로 관리하는 경우 Datadog CRD Helm Chart를 설치하거나 업그레이드하세요.

helm upgrade --install datadog-crds datadog/datadog-crds

대상 워크로드 지정

Autodiscovery용 DatadogInstrumentation(DDI)은 다음과 같은 세 부분으로 구성됩니다.

• spec.targetRef구성할 워크로드를 : apiVersion, kind, name으로 식별합니다. 사용자 지정 리소스와 대상 워크로드는 동일한 네임스페이스에 있어야 합니다.
• spec.config.checks: 워크로드에 대해 실행할 통합 검사를 정의합니다.
• spec.config.logs: 워크로드에서 수집할 로그를 정의합니다.

다음과 같은 Kubernetes 리소스를 대상으로 지정할 수 있습니다.

이 예시에서는 이 주석 기반 예시를 미러링하여 StatefulSet라는 이름의 redis에 대한 Redis 통합을 구성합니다.

apiVersion: datadoghq.com/v1alpha1
kind: DatadogInstrumentation
metadata:
  name: <YOUR_CR_NAME>
  namespace: <YOUR_TARGETS_NAMESPACE>
spec:
  targetRef:
    apiVersion: apps/v1
    kind: StatefulSet
    name: redis
  config:
    checks:
      - integration: redisdb
        containerName: redis
        initConfig: {}
        instances:
          - host: "%%host%%"
            port: "6379"
            password: "%%env_REDIS_PASSWORD%%"
    logs:
      - containerName: redis
        tags:
          - env:demo

리소스를 적용합니다.

kubectl apply -f redis-instrumentation.yaml

리소스 상태를 검사합니다.

kubectl describe datadoginstrumentation <YOUR_CR_NAME> -n <YOUR_TARGETS_NAMESPACE>

checks의 각 항목은 다음 필드를 허용합니다.

integration

필수입니다. 실행할 Datadog 통합의 이름입니다. 예: redisdb

containerName

워크로드 대상에 필수입니다. 값은 포드 내의 컨테이너 이름과 일치해야 합니다. Service 대상의 경우 이 필드를 생략하세요.

initConfig

선택 사항입니다. 통합을 위한 init_config 섹션입니다.

instances

선택 사항입니다. 인스턴스 설정을 검사합니다. 각 인스턴스는 %%host%%를 포함하여 Autodiscovery 템플릿 변수를 사용할 수 있습니다.

logs의 각 항목은 tags, type, path 등과 같이 Autodiscovery 로그 주석과 동일한 로그 수집 옵션을 허용합니다. 각 항목에는 포드 내의 컨테이너와 일치하는 containerName이 필요합니다.

대상 서비스 지정

대상 Service를 지정하면 Kubernetes 서비스의 주석과 유사한 엔드포인트 검사가 구성됩니다.

• Datadog은 Service의 각 엔드포인트에 대해 하나의 엔드포인트 검사를 예약합니다.
• %%host%% 는 엔드포인트 IP로 확인됩니다.
• 엔드포인트가 Kubernetes 포드에 의해 지원되는 경우, Datadog은 해당 포드에 대해 수집된 포드 태그를 추가합니다.
• 엔드포인트가 포드에 의해 지원되지 않는 경우, Datadog은 해당 검사를 포드별 태그가 없는 일반 클러스터 검사로 변환합니다.

아래는 Kubernetes Service에 대해 nginx 검사를 구성하는 예시입니다.

apiVersion: datadoghq.com/v1alpha1
kind: DatadogInstrumentation
metadata:
  name: <YOUR_CR_NAME>
  namespace: <YOUR_SERVICES_NAMESPACE>
spec:
  targetRef:
    apiVersion: v1
    kind: Service
    name: nginx
  config:
    checks:
      - integration: nginx
        initConfig: {}
        instances:
          - name: "My NGINX Service Endpoints"
            nginx_status_url: "http://%%host%%:%%port%%/status/"

우선 순위

워크로드에 둘 이상의 구성 소스가 적용되는 경우, Datadog Agent는 다음 순서로 이를 확인합니다(우선 순위가 높은 순서).

1. 포드 주석
2. DatadogInstrumentation 사용자 지정 리소스
3. 자동 구성 또는 마운팅된 파일과 같은 정적 구성

워크로드에 이미 검사 또는 로그 수집을 위한 주석 기반 Autodiscovery 구성이 있는 경우, DatadogInstrumentation 구성은 이를 재정의하지 않습니다.

대상당 하나의 리소스

워크로드 또는 Service는 네임스페이스 내에서 단일 DatadogInstrumentation 리소스의 대상만 될 수 있습니다. 검증 웹훅은 targetRef가 이미 다른 리소스에 속해 있거나 해당 targetRef가 지원되지 않는 종류를 가리키는 리소스를 거부합니다.

예약된 검사 확인

리소스 상태는 Cluster Agent가 구성을 수락했는지 여부를 보여줍니다. 검사가 예약되었는지 확인하려면 대상 워크로드가 실행되는 Node Agent에서 agent configcheck를 실행하세요.

DatadogInstrumentation 리소스를 통해 구성된 검사는 구성 공급자로 instrumentation-checks를, 구성 소스로 datadoginstrumentation:<NAMESPACE>/<CR_NAME>을 나열합니다. 다음 예시에서는 Redis 워크로드를 대상으로 하는 리소스에서 예약된 redisdb 검사에 대한 출력을 보여줍니다.

> agent configcheck
# other configs...

=== redisdb check ===
Configuration provider: instrumentation-checks
Configuration source: datadoginstrumentation:cache/redis-instrumentation
Config for instance ID: redisdb:d5dd267b580bc10e
host: 10.244.0.7
password: "********"
port: 6379
Init Config:
{}
Log Config:
- tags:
  - env:demo
Auto-discovery IDs:
* redis

추가 자료

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

Autodiscovery로 통합 구성설명서 Autodiscovery 시작하기설명서 Autodiscovery 시나리오 및 예시설명서 Datadog Cluster Agent설명서