Enable Dynamic Instrumentation for Python
This page is not yet available in Spanish. We are working on its translation.
If you have any questions or feedback about our current translation project,
feel free to reach out to us!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.
Prerequisites
Recommended, autocomplete and search (open beta) is enabled.
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 ddtrace, which provides both tracing and Dynamic Instrumentation:
Note: Dynamic Instrumentation is available in the ddtrace library version 2.2.0 and higher.
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.
Invoke your service:
export DD_SERVICE=<YOUR_SERVICE>
export DD_ENV=<YOUR_ENV>
export DD_VERSION=<YOUR_VERSION>
export DD_DYNAMIC_INSTRUMENTATION_ENABLED=true
ddtrace-run python -m myapp.py
from ddtrace.debugging import DynamicInstrumentation
DynamicInstrumentation.enable()
After starting your service with Dynamic Instrumentation enabled, you can start using it 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. |
What to do next
See Dynamic Instrumentation for information about setting snapshot and metric probes and browsing and indexing the data.
Further Reading
Más enlaces, artículos y documentación útiles:
