설치 시 주의

대상 플랫폼 : 모든 Linux 계열, Docker, K8s

Datadog console - Integration > Agent 메뉴에서 해당 OS를 선택 후 설치 및 Upgrade 작업을 생성된 Command Script로 진행하실 경우 아래 사항을 유의하시기 바랍니다.

현재 신규 기능으로 APM을 자동으로 설치하는 기능(Single Step APM Instrumentation)이 beta로 추가 (2023년 8월) 되면서 Additional Options – Enable APM Instrumentation 기능을 On/Off 해 Command Script에 환경 변수를 추가/제외하는 부분이 생겼습니다.

해당 기능의 Default 설정 값이 ON으로 되어 있어서 Command Script 환경 변수에 자동으로 추가 되어있습니다.

해당 기능을 Default 그대로 ON 상태로 설치 하시는 경우 자동적으로 APM 관련 기능이 설치 및 설정되어 의도하지 않은 APM 요금이 발생할 수 있으며, 아직 Beta 임으로 의도치 않은 문제가 발생할 수 있음으로
스크립트로 Agent 설치를 진행하시는 경우, Command에 DD_APM_INSTRUMENTATION_ENABLED 항목이 있는 경우, 필히 해당 환경 변수를 제거 후 진행하시기 바랍니다.

관련된 현상

아래와 같은 경로에 대한 특정 에러 및 문제가 발생하는 경우, 위와 같이 Agent를 설치했는지 확인하시기 바랍니다.

/opt/datadog/apm/library/

해당 경로는 Single Step APM Instrucmentation 기능을 위해 Script를 통한 Agent 설치 Command 에 DD_APM_INSTRUMENTATION_ENABLED 환경변수를 추가 했을 때 생성되는 경로 임으로

해당 경로 관련한 문제가 발생한 경우에는 아래 가이드를 참고하여 조치하시기 바랍니다.

• Linux host or VM

  • 라이브러리를 삭제합니다.

    dd-host-install --uninstall

  • Host를 재시작 하시기 바랍니다.

• Docker

  • 라이브러리를 삭제합니다.

    dd-container-install --uninstall

  • Docker를 재시작합니다.

    systemctl restart docker

    혹은 환경에 맞는 명령어를 통해 Docker를 재시작하시기 바랍니다.

• Kubernetes(helm)

  • Datadog value.yaml 에서 apm 하위의 instrumentation: 항목을 제거합니다.

  • 아래 명령어를 통해 value.yaml을 재적용합니다.

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

  • 서비스를 재시작 합니다.

https://docs.datadoghq.com/ko/tracing/trace_collection/automatic_instrumentation/single-step-apm/?tab=linuxhostorvm#removing-apm-for-all-services-on-the-infrastructure