개요

자동 계측을 이용하면 애플리케이션 스팬을 자동으로 생성할 수 있습니다. 이에 따라 수동 작업을 최소화하면서 다양한 표준 운영 체계와 대중적인 프레임워크에서 관측 데이터를 캡처할 수 있습니다. 단일 단계 계측으로 Datadog를 설치하거나 코드에 Datadog 추적 라이브러리를 수동으로 추가하여 애플리케이션을 자동으로 계측할 수 있습니다.

사용 사례

자동 계측을 사용할 수 있는 시나리오에는 다음이 있습니다.

  • 최소한의 구성으로 일반 라이브러리와 프로그램 언어 전반에서 핵심 관측 데이터를 캡처
  • 사전 구성 설정으로 실시간 모니터링을 실시하여 애플리케이션 성능에 즉각적인 인사이트 제공
  • 커스텀 계측이 필요하지 않은 프로젝트에 관측 설정을 간소화

시작하기

자동 계측 방법에 관한 자세한 정보를 보려면 다음 관련 설명서를 참고하세요.

APM 계측 활성화(베타) 옵션을 선택한 상태로 Datadog 에이전트를 설치하거나 업데이트하면 APM이 활성화된 상태로 에이전트가 설치 및 구성됩니다. 이 경우 추가 설치나 구성 단계 없이 애플리케이션을 자동으로 계측할 수 있습니다.

시작하려면 단일 단계 계측 설명서를 참고하세요.

Datadog 라이브러리로 애플리케이션을 자동으로 계측을 하는 방법:

  1. 에이전트를 설치 및 구성합니다.
  2. Datadog 추적 라이브러리를 내 코드에 추가합니다.

에이전트 설치 및 구성

계측된 애플리케이션에서 트레이스를 수신하도록 Datadog 에이전트를 설치 및 구성합니다. 기본적으로 Datadog 에이전트가 datadog.yaml 파일의 apm_config 아래 enabled: true로 설정되어 트레이스를 수신하도록 구성되어 있고 http://localhost:8126에서 트레이스 데이터를 수신합니다.

컨테이너화된 환경의 경우 Datadog 에이전트 내에서 트레이스를 수집하려면 다음 링크에 안내된 단계를 따르세요.

컨테이너

  1. datadog.yaml 구성 파일apm_config 섹션에서 apm_non_local_traffic: true로 설정하세요.
  2. 구체적인 설정 지침을 잘 확인하여 에이전트가 컨테이너화된 환경에서 트레이스를 수신하도록 구성되어 있는지 확인하세요.
Docker
Kubernetes
Amazon ECS
ECS Fargate

  1. 트레이스 클라이언트는 기본적으로 트레이스를 Unix Domain Socket /var/run/datadog/apm.socket로 보냅니다. 소켓이 존재하지 않으면 트레이스를 http://localhost:8126로 전송합니다.

    다른 소켓, 호스트, 또는 포트가 필요하면 환경 변수 DD_TRACE_AGENT_URL를 사용하세요. 다음 예를 참고하세요.

    DD_TRACE_AGENT_URL=http://custom-hostname:1234
    DD_TRACE_AGENT_URL=unix:///var/run/datadog/apm.socket
    

    마찬가지로 트레이스 클라이언트는 데이터를 Unix Domain Socket /var/run/datadog/dsd.socket로 전송합니다. 소켓이 존재하지 않으면 http://localhost:8125로 전송합니다.

  1. 에이전트가 올바른 Datadog 위치로 데이터를 전송하도록 하려면 Datadog 에이전트의 DD_SITE로 설정하세요.

AWS Lambda

AWS Lambda에서 Datadog APM을 설정하려면 추적 서버리스 함수 설명서를 참고하세요.

다른 환경

Heroku, Cloud Foundry, AWS Elastic Beanstalk, Azure App Service와 같은 다른 환경에서도 추적을 이용할 수 있습니다.

다른 환경의 경우 통합 설명서에서 해당 환경에 관한 내용을 참고하고 설정 문제가 발생하면 지원팀에 문의하세요.

애플리케이션 계측

다음 공식 Datadog 추적 라이브러리 중 하나를 사용해 애플리케이션에서 트레이스를 전송하도록 설정할 수 있습니다.

Java
Python
Ruby
go
Node.js
PHP
C++
.Net
.Net
Android
iOS

공식 라이브러리 지원이 되지 않는 언어로 구축한 애플리케이션을 계측하려면 커뮤니티 추적 라이브러리를 참고하세요.

참고 자료

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

PREVIEWING: may/unit-testing