datadog-agent.yaml을 편집해 features.apm.enabled를 true로 설정합니다.

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

  features:
    apm:
      enabled: true
      unixDomainSocketConfig:
        path: /var/run/datadog/apm.socket # default

APM이 활성화되면 기본 설정은 호스트에 디렉토리를 생성하고 에이전트 내에 마운트합니다. 그런 다음 에이전트는 /var/run/datadog/apm/apm.socket 소켓 파일을 생성하고 수신 대기합니다. 그러면 애플리케이션 포드도 마찬가지로 이 볼륨을 마운트하고 동일한 소켓에 쓸 수 있습니다. 또한, features.apm.unixDomainSocketConfig.path 설정 값으로 경로와 소켓을 수정할 수 있습니다.

변경한 후 다음 명령을 사용해 새 구성을 적용하세요.

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

참고: minikube에서는 Unable to detect the kubelet URL automatically 오류가 발생할 수 있습니다. 이 경우에는 global.kubelet.tlsVerify를 false로 설정하세요.

Helm을 사용하여 Datadog Agent를 설치한 경우 APM은 UDS 또는 Windows 명명된 파이프를 통해 기본적으로 활성화됩니다.

활성화하려면 datadog-values.yaml에서 datadog.apm.socketEnabled가 true로 설정되어 있는지 확인하세요.

datadog:
  apm:
    socketEnabled: true    

기본 설정은 호스트에 디렉토리를 생성하고 에이전트 내에 마운트합니다. 그런 다음 에이전트는 소켓 파일 /var/run/datadog/apm.socket을 생성하고 수신 대기합니다. 그러면 애플리케이션 포드도 유사한 방식으로 이 볼륨을 마운트하고 동일한 소켓에 쓸 수 있습니다. 또한, datadog.apm.hostSocketPath와 datadog.apm.socketPath 설정 값으로 경로와 소켓을 수정할 수 있습니다.

datadog:
  apm:
    # 다음 값이 기본값입니다
    socketEnabled: true
    hostSocketPath: /var/run/datadog/
    socketPath: /var/run/datadog/apm.socket

APM를 비활성화하려면 datadog.apm.socketEnabled를 false로 설정합니다.

After making your changes, upgrade your Datadog Helm chart using the following command:

helm upgrade -f datadog-values.yaml <RELEASE NAME> datadog/datadog

참고: minikube에서는 Unable to detect the kubelet URL automatically 오류가 발생할 수 있습니다. 이 경우에는 datadog.kubelet.tlsVerify를 false로 설정하세요.

Datadog 어드미션 컨트롤러는 애플리케이션 포드 설정을 간소화하는 Datadog 클러스터 에이전트의 구성 요소입니다. 자세한 내용은 Datadog 어드미션 컨트롤러 도움말을 참조하세요.

Datadog 어드미션 컨트롤러를 사용하여 환경 변수를 주입하고 필요한 볼륨을 새 애플리케이션 포드에 마운트하여 포드 및 에이전트 트레이스 통신을 자동으로 설정할 수 있습니다. Datadog 에이전트에 트레이스를 제출하도록 애플리케이션을 자동으로 설정하는 방법은 어드미션 컨트롤러를 사용하여 라이브러리 주입 도움말을 참조하세요.

UDS를 사용하여 Agent에 트레이스를 보내는 경우 (Agent 가 생성한) 소켓이 있는 호스트 디렉터리를 애플리케이션 컨테이너에 마운트하고 DD_TRACE_AGENT_URL을 사용하여 소켓 경로를 지정합니다.

apiVersion: apps/v1
kind: Deployment
#(...)
    spec:
      containers:
      - name: "<CONTAINER_NAME>"
        image: "<CONTAINER_IMAGE>/<TAG>"
        env:
        - name: DD_TRACE_AGENT_URL
          value: 'unix:///var/run/datadog/apm.socket'
        volumeMounts:
        - name: apmsocketpath
          mountPath: /var/run/datadog
        #(...)
      volumes:
        - hostPath:
            path: /var/run/datadog/
          name: apmsocketpath

애플리케이션 트레이서가 트레이스를 내보내도록 설정합니다:

트레이스를 수집하도록 Datadog Agent를 구성하고 트레이스를 보낼 위치에 대한 구성을 애플리케이션 파드에 제공합니다. 그런 다음 애플리케이션에 Datadog 트레이스를 설치하여 트레이스를 내보냅니다. 이 작업이 완료되면 트레이서는 트레이스를 적절한 DD_TRACE_AGENT_URL 엔드포인트로 보냅니다.

TCP (<IP_ADDRESS>:8126)를 사용하여 에이전트에 트레이스를 전송하는 경우, 이 IP 주소를 애플리케이션 포드에 제공하세요. 자동으로 Datadog 어드미션 컨트롤러를 사용하거나 수동으로 하향 API를 사용하여 호스트 IP를 가져옵니다. 애플리케이션 컨테이너에는 status.hostIP을 가리키는 DD_AGENT_HOST환경 변수가 필요합니다:

apiVersion: apps/v1
kind: Deployment
#(...)
    spec:
      containers:
      - name: "<CONTAINER_NAME>"
        image: "<CONTAINER_IMAGE>/<TAG>"
        env:
          - name: DD_AGENT_HOST
            valueFrom:
              fieldRef:
                fieldPath: status.hostIP

**참고: **이 설정을 사용하려면 에이전트가 TCP를 통해 트레이스를 수신할 수 있어야 합니다.

애플리케이션 트레이서가 트레이스를 내보내도록 설정합니다:

트레이스를 수집하도록 Datadog Agent를 구성하고 트레이스를 보낼 위치에 대한 구성을 애플리케이션 파드에 제공합니다. 그런 다음 애플리케이션에 Datadog 트레이스를 설치하여 트레이스를 내보냅니다. 이 작업이 완료되면 트레이서는 트레이스를 적절한 DD_AGENT_HOST 엔드포인트로 자동으로 보냅니다.

다음을 사용해 datadog-agent.yaml을 업데이트합니다.

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

  features:
    apm:
      enabled: true
      hostPortConfig:
        enabled: true
        hostPort: 8126 # default

변경한 후 다음 명령을 사용해 새 구성을 적용하세요.

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

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

datadog-values.yaml 파일을 다음 APM 구성으로 업데이트합니다.

datadog:
  apm:
    portEnabled: true
    port: 8126 # default

After making your changes, upgrade your Datadog Helm chart using the following command:

helm upgrade -f datadog-values.yaml <RELEASE NAME> datadog/datadog

경고: datadog.apm.portEnabled 파라미터는 호스트의 포트를 엽니다. 방화벽이 애플리케이션이나 신뢰할 수 있는 소스의 액세스만 허용하는지 확인하세요. 네트워크 플러그인이 hostPorts를 지원하지 않는 경우 Agent 파드 사양에 hostNetwork: true를 추가합니다. 이를 통해 호스트의 네트워크 네임스페이스를 Datadog Agent와 공유합니다. 또한 컨테이너에서 열려 있는 모든 포트가 호스트에서 열려 있음을 의미합니다. 포트가 호스트와 컨테이너 모두에서 사용되는 경우 충돌이 발생하고(동일한 네트워크 네임스페이스를 공유하므로) 파드가 시작되지 않습니다. 일부 Kubernetes 설치에서는 이를 허용하지 않습니다.

override.nodeAgent.containers.trace-agent.env에서 추가 APM 환경 변수를 설정합니다.

apiVersion: datadoghq.com/v2alpha1
kind: DatadogAgent
metadata:
  name: datadog
spec:
  override:
    nodeAgent:
      containers:
        trace-agent:
          env:
            - name: <ENV_VAR_NAME>
              value: <ENV_VAR_VALUE>

agents.containers.traceAgent.env에서 추가 APM 환경 변수를 설정합니다.

agents:
  containers:
    traceAgent:
      env:
        - name: <ENV_VAR_NAME>
          value: <ENV_VAR_VALUE>

DaemonSet 또는 Deployment(Datadog Cluster Agent의 경우)에 환경 변수를 추가합니다.

apiVersion: apps/v1
kind: DaemonSet
metadata:
  name: datadog
spec:
  template:
    spec:
      containers:
        - name: agent
          ...
          env:
            - name: <ENV_VAR_NAME>
              value: <ENV_VAR_VALUE>