포트를 변경해야 하는 경우, 기본 Agent 구성 파일의 dogstatsd_port 옵션을 구성한 다음 Agnet를 재시작합니다. DogStatsD가 UNIX 도메인 소켓을 사용하도록 구성할 수도 있습니다.

사용자 지정 Agent DogStatsD 서버 UDP 포트를 활성화하는 방법:

1. dogstatsd_port 파라미터 설정:

   ## @param dogstatsd_port - integer - optional - default: 8125
   ## Override the Agent DogStatsD port.
   ## Note: Make sure your client is sending to the same UDP port.
   #
   dogstatsd_port: 8125
   

2. Agent를 재시작합니다.

기본적으로 DogStatsD는 UDP 포트 8125에서 수신하므로, Agent를 컨테이너에서 수행하는 경우 이 포트를 호스트 포트에 바인딩해야 합니다. StatsD 메트릭이 localhost 외부에서 오는 경우, DD_DOGSTATSD_NON_LOCAL_TRAFFIC을 true로 설정하여 메트릭 수집을 허용해야 합니다. DogStatsD 서버를 가동하는 상태로 Agent를 실행하려면 다음 명령 실행:

docker run -d --cgroupns host \
              --pid host \
              -v /var/run/docker.sock:/var/run/docker.sock:ro \
              -v /proc/:/host/proc/:ro \
              -v /sys/fs/cgroup/:/host/sys/fs/cgroup:ro \
              -e DD_API_KEY=<DATADOG_API_KEY> \
              -e DD_DOGSTATSD_NON_LOCAL_TRAFFIC="true" \
              -p 8125:8125/udp \
              registry.datadoghq.com/agent:latest

StatsD 메트릭을 수집하는 데 사용되는 포트를 변경해야 하는 경우, DD_DOGSTATSD_PORT="<NEW_DOGSTATSD_PORT> 환경 변수를 사용하세요. DogStatsD가 UNIX 도메인 소켓을 사용하도록 구성할 수도 있습니다.

StatsD 메트릭 수집은 UNIX 도메인 소켓에서 기본적으로 활성화되어 있습니다. UDP를 통해 StatsD 메트릭 수집을 시작하려면 Operator 설정에서 DogStatsD 기능을 활성화해야 합니다.

1. datadog-agent.yaml 매니페스트에 features.dogstatsd.hostPortConfig.enabled 추가:

   features:
       dogstatsd:
           hostPortConfig:
               enabled: true
   

   This is an example datadog-agent.yaml manifest:

   apiVersion: datadoghq.com/v2alpha1
   kind: DatadogAgent
   metadata:
     name: datadog
   spec:
     global:
       credentials:
         apiSecret:
           secretName: datadog-secret
           keyName: api-key
     features:
       dogstatsd:
         hostPortConfig:
           enabled: true
   

   This enables the Agent to collect StatsD metrics over UDP on port 8125.

2. 변경 사항 적용:

   kubectl apply -f datadog-agent.yaml
   

경고: features.dogstatsd.hostPortConfig.hostPort 파라미터는 호스트에서 포트를 엽니다. 방화벽이 애플리케이션 또는 신뢰할 수 있는 소스에서만 액세스를 허용하도록 해야 합니다. 네트워크 플러그인이hostPorts를 지원하지 않는 경우, Agent 포드 사양에 hostNetwork: true를 추가하세요. 이렇게 하면 호스트의 네트워크 네임스페이스를 Datadog Agent와 공유합니다. 또한 컨테이너에서 열린 모든 포트나 호스트에서 열린다는 의미이기도 합니다. 포트가 호스트 및 컨테이너 양쪽 모두에서 사용되는 경우, 충돌이 발생하며(동일한 네트워크 네임스페이스를 공유하기 때문에) 포드가 시작되지 않습니다. 일부 Kubernetes 설치는 이것을 허용하지 않습니다.

StatsD 메트릭을 Agent로 전송

애플리케이션에는 호스트의 IP 주소를 판별할 신뢰할 수 있는 방법이 필요합니다. 이것은 Kubernetes 1.7에서는 포드에 환경 변수로 전달할 수 있는 속성 세트가 확장되어 간편해졌습니다. 1.7 이상 버전에서는 PodSpec에 환경 변수를 추가하여 어느 포드에든 호스트 IP를 전달할 수 있습니다. 예를 들어 애플리케이션 매니페스트는 다음과 같을 수 있습니다.

env:
    - name: DD_AGENT_HOST
      valueFrom:
          fieldRef:
              fieldPath: status.hostIP

이 기능을 사용하면 애플리케이션을 실행하는 모든 포드가 $DD_AGENT_HOST에서 포트 8125를 사용해 DogStatsD 메트릭을 전송할 수 있습니다.

참고: Datadog은 속성을 할당할 때 unified service tagging을 사용하는 것을 모범 사례로 권장합니다. Unified service tagging은 Datadog env, service, version의 세 가지 표준 태그를 사용하여 Datadog 텔레메트리를 연결합니다. 환경을 통합하는 방법은 unified service tagging을 참조하세요.

Helm을 사용하여 DogStatsD로 Custom Metrics을 수집하는 방법:

1. datadog-values.yaml 파일을 업데이트하여 DogStatsD 활성화:

     dogstatsd:
       port: 8125
       useHostPort: true
       nonLocalTraffic: true
   

   Note: hostPort functionality requires a networking provider that adheres to the CNI specification, such as Calico, Canal, or Flannel. For more information, including a workaround for non-CNI network providers, see the Kubernetes documentation: HostPort services do not work.

   Warning: The hostPort parameter opens a port on your host. Make sure your firewall only allows access from your applications or trusted sources. If your network plugin doesn’t support hostPorts, so add hostNetwork: true in your Agent pod specifications. This shares the network namespace of your host with the Datadog Agent. It also means that all ports opened on the container are opened on the host. If a port is used both on the host and in your container, they conflict (since they share the same network namespace) and the pod does not start. Some Kubernetes installations do not allow this.

2. Agent 구성 업그레이드:

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

3. 애플리케이션 포드 업데이트: 애플리케이션에 호스트의 IP 주소를 판별할 신뢰할 수 있는 방법이 필요합니다. 이것은 Kubernetes 1.7에서는 포드에 환경 변수로 전달할 수 있는 속성 세트가 확장되어 간편해졌습니다. 1.7 이상 버전에서는 PodSpec에 환경 변수를 추가하여 어느 포드에든 호스트 IP를 전달할 수 있습니다. 예를 들어 애플리케이션 매니페스트는 다음과 같을 수 있습니다.

   env:
       - name: DD_AGENT_HOST
         valueFrom:
             fieldRef:
                 fieldPath: status.hostIP
   

   With this, any pod running your application is able to send DogStatsD metrics through port 8125 on $DD_AGENT_HOST.

Linux에서는 cgroups와 관련된 procfs 항목에서 컨테이너 ID를 추출할 수 있습니다. 클라이언트는 /proc/self/cgroup 또는 /proc/self/mountinfo에서 데이터를 읽어 컨테이너 ID 파싱을 시도합니다.

cgroup v2에서는 /proc/self/cgroup에서 cgroup 경로를 리졸브하고, 이를 /proc/self/mountinfo의 cgroup 마운트 지점과 결합하여 컨테이너 ID를 추론할 수 있습니다. 그 결과로 생성되는 디렉터리의 inode가 Datadog Agent로 전송됩니다. Datadog Agent가 클라이언트와 동일한 노드에 있는 경우, 이 정보를 사용하여 포드의 UID를 식별할 수 있습니다.

UDP를 통해 출처 감지를 활성화하려면, 애플리케이션 매니페스트에 다음 행을 추가합니다.

env:
- name: DD_ENTITY_ID
    valueFrom:
      fieldRef:
        fieldPath: metadata.uid

DogStatsD 클라이언트는 내부 태그 entity_id를 추가합니다. 이 태그의 값은 DD_ENTITY_ID 환경 변수의 내용이며, 이것이 포드의 UID입니다.

포드에 다음 레이블 추가:

admission.datadoghq.com/enabled: "true"

포드에 이 레이블이 있으면 Admissions Controller가 환경 변수 DD_EXTERNAL_ENV를 주입합니다. 이 변수의 값이 메트릭과 함께 필드로 전송되고, Datadog Agent가 이것을 사용하여 메트릭의 출처를 파악할 수 있습니다.