Enable Dynamic Instrumentation for Node.js

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

Dynamic Instrumentation for Node.js is in limited preview, and is not available to all customers. Request access to join the waiting list. Note that some limitations apply to the preview.

Request Access

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. Then, go directly to enabling Dynamic Instrumentation in step 4.

Installation

  1. Install or upgrade your Agent to version 7.45.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 Node.js tracing library to version 5.35.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:

Environment variableTypeDescription
DD_DYNAMIC_INSTRUMENTATION_ENABLEDBooleanSet to true to enable Dynamic Instrumentation.
DD_SERVICEStringThe service name, for example, web-backend.
DD_ENVStringThe environment name, for example, production.
DD_VERSIONStringThe version of your service.
DD_TAGSStringTags 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 adding instrumentations and browsing and indexing the data.

Limitations

The following limitations apply to the limited preview:

Supported features

Unsupported features

  • Dynamic Metrics, Spans, and Span Tags
  • Dynamic Logs attached to a function/method
  • Custom template for Dynamic Logs
  • Dynamic Log conditions
  • Source maps (e.g. if using TypeScript, the Dynamic Log needs to be configured against the transpiled JavaScript file)
  • PII redaction based on specific classes or types

Further reading

추가 유용한 문서, 링크 및 기사:

Getting Started with Datadog AgentDOCUMENTATION more more