Single Step APM Instrumentation on Linux

문서 > APM > 애플리케이션 계측 > 자동 계측 > Single Step APM Instrumentation > Single Step APM Instrumentation on Linux

이 페이지는 아직 영어로 제공되지 않습니다. 번역 작업 중입니다.
현재 번역 프로젝트에 대한 질문이나 피드백이 있으신 경우 언제든지 연락주시기 바랍니다.

Overview

On a Linux host or VM, use Single Step Instrumentation (SSI) for APM to install the Datadog Agent and instrument your applications in one step, with no additional configuration required.

Enable APM on your applications

Before proceeding, confirm that your environment is compatible by reviewing the SSI compatibility guide.

To enable APM on a Linux host:

In Datadog, go to the Install the Datadog Agent on Linux page.
In the Customize your observability coverage section, go to Additional features > Application Observability, and turn on APM Instrumentation.
Copy and run the Agent installation command on your Linux host or VM.
Restart your applications.

Set SDK tracer versions

By default, Single Step Instrumentation installs the latest major versions of Datadog APM SDKs. Minor version updates are applied automatically when they become available.

You may want to customize SDK versions based on your application’s language version or specific environment requirements. You can control the major and minor versions used by customizing library versions during setup.

To customize tracer versions:

In Datadog, go to the Install the Datadog Agent on Linux page.

After you turn on APM Instrumentation, set your desired library versions with the DD_APM_INSTRUMENTATION_LIBRARIES variable in your Agent installation command:

DD_API_KEY=<YOUR_DD_API_KEY> 
DD_SITE="US1-FED" 
DD_APM_INSTRUMENTATION_ENABLED=host 
DD_APM_INSTRUMENTATION_LIBRARIES="java:1,python:2,js:5,dotnet:3,php:1" 
bash -c "$(curl -L https://install.datadoghq.com/scripts/install_script_agent7.sh)"

Find your language(s) and use the dropdown to either:
- Pin an exact tracer version, or
- Select the major version you want to use.
Copy and run the updated installation command.

Available versions are listed in source repositories for each language:

Java (java)
Node.js (js)
Python (python)
.NET (dotnet)
Ruby (ruby)
PHP (php)

Configure Unified Service Tags

Unified Service Tags (USTs) apply consistent tags across traces, metrics, and logs, making it easier to navigate and correlate your observability data. Learn how to set USTs for Linux services.

Enable SDK-dependent products and features

After SSI loads the Datadog SDK into your applications and enables distributed tracing, you can configure additional products that rely on the SDK. These include capabilities such as Continuous Profiler, Application Security Monitoring, and trace ingestion controls.

Use one of the following setup methods:

Configure in application_monitoring.yaml:
Enable products across all services on a host without modifying application command lines.
Set environment variables:
Enable products by setting environment variables directly in your application configuration.