Enabling the Profiler for GraalVM Native Image
이 페이지는 아직 한국어로 제공되지 않습니다. 번역 작업 중입니다.
현재 번역 프로젝트에 대한 질문이나 피드백이 있으신 경우
언제든지 연락주시기 바랍니다.Datadog Profiler support for GraalVM native-image is in Preview. Datadog recommends evaluating the profiler in a non-sensitive environment before deploying in production.
This page describes how to enable profiling for applications compiled as GraalVM native images. For standard JVM applications, see Enabling the Java Profiler.
Requirements
For a summary of the minimum and recommended runtime and tracer versions across all languages, read Supported Language and Tracer Versions.
- Minimum version
- GraalVM 17+
- Supported platforms
- Linux, Windows, macOS
- Available profile types
- CPU, Allocations
Installation
1. Build your native image with the Datadog tracer
Follow the Tracer Setup Instructions to build your GraalVM native image with the Datadog Java Profiler instrumentation.
2. Run with profiling enabled
After the service binary is built, enable the profiler using environment variables:
export DD_SERVICE=<YOUR_SERVICE>
export DD_ENV=<YOUR_ENV>
export DD_VERSION=<YOUR_VERSION>
export DD_PROFILING_ENABLED=true
export DD_PROFILING_DIRECTALLOCATION_ENABLED=true
./my_service
3. Verify profiles are collected
After a couple of minutes, your profiles appear on the Datadog APM > Profiler page.
Configuration
In addition to the environment, service, and version variables shown in the installation steps, you can apply custom tags to uploaded profiles with DD_TAGS (a comma-separated list of <key>:<value> pairs such as layer:api, team:intake).
For profile type configuration options, see the Configuration reference in the Java profiler troubleshooting guide.
Limitations
- Only JFR-based profiling is supported for GraalVM native-image applications.
- Wallclock and live heap profiling are not available.
Not sure what to do next?
The Getting Started with Profiler guide takes a sample service with a performance problem and shows you how to use Continuous Profiler to understand and fix the problem.
Further Reading
