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
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 versions of Datadog APM SDKs.
You may want to choose specific SDK versions for compatability with your application’s language version or specific environment requirements.
To customize SDK versions:
In Datadog, go to the Install the Datadog Agent on Linux page.
After you turn on APM Instrumentation, click Customize library versions.
Find your language(s) and use the dropdown to either:
- Select an exact SDK version, or
- Select the major version, which uses the latest minor release available when the Agent installation command is run.
Copy and run the updated installation command.
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:
- Select an exact SDK version, or
- Select the major version, which uses the latest minor release available when the Agent installation command is run.
Copy and run the updated installation command.
Available versions are listed in source repositories for each language:
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:
Update SDK version
The SDK version is fixed when you run the Agent installation command.
To update the SDK versions:
- Re-run the Agent installation command. This command also updates the Agent to the latest version.
- Restart your applications.
Remove Single Step APM instrumentation from your Agent
To stop producing traces for all services on your infrastructure:
- Run:
dd-host-install --uninstall
- Restart the services on the host or VM.
Troubleshooting
If you encounter problems enabling APM with SSI, see the SSI troubleshooting guide.
Further reading