단 하나의 명령으로 Agent를 설치, 구성 및 시작하고 AAP로 서비스를 계측할 수 있습니다.

Ubuntu 호스트의 경우:

1. 한 줄 설치 명령을 실행합니다.

   DD_API_KEY=<YOUR_DD_API_KEY> DD_SITE="<YOUR_DD_SITE>" DD_APM_INSTRUMENTATION_ENABLED=host DD_APM_INSTRUMENTATION_LIBRARIES="java:1,python:3,js:5,dotnet:3,php:1" DD_APPSEC_ENABLED=true bash -c "$(curl -L https://install.datadoghq.com/scripts/install_script_agent7.sh)"
   

   a. Datadog API 키를 <YOUR_DD_API_KEY>로 바꿉니다.

   b. Datadog 사이트를 <YOUR_DD_SITE>로 바꿉니다.

   You can also optionally configure the following:

   • Specifying tracing library versions.
   • Tagging observability data by environment.

2. 현재 셸 세션을 종료합니다.

3. 셸 세션을 시작하세요.

4. 호스트나 VM에서 서비스를 재시작합니다.

5. Datadog에서 서비스 성능 Observability에 대해 알아보세요.

참고: AAP Threat Protection와 Code Security 모두 단일 단계로 구성하려면 한 줄 설치 명령에 환경 변수 DD_APPSEC_ENABLED=true, DD_IAST_ENABLED=true를 추가합니다.

추적 라이브러리 버전 지정

기본적으로 서버에서 APM을 활성화하면 Java, Python, Node.js, .NET Core 서비스용 지원이 설치됩니다. 해당 언어의 일부로만 구현된 서비스가 있는 경우 한 줄 설치 명령에 DD_APM_INSTRUMENTATION_LIBRARIES를 설정합니다.

DD_APM_INSTRUMENTATION_LIBRARIES="java:1.25.0,python" DD_API_KEY=<YOUR_DD_API_KEY> DD_SITE="<YOUR_DD_SITE>" DD_APM_INSTRUMENTATION_ENABLED=host DD_APPSEC_ENABLED=true DD_ENV=staging bash -c "$(curl -L https://install.datadoghq.com/scripts/install_script_agent7.sh)"

언어 이름 뒤에 콜론을 붙이고 추적 라이브러리 버전을 지정하여 추적 라이브러리의 버전 번호를 옵션으로 제공할 수 있습니다. 버전을 지정하지 않으면 기본값으로 최신 버전이 사용됩니다. 언어 이름은 쉼표로 구분합니다.

지원되는 언어는 다음과 같습니다.

• .NET (dotnet)
• Python (python)
• Java (java)
• Node.js (js)
• PHP (php)

참고: Node.js 추적 라이브러리의 경우, Node.js 버전에 따라 호환되는 Node.js 추적 라이브러리 버전이 다릅니다. 자세한 내용은 DataDog/dd-trace-js: JavaScript APM Tracer를 참조하세요.

환경별로 Observability 데이터 태그 지정

Linux 한 줄 설치 명령에 DD_ENV를 설정하면, Agent를 거치는 계측된 서비스 및 기타 텔레메트리를 특정 환경으로 자동 태그 지정할 수 있습니다. 예를 들어, 스테이징 환경에 Agent가 설치되어 있는 경우 DD_ENV=staging을 설정하여 Observability 데이터를 staging과 연결합니다.

예시:

DD_API_KEY=<YOUR_DD_API_KEY> DD_SITE="<YOUR_DD_SITE>" DD_APM_INSTRUMENTATION_ENABLED=host DD_APM_INSTRUMENTATION_LIBRARIES="java:1,python:3,js:5,dotnet:3,php:1" DD_APPSEC_ENABLED=true DD_ENV=staging bash -c "$(curl -L https://install.datadoghq.com/scripts/install_script_agent7.sh)"

Docker Linux 컨테이너의 경우:

1. 라이브러리 인젝터를 설치합니다.

   DD_APM_INSTRUMENTATION_ENABLED=docker DD_APM_INSTRUMENTATION_LIBRARIES="java:1,python:3,js:5,dotnet:3,php:1" DD_NO_AGENT_INSTALL=true DD_APPSEC_ENABLED=true bash -c "$(curl -L https://install.datadoghq.com/scripts/install_script_agent7.sh)"
   

2. Docker에서 Agent를 구성합니다.

   docker run -d --name dd-agent \
     -e DD_API_KEY=${YOUR_DD_API_KEY} \
     -e DD_APM_ENABLED=true \
     -e DD_APPSEC_ENABLED=true \
     -e DD_APM_NON_LOCAL_TRAFFIC=true \
     -e DD_DOGSTATSD_NON_LOCAL_TRAFFIC=true \
     -e DD_APM_RECEIVER_SOCKET=/opt/datadog/apm/inject/run/apm.socket \
     -e DD_DOGSTATSD_SOCKET=/opt/datadog/apm/inject/run/dsd.socket \
     -v /opt/datadog/apm:/opt/datadog/apm \
     -v /var/run/docker.sock:/var/run/docker.sock:ro \
     gcr.io/datadoghq/agent:7
   

   Datadog API 키를 <YOUR_DD_API_KEY>로 바꿉니다.
   You can also optionally configure the following:

   • Specifying tracing library versions.
   • Tagging observability data by environment.
3. Docker 컨테이너를 재시작합니다.
4. Datadog에서 서비스 성능 Observability에 대해 알아보세요.

추적 라이브러리 버전 지정

기본적으로 서버에서 APM을 활성화하면 Java, Python, Node.js, .NET 서비스용 지원이 설치됩니다. 해당 언어의 일부로만 구현된 서비스가 있는 경우 설치 스크립트 실행 시 DD_APM_INSTRUMENTATION_LIBRARIES를 설정합니다.

예를 들어, Java 추적 라이브러리 v1.25.0 및 최신 Python 추적 라이브러리만 지원하도록 설치하려면 설치 명령에 다음을 추가합니다.

DD_APM_INSTRUMENTATION_LIBRARIES="java:1.25.0,python" DD_APM_INSTRUMENTATION_ENABLED=docker DD_NO_AGENT_INSTALL=true DD_APPSEC_ENABLED=true bash -c "$(curl -L https://install.datadoghq.com/scripts/install_script_agent7.sh)"

언어 이름 뒤에 콜론을 붙이고 추적 라이브러리 버전을 지정하여 추적 라이브러리의 버전 번호를 옵션으로 제공할 수 있습니다. 버전을 지정하지 않으면 기본적값으로 최신 버전이 사용됩니다. 언어 이름은 쉼표로 구분합니다.

지원되는 언어는 다음과 같습니다.

• .NET (dotnet)
• Python (python)
• Java (java)
• Node.js (js)
• Ruby (ruby)
• PHP (php)

참고: Node.js 추적 라이브러리의 경우, Node.js 버전에 따라 호환되는 Node.js 추적 라이브러리 버전이 다릅니다. 자세한 내용은 DataDog/dd-trace-js: JavaScript APM Tracer를 참조하세요.

환경별로 Observability 데이터 태그 지정

Docker용 라이브러리 인젝터 설치 명령에 DD_ENV를 설정하면, Agent를 거치는 계측된 서비스 및 기타 텔레메트리를 특정 환경으로 자동 태그 지정할 수 있습니다. 예를 들어, 스테이징 환경에 Agent가 설치되어 있는 경우 DD_ENV=staging을 설정하여 Observability 데이터를 staging과 연결합니다.

예시:

docker run -d --name dd-agent \
  -e DD_API_KEY=${YOUR_DD_API_KEY} \
  -e DD_APM_ENABLED=true \
  -e DD_APPSEC_ENABLED=true \
  -e DD_ENV=staging \
  -e DD_APM_NON_LOCAL_TRAFFIC=true \
  -e DD_DOGSTATSD_NON_LOCAL_TRAFFIC=true \
  -e DD_APM_RECEIVER_SOCKET=/opt/datadog/apm/inject/run/apm.socket \
  -e DD_DOGSTATSD_SOCKET=/opt/datadog/apm/inject/run/dsd.socket \
  -v /opt/datadog/apm:/opt/datadog/apm \
  -v /var/run/docker.sock:/var/run/docker.sock:ro \
  gcr.io/datadoghq/agent:7

Datadog Helm 차트로 Agent를 설치하여 APM을 활성화할 수 있습니다. 이렇게 하면 DaemonSet이 적용된 Linux 기반 Kubernetes 클러스터의 모든 노드에 Datadog Agent가 배포됩니다.

참고: 단일 단계 계측은 Datadog Agent를 설치한 네임스페이스의 애플리케이션을 계측하지 않습니다. 애플리케이션을 실행하지 않는 클러스터의 별도 네임스페이스에 Agent를 설치할 것을 권장합니다.

필수 조건

• Helm이 설치되어 있는지 확인합니다.

설치

Helm으로 단일 단계 계측을 사용하는 방법

1. Helm Datadog 리포지토리를 추가합니다.

   helm repo add datadog https://helm.datadoghq.com
   helm repo update
   

2. Datadog API 키를 저장할 Kubernetes 시크릿을 생성합니다.

   kubectl create secret generic datadog-secret --from-literal api-key=$DD_API_KEY
   

1. 서비스 시작 명령에 DD_INSTRUMENT_SERVICE_WITH_APM 환경 변수를 추가합니다.

   DD_INSTRUMENT_SERVICE_WITH_APM=false <service_start_command>
   

2. 서비스를 다시 시작합니다.
3. AAP를 비활성화하려면 애플리케이션 설정에서 DD_APPSEC_ENABLED=true 환경 변수를 삭제하고 서비스를 다시 시작합니다.

1. 서비스 시작 명령에 DD_INSTRUMENT_SERVICE_WITH_APM 환경 변수를 추가합니다.

   docker run -e DD_INSTRUMENT_SERVICE_WITH_APM=false <service_start_command>
   

2. 서비스를 다시 시작합니다.
3. AAP를 비활성화하려면 애플리케이션 설정에서 DD_APPSEC_ENABLED=true 환경 변수를 삭제하고 서비스를 다시 시작합니다.

1. 포드 사양에서 admission.datadoghq.com/enabled: 레이블을 "false"로 설정합니다.

   spec:
     template:
       metadata:
         labels:
           admission.datadoghq.com/enabled: "false"
   

1. 실행:

   dd-host-install --uninstall
   

2. 호스트를 다시 시작합니다.

1. 로걸 라이브러리 인젝터 설치 삭제 방법

   dd-container-install --uninstall
   

2. Docker를 다시 시작합니다.

   systemctl restart docker
   

   또는 사용자 환경에 맞는 동일한 방법을 사용하세요.

1. apm:에서 instrumentation:을 제거하고 datadog-values.yaml에서 다음 구성을 모두 제거합니다.
2. asm:에서 threats:을 제거하고 datadog-values.yaml에서 다음 구성을 모두 제거합니다.
3. 다음 명령을 실행합니다:

   helm upgrade datadog-agent -f datadog-values.yaml datadog/datadog