Agent 6.0.0부터 Trace Agent는 기본적으로 활성화되어 있습니다. 비활성화된 경우 registry.datadoghq.com/agent 컨테이너에서 환경 변수 DD_APM_ENABLED=true를 전달하여 다시 활성화할 수 있습니다.

이 페이지의 CLI 명령은 Docker 런타임 기준입니다. containerd 런타임을 사용하는 경우 docker 대신 nerdctl를 사용하고, Podman 런타임을 사용하는 경우 podman를 사용하세요.

호스트에서 추적하기

트레이싱은 8126/tcp 포트에서 사용할 수 있으며, 호스트에서만 접근 가능하도록 하려면 docker run 명령에 -p 127.0.0.1:8126:8126/tcp 옵션을 추가합니다.

_모든 호스트_에서 접근 가능하게 하려면 -p 8126:8126/tcp를 사용하세요.

예를 들어 다음 명령은 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 \
              -p 127.0.0.1:8126:8126/tcp \
              -e DD_API_KEY=<DATADOG_API_KEY> \
              -e DD_APM_ENABLED=true \
              -e DD_SITE=<DATADOG_SITE> \
              registry.datadoghq.com/agent:latest

docker run -d -p 127.0.0.1:8126:8126/tcp \
              -e DD_API_KEY=<DATADOG_API_KEY> \
              -e DD_APM_ENABLED=true \
              -e DD_SITE=<DATADOG_SITE> \
              registry.datadoghq.com/agent:latest

Docker APM Agent 환경 변수

다음 환경 변수를 사용하여 Docker Agent의 트레이싱 기능을 구성할 수 있습니다. 자세한 내용은 샘플 config_template.yaml 파일을 참조하세요.

DD_API_KEY

필수 - string
Datadog API 키입니다.

DD_SITE

선택 사항 - string
Datadog 사이트입니다. 이를 다음으로 설정: .
Default: datadoghq.com

DD_APM_ENABLED

선택 사항 - Boolean - 기본값: true
true(기본값)로 설정하면 Datadog Agent가 트레이스 및 트레이스 메트릭을 수신합니다.

DD_APM_RECEIVER_PORT

선택 사항 - integer - 기본값: 8126
Datadog Agent의 트레이스 수신기가 수신 대기하는 포트를 설정합니다. HTTP 수신기를 비활성화하려면 0로 설정하세요.

DD_APM_RECEIVER_SOCKET

선택 사항 - string
UNIX Domain Socket을 통해 트레이스를 수집하려면 UNIX 소켓 경로를 지정합니다. 설정된 경우 호스트명 및 포트 설정보다 우선 적용되며, 유효한 소켓 파일을 가리켜야 합니다.

DD_APM_NON_LOCAL_TRAFFIC

선택 사항 - Boolean - 기본값: false
true로 설정하면 Datadog Agent가 로컬이 아닌 트래픽도 수신합니다. 다른 컨테이너에서 트레이싱하는 경우, 이 환경 변수를 true로 설정해야 합니다.

DD_APM_DD_URL

선택 사항 - string
APM에 프록시를 사용하려면 엔드포인트와 포트를 <ENDPOINT>:<PORT> 형식으로 지정합니다. 프록시는 TCP 연결을 처리할 수 있어야 합니다.

DD_APM_CONNECTION_LIMIT

필수 - integer - 기본값: 2000
30초 시간 창 내에서 허용되는 최대 APM 연결 수를 설정합니다. 자세한 내용은 Agent 속도 제한을 참조하세요.

DD_APM_IGNORE_RESOURCES

선택 사항 - [string]
Datadog Agent가 무시해야 하는 리소스의 제외 목록을 제공합니다. 트레이스의 리소스 이름이 이 목록의 정규식 중 하나 이상과 일치하는 경우 해당 트레이스는 Datadog으로 전송되지 않습니다.
예시: "GET /ignore-me","(GET\|POST) and-also-me".

DD_APM_FILTER_TAGS_REQUIRE

선택 사항 - object
태그 기반 트레이스 필터링 규칙을 정의합니다. Datadog으로 전송되려면 트레이스에 이러한 태그가 있어야 합니다. APM에서 원치 않는 리소스 무시를 참조하세요.

DD_APM_FILTER_TAGS_REGEX_REQUIRE

선택 사항 - object
Agent 7.49 이상에서 지원됩니다. 정규식을 사용하는 태그 기반 트레이스 필터링 규칙을 정의합니다. Datadog으로 전송되려면 트레이스의 태그가 정의된 정규식 패턴과 일치해야 합니다.

DD_APM_FILTER_TAGS_REJECT

선택 사항 - object
태그 기반 트레이스 필터링 규칙을 정의합니다. 트레이스에 이러한 태그가 있으면 Datadog으로 전송되지 않습니다. 자세한 내용은 APM에서 원치 않는 리소스 무시를 참조하세요.

DD_APM_FILTER_TAGS_REGEX_REJECT

선택 사항 - object
Agent 7.49 이상에서 지원됩니다. 정규식을 사용하는 태그 기반 트레이스 필터링 규칙을 정의합니다. 태그가 이러한 정규식 패턴과 일치하는 경우 해당 트레이스는 Datadog으로 전송되지 않습니다.

DD_APM_REPLACE_TAGS

선택 사항 - [object]
잠재적으로 민감한 정보를 포함하는 태그를 대체하거나 제거하기 위한 규칙 집합을 정의합니다.

DD_HOSTNAME

선택 사항 - string - 기본값: 자동으로 감지됨
자동 호스트 이름 감지에 실패한 경우 또는 Datadog Cluster Agent를 실행하는 경우 메트릭에 사용할 호스트 이름을 설정합니다.

DD_DOGSTATSD_PORT

선택 사항 - integer - 기본값: 8125
DogStatsD 포트를 설정합니다.

DD_PROXY_HTTPS

선택 사항 - string
인터넷에 연결하기 위해 프록시를 사용하는 경우 URL을 제공합니다.

DD_BIND_HOST

선택 사항 - string - 기본값: localhost
DogStatsD 및 트레이스 수신을 위한 리스닝 호스트를 설정합니다.

DD_LOG_LEVEL

선택 사항 - string - 기본값: info
최소 로깅 수준을 설정합니다. 유효한 옵션은 trace, debug, info, warn, error, critical, off입니다.

다른 컨테이너에서 트레이싱

DogStatsD와 마찬가지로, 다른 컨테이너에서도 Docker 네트워크 또는 Docker 호스트 IP를 사용하여 Agent로 트레이스를 전송할 수 있습니다.

Docker 네트워크

첫 번째 단계로, 사용자 정의 브리지 네트워크를 생성합니다:

docker network create <NETWORK_NAME>

이 페이지의 CLI 명령은 Docker 런타임 기준입니다. containerd 런타임을 사용하는 경우 docker 대신 nerdctl를 사용하고, Podman 런타임을 사용하는 경우 podman를 사용하세요.

다음으로는 이전에 만든 네트워크와 연결된 Agent 및 애플리케이션 컨테이너를 시작합니다.

# Datadog Agent
docker run -d --name datadog-agent \
              --network <NETWORK_NAME> \
              --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_APM_ENABLED=true \
              -e DD_SITE=<DATADOG_SITE> \
              -e DD_APM_NON_LOCAL_TRAFFIC=true \
              registry.datadoghq.com/agent:latest
# Application
docker run -d --name app \
              --network <NETWORK_NAME> \
              -e DD_AGENT_HOST=datadog-agent \
              company/app:latest

# Datadog Agent
docker run -d --name datadog-agent \
              --cgroupns host \
              --pid host \
              --network "<NETWORK_NAME>" \
              -e DD_API_KEY=<DATADOG_API_KEY> \
              -e DD_APM_ENABLED=true \
              -e DD_SITE=<DATADOG_SITE> \
              -e DD_APM_NON_LOCAL_TRAFFIC=true \
              registry.datadoghq.com/agent:latest
# Application
docker run -d --name app \
              --network "<NETWORK_NAME>" \
              -e DD_AGENT_HOST=datadog-agent \
              company/app:latest

이렇게 하면 app 컨테이너 내에서 호스트 이름 datadog-agent가 노출됩니다. docker-compose를 사용하는 경우 <NETWORK_NAME> 파라미터는 docker-compose.yml의 networks 섹션에서 정의된 값입니다.

애플리케이션 SDK는 이 주소로 트레이스를 전송하도록 구성되어야 합니다. 애플리케이션 컨테이너에서 DD_AGENT_HOST에는 Agent 컨테이너 이름을, DD_TRACE_AGENT_PORT에는 Agent Trace 포트를 설정하는 환경 변수를 지정하세요. 위 예시는 호스트 datadog-agent와 포트 8126(기본값이므로 별도 설정 불필요)을 사용합니다.

또는 아래 예시와 같이 지원되는 각 언어에서 Agent 호스트를 수동으로 설정할 수 있습니다.

DD_AGENT_HOST=datadog-agent \
DD_TRACE_AGENT_PORT=8126 \
java -javaagent:/path/to/the/dd-java-agent.jar -jar /your/app.jar

java -javaagent:/path/to/the/dd-java-agent.jar \
     -Ddd.agent.host=datadog-agent \
     -Ddd.agent.port=8126 \
     -jar /your/app.jar

from ddtrace import tracer

tracer.configure(
    hostname='datadog-agent',
    port=8126,
)

Datadog.configure do |c|
  c.agent.host = 'datadog-agent'
  c.agent.port = 8126
end

package main

import (
  "github.com/DataDog/dd-trace-go/v2/ddtrace/tracer"
)

func main() {
    tracer.Start(tracer.WithAgentAddr("datadog-agent:8126"))
    defer tracer.Stop()
}

const tracer = require('dd-trace').init({
    hostname: 'datadog-agent',
    port: 8126
});

# Environment variables
export CORECLR_ENABLE_PROFILING=1
export CORECLR_PROFILER={846F5F1C-F9AE-4B07-969E-05C26BC060D8}
export CORECLR_PROFILER_PATH=<SYSTEM_DEPENDENT_PATH>
export DD_DOTNET_TRACER_HOME=/opt/datadog

# For containers
export DD_AGENT_HOST=datadog-agent
export DD_TRACE_AGENT_PORT=8126

# Start your application
dotnet example.dll

Docker 호스트 IP

Agent 컨테이너의 포트 8126은 호스트에 직접 연결되어야 합니다. 애플리케이션 트레이서를 이 컨테이너의 기본 경로로 보고하도록 구성하세요(ip route 명령을 사용해 확인 가능).

다음은 172.17.0.1이 기본 경로라고 가정한 Python Tracer 예시입니다.

from ddtrace import tracer

tracer.configure(hostname='172.17.0.1', port=8126)

Unix Domain Socket(UDS)

소켓을 통해 트레이스를 전송하려면 해당 소켓을 Agent 컨테이너와 애플리케이션 컨테이너 모두에 마운트해야 합니다.

# Datadog Agent
docker run -d --name datadog-agent \
              --network <NETWORK_NAME> \
              --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 \
              -v /var/run/datadog/:/var/run/datadog/ \
              -e DD_API_KEY=<DATADOG_API_KEY> \
              -e DD_APM_ENABLED=true \
              -e DD_SITE=<DATADOG_SITE> \
              -e DD_APM_NON_LOCAL_TRAFFIC=true \
              -e DD_APM_RECEIVER_SOCKET=/var/run/datadog/apm.socket \
              registry.datadoghq.com/agent:latest
# Application
docker run -d --name app \
              --network <NETWORK_NAME> \
              -v /var/run/datadog/:/var/run/datadog/ \
              -e DD_TRACE_AGENT_URL=unix:///var/run/datadog/apm.socket \
              company/app:latest

트레이서 설정에 대해서는 언어별 APM 계측 문서를 참조하세요.

추가 자료

추가 유용한 문서, 링크 및 기사:

소스 코드소스 코드 ECS 애플리케이션 추적설명서 애플리케이션 로그 수집설명서 애플리케이션 메트릭 및 로그 자동 수집설명서 데이터 수집을 컨테이너의 하위 집합으로만 제한설명서 컨테이너에서 내보내는 모든 데이터에 태그 할당설명서