Datadog 에이전트로 네트워크 성능 모니터링 기능을 사용하도록 구성하려면 다음과 같이 설정하세요.

1. 6.14+ 이전 버전 에이전트를 사용하는 경우에는 먼저 실시간 프로세스 수집을 활성화하세요. 그렇지 않은 경우에는 이 단계를 건너뜁니다.

2. 시스템 프로브 예제 설정을 복사합니다:

   sudo -u dd-agent install -m 0640 /etc/datadog-agent/system-probe.yaml.example /etc/datadog-agent/system-probe.yaml
   

3. /etc/datadog-agent/system-probe.yaml을 편집하여 활성 플래그를 true로 설정합니다:

   network_config:   # use system_probe_config for Agent's older than 7.24.1
     ## @param enabled - boolean - optional - default: false
     ## Set to true to enable Network Performance Monitoring.
     #
     enabled: true
   

4. 6.18 또는 7.18 이전 버전의 에이전트를 실행 중인 경우 수동으로 시스템 프로브를 시작하고, 부팅 시 시작하도록 설정합니다 (6.18 및 7.18 버전부터는 에이전트가 시작될 때 시스템 프로브가 자동으로 시작됨):

   sudo systemctl start datadog-agent-sysprobe
   sudo systemctl enable datadog-agent-sysprobe
   

   참고: 시스템에서 systemctl 명령을 사용할 수 없는 경우, sudo service datadog-agent-sysprobe start명령을 대신 실행합니다. 그 다음 datadog-agent 시작 전에, 부팅 시 시작되도록 설정합니다.

5. 에이전트를 다시 시작합니다.

   sudo systemctl restart datadog-agent
   

   참고: systemctl 명령이 시스템에서 제공되지 않으면 대신 다음 명령(sudo service datadog-agent restart)을 실행합니다.

SELinux 지원 시스템

SELinux가 활성화된 시스템에서 시스템 프로브 바이너리가 eBPF 기능을 사용하려면 특별 권한이 필요합니다.

CentOS 기반 시스템용 Datadog 에이전트 RPM 패키지는 시스템 프로브 바이너리에 해당 권한을 부여할 목적으로 SELinux 정책을 번들로 제공합니다.

SELinux가 활성화된 다른 시스템에서 네트워크 성능 모니터링 기능을 사용해야 한다면 다음 작업을 수행합니다.

1. 기본 SELinux 정책을 SELinux 설정에 맞게 수정합니다. 시스템에 따라 일부 유형 또는 속성은 존재하지 않거나 이름이 다를 수 있습니다.

2. 정책 파일의 이름이 system_probe_policy.te이라는 가정 하에 해당 정책을 모듈로 컴파일합니다.

   checkmodule -M -m -o system_probe_policy.mod system_probe_policy.te
   semodule_package -o system_probe_policy.pp -m system_probe_policy.mod
   

3. 모듈을 SELinux 시스템에 적용합니다.

   semodule -v -i system_probe_policy.pp
   

4. 에이전트 설치 디렉토리가 /opt/datadog-agent이라는 가정 하에, 정책에 정의된 것을 사용하도록 시스템 프로브 바이너리 유형을 변경합니다.

   semanage fcontext -a -t system_probe_t /opt/datadog-agent/embedded/bin/system-probe
   restorecon -v /opt/datadog-agent/embedded/bin/system-probe
   

5. 에이전트를 다시 시작합니다.

참고: 이 지침을 사용하려면 시스템에 대부분의 표준 배포판(우분투(Ubuntu), 데비안(Debian), RHEL, CentOS, SUSE)에서 사용할 수 있는 SELinux 유틸리티(checkmodule, semodule, semodule_package, semanage,restorecon)가 설치되어 있어야 합니다. 설치 방법에 대한 자세한 내용을 확인하려면 사용 중인 배포판을 확인하세요.

배포판에 해당 유틸리티가 없는 경우, 동일한 절차를 따르되 배포판에서 제공하는 유틸리티를 대신 사용합니다.

Windows용 데이터 수집은 네트워크 데이터 수집용 필터 드라이버에 의존합니다.

Windows 호스트용 네트워크 성능 모니터링을 활성화하려면 다음의 작업을 수행합니다.

1. 네트워크 드라이버 구성 요소를 활성화한 상태에서 Datadog Agent(버전 7.27.1 이상)를 설치합니다.

   [사용 중단됨](버전 7.44 이하) 설치 중에 ADDLOCAL="MainApplication,NPM"을 msiexec 명령으로 전달하거나, GUI로 에이전트 설치를 실행할 때 “네트워크 성능 모니터링"을 선택합니다.

2. C:\ProgramData\Datadog\system-probe.yaml을 편집하여 활성 플래그를 true로 설정합니다:

   network_config:
       enabled: true
   

3. 에이전트를 다시 시작합니다.

   PowerShell (powershell.exe)의 경우:

   restart-service -f datadogagent
   

   명령 프롬프트(cmd.exe)의 경우:

   net /y stop datadogagent && net start datadogagent
   

참고: 네트워크 성능 모니터링은 Windows 호스트만 모니터링하며 Windows 컨테이너는 모니터링하지 않습니다.

Helm으로 쿠버네티스(Kubernetes)용 네트워크 성능 모니터링을 활성화하려면 다음을 추가합니다.

datadog:
  networkMonitoring:
    enabled: true

values.yaml에 추가하려면, Helm 차트 v2.4.39 버전 이상이 필요합니다. 자세한 내용을 확인하려면 Datadog 헬름 차트 문서를 참조하세요.

Helm을 사용하지 않는다면 처음부터 쿠버네티스(Kubernetes)에서 네트워크 성능 모니터링을 사용하도록 설정할 수 있습니다:

1. datadog-agent.yaml 매니페스트 템플릿을 다운로드하세요.

2. <DATADOG_API_KEY>를 Datadog API 키로 교체합니다.

3. 옵션 - Datadog 사이트 설정. Datadog EU 사이트를 사용한다면, datadog-agent.yaml 매니페스트에서 DD_SITE 환경 변수를 datadoghq.eu로 설정합니다.

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

   kubectl apply -f datadog-agent.yaml
   

이미 매니페스트와 함께 실행 중인 에이전트가 있는 경우:

1. datadog-agent 템플릿에 container.apparmor.security.beta.kubernetes.io/system-probe: unconfined 어노테이션을 추가합니다:

   spec:
       selector:
           matchLabels:
               app: datadog-agent
       template:
           metadata:
               labels:
                   app: datadog-agent
               name: datadog-agent
               annotations:
                   container.apparmor.security.beta.kubernetes.io/system-probe: unconfined
   

2. 에이전트 데몬셋에서 다음 환경 변수를 사용하여 프로세스 수집 및 시스템 프로브를 활성화합니다. 에이전트 프로세스별로 컨테이너를 실행한다면 다음 환경 변수를 프로세스 에이전트 컨테이너에 추가하고, 그렇지 않다면 에이전트 컨테이너에 추가합니다.

     # (...)
                     env:
                     # (...)
                         - name: DD_PROCESS_AGENT_ENABLED
                           value: 'true'
                         - name: DD_SYSTEM_PROBE_ENABLED
                           value: 'true'
                         - name: DD_SYSTEM_PROBE_EXTERNAL
                           value: 'true'
                         - name: DD_SYSPROBE_SOCKET
                           value: /var/run/sysprobe/sysprobe.sock
   

3. datadog-agent 컨테이너에 다음 추가 볼륨을 마운트합니다:

    # (...)
           spec:
               serviceAccountName: datadog-agent
               containers:
                   - name: datadog-agent
                     image: 'gcr.io/datadoghq/agent:latest'
                     # (...)
                 volumeMounts:
                     - name: procdir
                       mountPath: /host/proc
                       readOnly: true
                     - name: cgroups
                       mountPath: /host/sys/fs/cgroup
                       readOnly: true
                     - name: debugfs
                       mountPath: /sys/kernel/debug
                     - name: sysprobe-socket-dir
                       mountPath: /var/run/sysprobe
   

4. 에이전트에 새 시스템 프로브를 사이드카로 추가합니다:

    # (...)
           spec:
               serviceAccountName: datadog-agent
               containers:
                   - name: datadog-agent
                     image: 'gcr.io/datadoghq/agent:latest'
                   # (...)
                   - name: system-probe
                     image: 'gcr.io/datadoghq/agent:latest'
                     imagePullPolicy: Always
                     securityContext:
                         capabilities:
                             add:
                                 - SYS_ADMIN
                                 - SYS_RESOURCE
                                 - SYS_PTRACE
                                 - NET_ADMIN
                                 - NET_BROADCAST
                                 - NET_RAW
                                 - IPC_LOCK
                                 - CHOWN
                     command:
                         - /opt/datadog-agent/embedded/bin/system-probe
                     env:
                         - name: DD_SYSPROBE_SOCKET
                           value: /var/run/sysprobe/sysprobe.sock
                     resources:
                         requests:
                             memory: 150Mi
                             cpu: 200m
                         limits:
                             memory: 150Mi
                             cpu: 200m
                     volumeMounts:
                         - name: procdir
                           mountPath: /host/proc
                           readOnly: true
                         - name: cgroups
                           mountPath: /host/sys/fs/cgroup
                           readOnly: true
                         - name: debugfs
                           mountPath: /sys/kernel/debug
                         - name: sysprobe-socket-dir
                           mountPath: /var/run/sysprobe
   

5. 마지막으로 매니페스트에 다음 볼륨을 추가합니다:

               volumes:
                   - name: sysprobe-socket-dir
                     emptyDir: {}
                   - name: debugfs
                     hostPath:
                         path: /sys/kernel/debug
   

Datadog 오퍼레이터는 쿠버네티스와 OpenShift에 Datadog 에이전트를 배포하는 방법입니다. 커스텀 리소스 상태에서 배포 상황, 상태, 오류를 보고하고 고급 설정 옵션을 통해 오류 발생 위험을 줄입니다.

오퍼레이터에서 네트워크 성능 모니터링 기능을 사용하도록 구성하려면 다음과 같이 설정하세요.

kind: DatadogAgent
apiVersion: datadoghq.com/v2alpha1
metadata:
  name: placeholder
  namespace: placeholder
spec:
  features:
    npm:
      enabled: true

도커(Docker)에서 네트워크 성능 모니터링 기능을 사용하도록 구성하려면 컨테이너 에이전트를 시작할 때 다음 설정을 활용하세요.

docker run --cgroupns host \
--pid host \
-e DD_API_KEY="<DATADOG_API_KEY>" \
-e DD_SYSTEM_PROBE_NETWORK_ENABLED=true \
-e DD_PROCESS_AGENT_ENABLED=true \
-v /var/run/docker.sock:/var/run/docker.sock:ro \
-v /proc/:/host/proc/:ro \
-v /sys/fs/cgroup/:/host/sys/fs/cgroup:ro \
-v /sys/kernel/debug:/sys/kernel/debug \
--security-opt apparmor:unconfined \
--cap-add=SYS_ADMIN \
--cap-add=SYS_RESOURCE \
--cap-add=SYS_PTRACE \
--cap-add=NET_ADMIN \
--cap-add=NET_BROADCAST \
--cap-add=NET_RAW \
--cap-add=IPC_LOCK \
--cap-add=CHOWN \
gcr.io/datadoghq/agent:latest

<DATADOG_API_KEY>를 Datadog API 키로 교체합니다.

docker-compose를 사용한다면 Datadog 에이전트 서비스에 다음을 추가합니다.

version: '3'
services:
  datadog:
    image: "gcr.io/datadoghq/agent:latest"
    environment:
      - DD_SYSTEM_PROBE_NETWORK_ENABLED=true
      - DD_PROCESS_AGENT_ENABLED=true
      - DD_API_KEY=<DATADOG_API_KEY>
    volumes:
      - /var/run/docker.sock:/var/run/docker.sock:ro
      - /proc/:/host/proc/:ro
      - /sys/fs/cgroup/:/host/sys/fs/cgroup:ro
      - /sys/kernel/debug:/sys/kernel/debug
    cap_add:
      - SYS_ADMIN
      - SYS_RESOURCE
      - SYS_PTRACE
      - NET_ADMIN
      - NET_BROADCAST
      - NET_RAW
      - IPC_LOCK
      - CHOWN
    security_opt:
      - apparmor:unconfined

Amazon ECS를 설정하려면 Amazon ECS 설명서 페이지를 참조하세요.