Enable Dynamic Instrumentation for PHP

문서 > 동적 계측 > 동적 계측 활성화 > Enable Dynamic Instrumentation for PHP

이 페이지는 아직 한국어로 제공되지 않으며 번역 작업 중입니다. 번역에 관한 질문이나 의견이 있으시면 언제든지 저희에게 연락해 주십시오.

Dynamic Instrumentation is a feature of supporting Datadog tracing libraries. If you are already using APM to collect traces for your application, ensure your Agent and tracing library are on the required version, and go directly to enabling Dynamic Instrumentation in step 4.

Installation

Install or upgrade your Agent to version 7.45.0 or higher.
If you don’t already have APM enabled, in your Agent configuration, set the DD_APM_ENABLED environment variable to true and listening to the port 8126/TCP.
Install or upgrade the PHP tracing libraries to version 1.4.0, by following the relevant instructions.
Note: Dynamic Instrumentation is available in the dd-trace-php library in versions 1.4.0 and later. Only function and method probes are supported.
Run your service with Dynamic Instrumentation enabled by setting the DD_DYNAMIC_INSTRUMENTATION_ENABLED environment variable to true. Specify DD_SERVICE, DD_ENV, and DD_VERSION Unified Service Tags so you can filter and group your probes and target active clients across these dimensions.
After starting your service with Dynamic Instrumentation enabled, you can start using Dynamic Instrumentation on the APM > Dynamic Instrumentation page.

Configuration

Configure Dynamic Instrumentation using the following environment variables:

Environment variable	Type	Description
`DD_DYNAMIC_INSTRUMENTATION_ENABLED`	Boolean	Set to `true` to enable Dynamic Instrumentation.
`DD_SERVICE`	String	The service name, for example, `web-backend`.
`DD_ENV`	String	The environment name, for example: `production`.
`DD_VERSION`	String	The version of your service.
`DD_TAGS`	String	Tags to apply to produced data. Must be a list of `<key>:<value>` separated by commas such as: `layer:api,team:intake`.