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

데몬셋으로 로그 수집을 활성화하려면:

1. datadog.yaml 에이전트 매니페스트의 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 에이전트가 자체 로그를 수집하고 전송하지 못하도록 합니다. Datadog 에이전트 로그를 수집하려면 이 매개 변수를 제거해야 합니다. 자세한 내용은 컨테이너를 무시하기 위한 환경 변수를 참조하세요. OpenShift 환경 내에서 ImageStream을 사용하는 경우, 로그 수집을 위해 DD_CONTAINER_INCLUDE_LOGS를 name 컨테이너와 함께 설정하세요. Exclude/Include 매개 변수 값은 모두 정규식을 지원합니다.

2. 재시작 또는 네트워크 문제 발생 시 컨테이너 로그의 손실을 방지하기 위해 pointerdir 볼륨을 마운트합니다. 또한, /var/log/pods는 이 디렉토리에 대한 심볼릭 링크이므로 /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는 에이전트가 로그를 수집하는 모든 컨테이너의 포인터가 있는 파일 저장에 사용됩니다. 이는 에이전트가 재시작되거나 네트워크 문제 발생 시 로그 손실을 방지합니다.

권한 없음

(선택 사항) 권한 없는 설치를 실행하려면 [포드 템플릿][2]에 다음을 추가합니다:

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

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

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

Helm으로 로그 수집을 활성화하려면, 다음 로그 수집 설정으로 datadog-values.yaml 파일을 업데이트한 후Datadog Helm 차트를 업그레이드합니다:

datadog:
  ## @param logs - object - required
  ## Enable logs agent and provide custom configs
  #
  logs:
    ## @param enabled - boolean - optional - default: false
    ## Enables this to activate Datadog Agent log collection.
    #
    enabled: true

    ## @param containerCollectAll - boolean - optional - default: false
    ## Enable this to allow log collection for all containers.
    #
    containerCollectAll: true

datadog.logs.containerCollectAll을 true로 설정하면 기본적으로 검색된 모든 컨테이너에서 로그를 수집할 수 있습니다. false (기본값)로 설정한 경우, 로그를 수집하려면 자동 탐지 로그 설정을 지정해야 합니다.

권한 없음

(선택 사항) 권한 없는 설치를 실행하려면 values.yaml 파일에 다음을 추가합니다:

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

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

datadog-agent.yaml 매니페스트를 다음과 같이 업데이트합니다:

apiVersion: datadoghq.com/v2alpha1
kind: DatadogAgent
metadata:
  name: datadog
spec:
  global:
    credentials:
      apiKey: <DATADOG_API_KEY>

  features:
    logCollection:
      enabled: true
      containerCollectAll: true

로그 및 메트릭 수집이 활성화된 매니페스트 샘플에서 전체 예제를 확인하세요. features.logCollection.containerCollectAll를 true로 설정해 기본적으로 검색된 모든 컨테이너에서 로그를 수집할 수 있습니다. false (기본값)로 설정한 경우, 로그를 수집하려면 자동 탐지 로그 설정을 지정해야 합니다.

그런 다음 새로운 설정을 적용합니다:

kubectl apply -n $DD_NAMESPACE -f datadog-agent.yaml

권한 없음

(선택 사항) 권한 없는 설치를 실행하려면 DatadogAgent 커스텀 리소스에 다음을 추가합니다:

apiVersion: datadoghq.com/v2alpha1
kind: DatadogAgent
metadata:
  name: datadog
spec:
  global:
    credentials:
      apiKey: <DATADOG_API_KEY>

  features:
    logCollection:
      enabled: true
      containerCollectAll: true

  override:
    nodeAgent:
      securityContext:
        runAsUser: <USER_ID>
        supplementalGroups:
          - <DOCKER_GROUP_ID>

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

통합 템플릿은 쿠버네티스 포드 어노테이션에 저장할 수 있습니다. 자동 탐지를 통해 에이전트가 쿠버네티스에서 실행 중인지 감지하고 모든 포드 어노테이션에서 통합 템플릿을 자동으로 검색합니다.

자동 탐지는 지정된 컨테이너에 특정한 설정을 적용하기 위해 이미지가 아닌 이름으로 컨테이너를 식별합니다. <CONTAINER_IDENTIFIER>를 .spec.containers[0].image가 아닌 .spec.containers[0].name과 연결시키려고 시도합니다. 포드 내에서 <CONTAINER_IDENTIFIER>에 대한 Datadog 통합 자동 탐지를 설정하려면, 포드에 다음 어노테이션을 추가하세요:

apiVersion: v1
kind: Pod
# (...)
metadata:
  name: '<POD_NAME>'
  annotations:
    ad.datadoghq.com/<CONTAINER_IDENTIFIER>.logs: '[<LOG_CONFIG>]'
    # (...)
spec:
  containers:
    - name: '<CONTAINER_IDENTIFIER>'
# (...)

포드 내에서 두 개의 통합 템플릿을 두 개의 다른 컨테이너 <CONTAINER_IDENTIFIER_1>, <CONTAINER_IDENTIFIER_2>에 적용하려면, 다음 어노테이션을 포드에 추가하세요:

apiVersion: v1
kind: Pod
# (...)
metadata:
  name: '<POD_NAME>'
  annotations:
    ad.datadoghq.com/<CONTAINER_IDENTIFIER_1>.logs: '[<LOG_CONFIG_1>]'
    # (...)
    ad.datadoghq.com/<CONTAINER_IDENTIFIER_2>.logs: '[<LOG_CONFIG_2>]'
spec:
  containers:
    - name: '<CONTAINER_IDENTIFIER_1>'
    # (...)
    - name: '<CONTAINER_IDENTIFIER_2>'
# (...)

참고: kind: Pod로 쿠버네티스 포드를 직접 정의하는 경우, 각 포드의 어노테이션을 metadata 섹션 아래에 추가합니다. 레플리케이션 컨트롤러, 레플리카셋 또는 디플로이먼트를 사용하여 간접적으로 포드를 정의하는 경우, .spec.template.metadata아래에 포드 어노테이션을 추가합니다.

템플릿을 로컬 파일로 저장하고 컨테이너화된 에이전트 내부에 마운트할 경우 외부 서비스나 특정 오케스트레이션 플랫폼이 필요하지 않습니다. 단점은 템플릿을 변경, 추가 또는 제거할 때마다 에이전트 컨테이너를 재시작해야 한다는 것입니다. 에이전트는 마운트된 /conf.d 디렉토리에서 자동 탐지 템플릿을 찾습니다.

에이전트 v6.2.0(및 v5.24.0)부터 기본 템플릿은 자동 감지를 하는 대신 모니터링되는 소프트웨어의 기본 포트를 사용합니다. 다른 포트를 사용해야 하는 경우, 커스텀 자동 탐지 템플릿을 Docker 컨테이너 라벨 또는 쿠버네티스 포드 어노테이션에서 사용하세요.

이러한 통합 템플릿은 기본적인 경우를 위한 것입니다. 추가 옵션 활성화를 위해 사용자 지정 Datadog 통합 설정이 필요한 경우 다른 컨테이너 식별자 또는 템플릿 변수 인덱싱을 사용하거나 자체 자동 설정 파일을 작성하세요:

1. 호스트에 conf.d/<INTEGRATION_NAME>.d/conf.yaml 파일을 생성하고 사용자 지정 자동 설정을 추가합니다.
2. 호스트 conf.d/ 폴더를 컨테이너화된 에이전트 conf.d 폴더에 마운트합니다.

참고: 이 기능은 도커 소켓을 통해 로그를 수집할 때만 지원되며, 쿠버네티스 로그 파일을 사용할 때는 지원되지 않습니다. 쿠버네티스 환경에서 도커 소켓을 로그 수집에 사용하려면 도커가 런타임이고 DD_LOGS_CONFIG_K8S_CONTAINER_USE_FILE이 false로 설정되어 있는지 확인하세요.

자동 설정 파일 예시:

ad_identifiers:
  <INTEGRATION_AUTODISCOVERY_IDENTIFIER>

logs:
  <LOGS_CONFIG>

<INTEGRATION_AUTODISCOVERY_IDENTIFIER>에 대한 자세한 내용은 자동 탐지 컨테이너 식별자 설명서를 참조하세요.

참고: 에이전트가 파일 이름에서 직접 유추하므로 <INTEGRATIONS_NAME>을 설정할 필요가 없습니다.

쿠버네티스에서는 ConfigMaps을 사용할 수 있습니다. 아래 템플릿과 쿠버네티스 커스텀 통합 설명서를 참조하세요.

참고: 이 기능은 도커 소켓을 통해 로그를 수집할 때만 지원되며, 쿠버네티스 로그 파일을 사용할 때는 지원되지 않습니다. 쿠버네티스 환경에서 도커 소켓을 로그 수집에 사용하려면 도커가 런타임이고, DD_LOGS_CONFIG_K8S_CONTAINER_USE_FILE이 false로 설정되어 있는지 확인하세요.

kind: ConfigMap
apiVersion: v1
metadata:
  name: "<NAME>-config-map"
  namespace: default
data:
  <INTEGRATION_NAME>-config: |-
    ad_identifiers:
      <INTEGRATION_AUTODISCOVERY_IDENTIFIER>
    logs:
      <LOGS_CONFIG>

<INTEGRATION_AUTODISCOVERY_IDENTIFIER>에 대한 자세한 내용은 자동 탐지 컨테이너 식별자 설명서를 참조하세요.

자동 탐지는 Consul, Etsd 및 Zookeper를 통합 템플릿 원본으로 사용할 수 있습니다. 키 값 저장소를 사용하려면 에이전트 설정 파일에서 키 값 저장소를 설정하고 이 파일을 컨테이너화된 에이전트 내부에 마운트합니다. 또는 키 값 저장소를 환경 변수로 컨테이너화된 에이전트에 전달합니다.

** datadog.yaml에서 설정하기**

datadog.yaml 파일에서 키-값 저장소의 <KEY_VALUE_STORE_PORT>와 <KEY_VALUE_STORE_IP> 주소를 설정합니다.

config_providers:
  - name: etcd
    polling: true
    template_dir: /datadog/check_configs
    template_url: '<KV_STORE_IP>:<KV_STORE_PORT>'
    username:
    password:

  - name: consul
    polling: true
    template_dir: datadog/check_configs
    template_url: '<KV_STORE_IP>:<KV_STORE_PORT>'
    ca_file:
    ca_path:
    cert_file:
    key_file:
    username:
    password:
    token:

  - name: zookeeper
    polling: true
    template_dir: /datadog/check_configs
    template_url: '<KV_STORE_IP>:<KV_STORE_PORT>'
    username:
    password:

그런 다음 에이전트 재시작를 클릭해 설정 변경사항을 적용합니다.

환경 변수 설정:

키값 스토어가 템플릿 소스로 활성화되어 있는 경우 Agent는 키/datadog/check_configs에서 템플릿을 찾습니다. 자동탐지는 아래와 같은 키값 위계를 전제로 합니다.

/datadog/
  check_configs/
    <CONTAINER_IDENTIFIER>/
      - logs: ["<LOGS_CONFIG>"]
    ...

참고: 지정된 컨테이너에 특정 설정을 적용하기 위해 자동 탐지는 키-값 저장소를 사용할 때 <CONTAINER_IDENTIFIER>와 .spec.containers[0].image를 맞춰봄으로써 image로 컨테이너를 식별합니다.

confd내에서 사용자가 원하는 대로 통합 별 로그 수집을 설정할 수 있습니다. 원하는 설정을 에이전트 컨테이너에 마운트합니다.

참고: 이 기능은 도커 소켓을 통해 로그를 수집할 때만 지원되며, 쿠버네티스 로그 파일을 사용할 때는 지원되지 않습니다. 쿠버네티스 환경에서 도커 소켓을 로그 수집에 사용하려면 도커가 런타임이고 DD_LOGS_CONFIG_K8S_CONTAINER_USE_FILE이 false로 설정되어 있는지 확인하세요.

confd:
  <INTEGRATION_NAME>.yaml: |-
    ad_identifiers:
      - <INTEGRATION_AUTODISCOVERY_IDENTIFIER>
    init_config:
    instances:
      (...)
    logs:
      <LOGS_CONFIG>    

다음 포드 어노테이션은 커스텀 password 매개 변수를 사용해 redis 컨테이너에 대한 통합 템플릿을 정의합니다. 또한, 올바른 source 및 service 속성으로 모든 로그에 커스텀 태그를 포함한 태그를 지정합니다.

apiVersion: v1
kind: Pod
metadata:
  name: redis
  annotations:
    ad.datadoghq.com/redis.logs: '[{"source": "redis","service": "redis","tags": ["env:prod"]}]'
  labels:
    name: redis
spec:
  containers:
    - name: redis
      image: redis:latest
      ports:
        - containerPort: 6379

다음 ConfigMap은 로그 수집을 위해 source 및 service 속성으로 redis 컨테이너에 대한 통합 텝플릿을 정의합니다. 또한, 올바른 source 및 service 속성으로 모든 로그에 커스텀 태그를 포함한 태그를 지정합니다.

kind: ConfigMap
apiVersion: v1
metadata:
  name: redisdb-config-map
  namespace: default
data:
  redisdb-config: |-
    ad_identifiers:
      - redis
      - redis-test
    logs:
      - source: redis
        service: redis
        tags:
          - env:prod    

매니페스트에서 volumeMounts와 volumes를 정의합니다:

# (...)
        volumeMounts:
        # (...)
          - name: redisdb-config-map
            mountPath: /conf.d/redisdb.d
        # (...)
      volumes:
      # (...)
        - name: redisdb-config-map
          configMap:
            name: redisdb-config-map
            items:
              - key: redisdb-config
                path: conf.yaml
# (...)

다음 etcd 명령은 커스텀 password 매개 변수로 Redis 통합 템플릿을 생성하고, 모든 로그에 올바른 source 및 service 속성을 가지고 태그를 지정합니다:

etcdctl mkdir /datadog/check_configs/redis
etcdctl set /datadog/check_configs/redis/logs '[{"source": "redis", "service": "redis", "tags": 
["env:prod"]}]'

세 값은 각각 리스트입니다. 자동 탐지는 공유 목록 인덱스를 기반으로 목록에 있는 항목을 통합 설정으로 맞춥니다. 이 경우 check_names[0], init_configs[0] 및 instances[0]에서 첫 번째(그리고 유일한) 검사 설정을 구성합니다.

auto-conf 파일과 달리 키-값 저장소는 컨테이너 식별자로 짧거나 긴 이미지 이름을 사용할 수 있습니다. (예: redis 또는 redis:latest)

다음 설정은 로그 수집을 위해 source 및 service 속성으로 Redis 컨테이너에 대한 통합 템플릿을 정의합니다:

confd:
  redis.yaml: |-
    ad_identifiers:
      - redis
    logs:
      - source: redis
        service: redis
        tags: env:prod    

참고: 위의 설정은 이 통합에서 로그만 수집합니다. 이미 Redis 통합에서 다른 데이터를 수집하고 있는 경우, 기존 설정에 logs 섹션을 추가할 수 있습니다.