NodeJS Fastify

Prerequisites

Node.js >=18

Installation

1. Install dependencies:

   npm install dd-trace

2. Initializes the Datadog tracer when your application starts:

   Code

   Add the following line at the top of your project's main file.

   const tracer = require('dd-trace').init();

   Environment Variables

   NODE_OPTIONS=--require dd-trace/init

   Startup Command

   Add --require dd-trace/init to your application run command, e.g.,

   node --require dd-trace/init app.js

3. Configure the tracer.

   Code

    const tracer = require('dd-trace').init({
      service: "<app_name>",
      // send traces to CubeAPM
      url: "http://<ip_address_of_cubeapm_server>:3130",
   
      // optional settings
      env: "myenv",
      version: "1.2.3",
      tags: {
        mykey1: "myvalue1",
        mykey2: "myvalue2"
      },
    });

   Environment Variables

   DD_SERVICE=<app_name>
   # send traces to CubeAPM
   DD_TRACE_AGENT_URL=http://<ip_address_of_cubeapm_server>:3130
   
   # optional settings
   DD_ENV=myenv
   DD_VERSION=1.2.3
   DD_TAGS=mykey1:myvalue1,mykey2:myvalue2

Sample Application

A working example is available at https://github.com/cubeapm/sample_app_nodejs_fastify/tree/datadog.

Troubleshooting

The following can be used for debugging:

Code

 const tracer = require('dd-trace').init({
   startupLogs: true
   debug: true,
 });

Environment Variables

# Print Datadog tracer startup logs on screen
DD_TRACE_STARTUP_LOGS=true
# Enable Datadog tracer debug logging if needed to see detailed logs
DD_TRACE_DEBUG=true