호환성 요구 사항

최신 Java Tracer는 JVM 버전 8 이후의 모든 버전을 지원합니다. JVM 8 이전 버전에 관한 자세한 정보는 지원되는 JVM 런타임을 참조하세요.

Datadog의 Java 버전과 프레임워크 지원(레거시 및 유지 보수 버전 포함) 전체 목록은 호환성 요구사항을 참고하세요.

시작하기

시작하기 전에 먼저 Agent트를 설치하고 구성했는지 확인하세요.

애플리케이션 계측

Datadog Agent를 설치하고 구성했으면, 다음 단계로 애플리케이션을 계측할 SDK를 애플리케이션에 직접 추가합니다. 자세한 정보는 호환성 정보를 참조하세요.

애플리케이션 추적을 시작하는 방법:

1. 최신 트레이서 클래스 파일이 포함된 dd-java-agent.jar를 Datadog 사용자가 액세스할 수 있는 폴더에 다운로드합니다.

wget -O dd-java-agent.jar 'https://dtdg.co/latest-java-tracer'

curl -Lo dd-java-agent.jar 'https://dtdg.co/latest-java-tracer'

ADD 'https://dtdg.co/latest-java-tracer' dd-java-agent.jar

참고: 특정 메이저 버전의 최신 빌드를 다운로드하려면 대신 https://dtdg.co/java-tracer-vX 링크를 사용하세요. 여기서 X는 원하는 메이저 버전입니다. 예를 들어 최신 버전 1 빌드의 경우, https://dtdg.co/java-tracer-v1을 사용합니다. 마이너 버전 번호는 포함하지 말아야 합니다. 대신 Datadog의 Maven 리포지토리에서 특정 버전을 참조하세요.

참고: Release Candidate 버전은 GitHub DataDog/dd-trace-java releases에서 제공됩니다. 이러한 버전에는 “RC"가 포함되어 있으며, 프로덕션 환경 외부에서 테스트하는 용도로 권장합니다. 새 Release Candidate 버전을 테스트용으로 사용할 수 있게 될 때 알림을 받으려면 GitHub 릴리스 알림을 구독하세요. Release Candidate를 사용하다가 문제가 발생하는 경우, Datadog 지원팀에 문의하세요.

2. Continuous Profiler, 배포 추적 및 로그 인젝션(로그를 Datadog로 보내는 경우)를 사용해 IDE, Maven 또는 Gradle 애플리케이션 스크립트나 java -jar 명령에서 앱을 실행하려면 -javaagent JVM 인수 및 다음과 같은 구성 옵션을 추가하세요(해당하는 경우).

   java -javaagent:/path/to/dd-java-agent.jar -Ddd.profiling.enabled=true -Ddd.logs.injection=true -Ddd.service=my-app -Ddd.env=staging -Ddd.version=1.0 -jar path/to/your/app.jar
   

   Note: If you have a strong need to reduce the size of your image and omit modules, you can use the jdeps command to identify dependencies. However, required modules can change over time, so do this at your own risk.

   Note: When running the SDK with Java 24+, you may see warnings related to JNI native access. Suppress these warnings by adding the --enable-native-access=ALL-UNNAMED flag. See JEP 472 for more details.

   프로파일링을 활성화하면 APM 번들에 따라 요금에 영향을 줄 수 있습니다. 자세한 정보는 가격 페이지를 참조하세요.

추가 구성 옵션은 아래에 설명되어 있습니다.

Java SDK를 JVM {#add-the-java-sdk-to-the-jvm}에 추가합니다.

-javaagent 및 기타 JVM 인수를 전달할 적절한 방법을 알아내려면 해당하는 애플리케이션 서버의 문서를 사용합니다. 다음은 일반적으로 사용되는 몇 가지 프레임워크에 대한 지침입니다.

JAVA_OPTS=-javaagent:/path/to/dd-java-agent.jar

-javaagent:C:\path\to\dd-java-agent.jar

JAVA_OPTS="$JAVA_OPTS -javaagent:/path/to/dd-java-agent.jar"

set "JAVA_OPTS=%JAVA_OPTS% -javaagent:X:/path/to/dd-java-agent.jar"

<option value="-javaagent:/path/to/dd-java-agent.jar"/>

JAVA_OPTIONS="${JAVA_OPTIONS} -javaagent:/path/to/dd-java-agent.jar"

-javaagent:/path/to/dd-java-agent.jar

-javaagent:/path/to/dd-java-agent.jar

참고

• java -jar 명령에 -javaagent 인수를 추가하는 경우, -jar 인수 앞에, 애플리케이션 인수가 아니라 JVM 옵션으로 추가해야 합니다. 예를 들면 다음과 같습니다.

  java -javaagent:/path/to/dd-java-agent.jar -jar my_app.jar
  

  For more information, see the Oracle documentation.

• dd-java-agent를 클래스 경로에 추가하면 안 됩니다. 그러면 예기치 않은 동작을 초래할 수 있습니다.

자동 계측

Java 자동 계측은 JVM이 제공하는 java-agent 계측 기능을 사용합니다. java-agent가 등록되면 로드 시 클래스 파일을 수정할 수 있습니다.

참고: 원격 ClassLoader로 로드된 클래스는 자동으로 계측되지 않습니다.

계측은 자동 계측, OpenTracing API 또는 둘의 조합으로 수행될 수 있습니다. 계측은 보통 다음과 같은 정보를 수집합니다.

• OpenTracing API에서 타임스탬프가 제공되지 않는 한 JVM의 NanoTime 클록을 사용하여 타이밍 기간을 측정
• 키/값 태그 쌍
• 애플리케이션이 처리하지 않은 오류 및 스택 트레이스
• 시스템을 통과하는 트레이스(요청)의 총 수

구성

필요한 경우 Unified Service Tagging 구성을 포함하여, SDK가 애플리케이션 성능 텔레메트리 데이터를 원하는 방식으로 전송하도록 구성하세요. 자세한 내용은 라이브러리 구성을 참조하세요.

Remote Configuration

Remote Configuration을 사용하면 애플리케이션을 다시 시작하지 않고도 Datadog Agent가 동적으로 트레이싱 설정을 구성할 수 있습니다. Remote Configuration은 기본적으로 활성화되어 있습니다. 비활성화하려면 환경 변수를 다음과 같이 설정하세요.

DD_REMOTE_CONFIG_ENABLED=false

아니면 JVM 시스템 속성을 추가합니다.

-Ddd.remote_config.enabled=false

추가 자료

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

Datadog Java APM 소스 코드소스 코드 서비스, 리소스, 트레이스 둘러보기설명서 Java 애플리케이션용 APM 설정학습 센터