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이 활성화되면 기본 구성은 호스트에 디렉터리를 생성하고 이를 Agent 내부에 마운트합니다. 그런 다음 Agent는 다음 소켓 파일 /var/run/datadog/apm/apm.socket을 생성하고 수신 대기합니다. 애플리케이션 포드도 동일한 볼륨을 마운트하여 같은 소켓에 기록할 수 있습니다. features.apm.unixDomainSocketConfig.path 경로와 소켓 파일은 구성 값을 통해 변경할 수 있습니다.

After making your changes, apply the new configuration by using the following command:

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.apm.socketEnabled가 datadog-values.yaml에서 true로 설정되어 있는지 확인합니다.

datadog:
  apm:
    socketEnabled: true    

기본 구성은 호스트에 디렉터리를 생성하고 이를 Agent 내부에 마운트합니다. 그런 다음 Agent는 다음 소켓 파일 /var/run/datadog/apm.socket을 생성하고 수신 대기합니다. 애플리케이션 포드도 동일한 볼륨을 마운트하여 같은 소켓에 기록할 수 있습니다. 경로와 소켓 파일은 datadog.apm.hostSocketPath 및 datadog.apm.socketPath 구성 값을 통해 변경할 수 있습니다.

datadog:
  apm:
    # the following values are default:
    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 Admission Controller는 애플리케이션 포드 구성을 간소화하는 Datadog Cluster Agent의 구성 요소입니다. Datadog Admission Controller 설명서를 읽어 자세히 알아보세요.

Datadog Admission Controller를 사용하여 환경 변수를 주입하고 새로운 애플리케이션 포드에 필요한 볼륨을 마운트하여 포드와 Agent 간의 트레이스 통신을 자동으로 구성합니다. Admission Controller를 사용한 라이브러리 주입 설명서를 읽어 애플리케이션을 자동으로 구성하여 Datadog Agent에 트레이스를 제출하는 방법을 알아보세요.

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

트레이스를 내보내도록 애플리케이션 SDK 구성:

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

TCP(<IP_ADDRESS>:8126)를 사용하여 Agent로 트레이스를 전송하는 경우, 이 IP 주소를 애플리케이션 포드에 제공하세요. Datadog Admission Controller를 사용하여 자동으로 구성하거나 수동으로 하향 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

참고: 이 구성을 사용하려면 Agent가 TCP를 통해 트레이스를 수신할 수 있어야 합니다.

트레이스를 내보내도록 애플리케이션 SDK 구성:

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

After making your changes, apply the new configuration by using the following command:

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 설치는 이것을 허용하지 않습니다.

추가 APM 환경 변수를 override.nodeAgent.containers.trace-agent.env 아래에 설정하세요.

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

추가 APM 환경 변수를 agents.containers.traceAgent.env 아래에 설정하세요.

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>