{"id":19054261,"url":"https://github.com/datadog/dd-trace-js","last_synced_at":"2026-04-02T14:04:08.864Z","repository":{"id":37269897,"uuid":"117877090","full_name":"DataDog/dd-trace-js","owner":"DataDog","description":"Datadog APM client for Node.js","archived":false,"fork":false,"pushed_at":"2025-04-20T10:51:53.000Z","size":87187,"stargazers_count":697,"open_issues_count":309,"forks_count":328,"subscribers_count":609,"default_branch":"master","last_synced_at":"2025-04-20T12:10:59.757Z","etag":null,"topics":["apm","datadog","javascript","nodejs","opentracing","tracing"],"latest_commit_sha":null,"homepage":"https://docs.datadoghq.com/tracing/","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/DataDog.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":"CODEOWNERS","security":"SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2018-01-17T18:40:03.000Z","updated_at":"2025-04-20T10:51:56.000Z","dependencies_parsed_at":"2023-09-22T05:54:10.719Z","dependency_job_id":"81d5c5c4-c657-4a82-87cd-e8645173424f","html_url":"https://github.com/DataDog/dd-trace-js","commit_stats":{"total_commits":2986,"total_committers":173,"mean_commits":"17.260115606936417","dds":0.6530475552578701,"last_synced_commit":"4d6a8e3fe8edee52a9e28796d6138f776cb4a767"},"previous_names":[],"tags_count":412,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/DataDog%2Fdd-trace-js","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/DataDog%2Fdd-trace-js/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/DataDog%2Fdd-trace-js/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/DataDog%2Fdd-trace-js/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/DataDog","download_url":"https://codeload.github.com/DataDog/dd-trace-js/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":250478194,"owners_count":21437118,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["apm","datadog","javascript","nodejs","opentracing","tracing"],"created_at":"2024-11-08T23:37:32.879Z","updated_at":"2026-01-30T12:03:26.496Z","avatar_url":"https://github.com/DataDog.png","language":"JavaScript","readme":"# `dd-trace`: Node.js APM Tracer Library\n\n[![npm v5](https://img.shields.io/npm/v/dd-trace/latest?color=blue\u0026label=dd-trace%40v5\u0026logo=npm)](https://www.npmjs.com/package/dd-trace)\n[![codecov](https://codecov.io/gh/DataDog/dd-trace-js/branch/master/graph/badge.svg)](https://codecov.io/gh/DataDog/dd-trace-js)\n\n\u003cimg align=\"right\" src=\"https://user-images.githubusercontent.com/551402/208212084-1d0c07e2-4135-4c61-b2da-8f2fddbc66ed.png\" alt=\"Bits the dog  JavaScript\" width=\"200px\"/\u003e\n\n`dd-trace` is an npm package that you can install in your Node.js application to capture APM (Application Performance Monitoring) data. In Datadog terminology this library is called a Tracer. This data is then sent off to a process which collects and aggregates the data, called an Agent. Finally the data is sent off to the Datadog servers where it's stored and made available for querying in a myriad of ways, such as displaying in a dashboard or triggering alerts.\n\n![Tracer, Agent, Datadog relationship diagram](./docs/relationship.png)\n\n\n## Documentation\n\nMost of the documentation for `dd-trace` is available on these webpages:\n\n- [Tracing Node.js Applications](https://docs.datadoghq.com/tracing/languages/nodejs/) - most project documentation, including setup instructions\n- [Configuring the Node.js Tracing Library](https://docs.datadoghq.com/tracing/trace_collection/library_config/nodejs) - environment variables and config options\n- [API Documentation](https://datadog.github.io/dd-trace-js) - method signatures, plugin list, and some usage examples\n- [APM Terms and Concepts](https://docs.datadoghq.com/tracing/visualization/) - a glossary of concepts applicable across all languages\n\n\n## Version Release Lines and Maintenance\n\n| Release Line                                             | Latest Version                                                                                         | Node.js  | [SSI](https://docs.datadoghq.com/tracing/trace_collection/automatic_instrumentation/single-step-apm/?tab=linuxhostorvm) | [K8s Injection](https://docs.datadoghq.com/tracing/trace_collection/library_injection_local/?tab=kubernetes) |Status          |Initial Release | End of Life |\n| :---:                                                    | :---:                                                                                                  | :---:    | :---:  | :---:  | :---:           | :---:          | :---:       |\n| [`v1`](https://github.com/DataDog/dd-trace-js/tree/v1.x) | ![npm v1](https://img.shields.io/npm/v/dd-trace/legacy-v1?color=white\u0026label=%20\u0026style=flat-square)     | `\u003e= v12` | NO | NO | **EOL** | 2021-07-13     | 2022-02-25  |\n| [`v2`](https://github.com/DataDog/dd-trace-js/tree/v2.x) | ![npm v2](https://img.shields.io/npm/v/dd-trace/latest-node12?color=white\u0026label=%20\u0026style=flat-square) | `\u003e= v12` | NO | NO | **EOL** | 2022-01-28     | 2023-08-15  |\n| [`v3`](https://github.com/DataDog/dd-trace-js/tree/v3.x) | ![npm v3](https://img.shields.io/npm/v/dd-trace/latest-node14?color=white\u0026label=%20\u0026style=flat-square) | `\u003e= v14` | NO | YES | **EOL** | 2022-08-15     | 2024-05-15  |\n| [`v4`](https://github.com/DataDog/dd-trace-js/tree/v4.x) | ![npm v4](https://img.shields.io/npm/v/dd-trace/latest-node16?color=white\u0026label=%20\u0026style=flat-square) | `\u003e= v16` | YES | YES | **EOL**     | 2023-05-12     | 2025-01-11     |\n| [`v5`](https://github.com/DataDog/dd-trace-js/tree/v5.x) | ![npm v5](https://img.shields.io/npm/v/dd-trace/latest?color=white\u0026label=%20\u0026style=flat-square)        | `\u003e= v18` | YES | YES | **Current**     | 2024-01-11     | Unknown     |\n\n* EOL = End-of-life\n* SSI = Single-Step Install\n\nWe currently maintain one release line, namely `v5`.\n\nFor any new projects it is recommended to use the `v5` release line:\n\n```sh\n$ npm install dd-trace\n$ yarn add dd-trace\n```\n\nExisting projects that need to use EOL versions of Node.js may continue to use these older release lines.\nThis is done by specifying the version when installing the package.\n\n```sh\n$ npm install dd-trace@4 # or whatever version you need\n$ yarn add dd-trace@4 # or whatever version you need\n```\n\nNote, however, that the end-of-life release lines are no longer maintained and will not receive updates.\n\nAny backwards-breaking functionality that is introduced into the library will result in an increase of the major version of the library and therefore a new release line.\nSuch releases are kept to a minimum to reduce the pain of upgrading the library.\n\nWhen a new release line is introduced the previous release line then enters maintenance mode where it will receive updates for the next year.\nOnce that year is up the release line enters End of Life and will not receive new updates.\nThe library also follows the Node.js LTS lifecycle wherein new release lines drop compatibility with Node.js versions that reach end-of-life (with the maintenance release line still receiving updates for a year).\n\nFor more information about library versioning and compatibility, see the [Node.js Compatibility Requirements](https://docs.datadoghq.com/tracing/trace_collection/compatibility/nodejs/#releases) page.\n\nChanges associated with each individual release are documented on the [GitHub Releases](https://github.com/DataDog/dd-trace-js/releases) screen.\n\n\n## Development and Contribution\n\nPlease read the [CONTRIBUTING.md](https://github.com/DataDog/dd-trace-js/blob/master/CONTRIBUTING.md) document before contributing to this open source project.\n\n\n## ECMAScript Modules (ESM) Support\n\nESM support requires an _additional_ command line argument when starting the Node.js process.\nFor more information, see the [section on ESM support](https://docs.datadoghq.com/tracing/trace_collection/automatic_instrumentation/dd_libraries/nodejs/#esm-applications-only-import-the-loader) in the Node.js tracer documentation.\n\n\n## Serverless / Lambda\n\nNote that there is a separate Lambda project, [datadog-lambda-js](https://github.com/DataDog/datadog-lambda-js), that is responsible for enabling metrics and distributed tracing when your application runs on Lambda.\nThat project does depend on the `dd-trace` package but also adds a lot of Lambda-related niceties.\nIf you find any issues specific to Lambda integrations then the issues may get solved quicker if they're added to that repository.\nThat said, even if your application runs on Lambda, any core instrumentation issues not related to Lambda itself may be better served by opening an issue in this repository.\nRegardless of where you open the issue, someone at Datadog will try to help.\n\n\n## Bundling\n\nIf you would like to trace your bundled application then please read this page on [bundling and dd-trace](https://docs.datadoghq.com/tracing/trace_collection/automatic_instrumentation/dd_libraries/nodejs/#bundling). It includes information on how to use our ESBuild plugin and includes caveats for other bundlers.\n\n\n## Security Vulnerabilities\n\nPlease refer to the [SECURITY.md](https://github.com/DataDog/dd-trace-js/blob/master/SECURITY.md) document if you have found a security issue.\n\n\n## Datadog With OpenTelemetery\n\nPlease refer to the [Node.js Custom Instrumentation using OpenTelemetry API](https://docs.datadoghq.com/tracing/trace_collection/custom_instrumentation/nodejs/otel/) document. It includes information on how to use the OpenTelemetry API with dd-trace-js.\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdatadog%2Fdd-trace-js","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdatadog%2Fdd-trace-js","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdatadog%2Fdd-trace-js/lists"}