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

Note: Dynamic Instrumentation is supported only for applications running in production environment (RAILS_ENV, RACK_ENV, etc.).

Installation

1. Install or upgrade your Agent to version 7.49.0 or higher.
2. 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.
3. Install or upgrade the Ruby tracing library to version 2.9.0 or higher, by following the relevant instructions.
4. 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 instrumentations and target active clients across these dimensions.
5. 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:

What to do next

See Dynamic Instrumentation for information about adding instrumentations and browsing and indexing the data.

Supported features

• Dynamic Logs
• Capturing of variables for Dynamic Logs attached to a specific file/line
• PII redaction
• Source code integration

Unsupported features

• Dynamic Metrics, Spans, and Span Tags
• Dynamic Log conditions
• Local variable capture for Dynamic Logs attached to a method
• Expression evaluation in Dynamic Log templates
• Instrumenting third-party libraries

Further reading

Documentation, liens et articles supplémentaires utiles:

Getting Started with Datadog AgentDOCUMENTATION