Single Step APM 계측 (Single Step APM Instrumentation)
Single Step Instrumentation(SSI)은 별도 설정 없이 Datadog SDK를 자동으로 설치해 주는 방식이에요. 온보딩 시간이 며칠에서 몇 분으로 줄어들죠. 이 페이지에서는 SSI가 어떻게 동작하는지, 어떤 준비 작업이 필요한지, 그리고 배포 유형별로 어떻게 설정하는지 설명해요.
출처: 문서
본문
개요 (Overview)
Single Step Instrumentation(SSI)은 추가 설정 없이 Datadog SDK를 자동으로 설치해 줘요. 그래서 온보딩 시간이 며칠에서 몇 분으로 크게 줄어들어요.
동작 방식이 궁금하다면 Single Step Instrumentation용 인젝터 가이드를 참고하세요.
에이전트로 APM을 설정하려면 AI 코딩 에이전트에 dd-apm 스킬을 설치해 안내받아 설정할 수도 있어요.
npx skills add https://github.com/datadog-labs/agent-skills --skill dd-apm --full-depth -y
사전 준비 (Prerequisites)
- 애플리케이션에서 커스텀 계측 코드를 제거하고 다시 시작하세요. 커스텀 계측이 감지되면 SSI는 자동으로 비활성화돼요.
- 지원되는 언어, 운영체제, 아키텍처를 확인하려면 SSI 호환성 가이드를 보고 환경 호환성을 확인하세요.
애플리케이션 전반에 SDK 계측하기 (Instrument SDKs across applications)
APM 계측이 활성화된 상태로 Datadog Agent를 설치하거나 업데이트하면, Agent가 지원되는 프로세스에 Datadog SDK를 로드해 애플리케이션을 계측해요. 이 방식은 코드 변경 없이 서비스에서 트레이스 데이터를 수집해 보내 분산 트레이싱을 가능하게 해요.
계측 후에는 선택적으로 다음도 할 수 있어요.
- Unified Service Tags(UST) 구성
- Continuous Profiler나 Application Security Monitoring처럼 SDK에 의존하는 추가 제품·기능 활성화
배포 유형별로 SSI를 설정하는 방법은 아래 타일 중 하나를 클릭해 확인하세요.
문제 해결 (Troubleshooting)
SSI로 APM을 활성화할 때 문제가 생기면 SSI 문제 해결 가이드를 참고하세요.
더 알아보기 (Learn more)
- Runtime Metrics 활성화
- Single Step Instrumentation에서 인젝터 동작 이해하기
- Single Step APM 문제 해결
- 로컬 SDK 주입을 사용해 애플리케이션 계측하기
- 호스트에서 APM 계측 문제 해결 (학습 과정)
- Datadog CSI 드라이버로 보안 Kubernetes 환경에 고성능 관측성 도입하기
- 단일 명령으로 Java 앱에 end-to-end 가시성 확보하기
- Single Step Instrumentation 규칙으로 호스트 간 서비스 트레이싱 관리하기
- 트레이스까지 한 걸음: 스택에 맞는 APM 계측 방식 고르기