Package Exports

dd-trace

This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (dd-trace) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

Readme

dd-trace-js

Experimental JavaScript tracer (APM)

Installation

NodeJS

npm install --save dd-trace

Node >= 4 is required.

Usage

Example

const tracer = require('dd-trace').init({
  service: 'example'
})

const express = require('express')
const app = express()

app.get('/hello/:name', (req, res) => {
  const options = {
    resource: '/hello/:name',
    type: 'web',
    tags: {
      'span.kind': 'server',
      'http.method': 'GET',
      'http.url': req.url,
      'http.status_code': '200'
    }
  }

  tracer.trace('say_hello', options, span => {
    res.send(`Hello, ${req.params.name}!`)
    span.finish()
  })
})

app.listen(3000)

Available Options

Options can be configured as a parameter to the init() method or as environment variables.

Config	Environment Variable	Default	Description
debug	DD_TRACE_DEBUG	false	Enable debug logging in the tracer.
service	DD_SERVICE_NAME		The service name to be used for this program.
hostname	DD_TRACE_AGENT_HOSTNAME	localhost	The address of the trace agent that the tracer will submit to.
port	DD_TRACE_AGENT_PORT	8126	The port of the trace agent that the tracer will submit to.
flushInterval		2000	Interval in milliseconds at which the tracer will submit traces to the agent.
experimental		{}	Experimental features can be enabled all at once using boolean `true` or individually using key/value pairs. Available experimental features: `asyncHooks`.

OpenTracing

This library is OpenTracing compliant, so once the tracer is initialized it can be used as a global tracer.

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

opentracing.initGlobalTracer(tracer)

Then the tracer will be available with opentracing.globalTracer().

See the OpenTracing JavaScript documentation and API for more details.

Development

Requirements

Since this project supports multiple Node versions, using a version manager such as nvm is recommended.

To get started once you have a Node version installed, run:

$ npm install

Testing

To run the unit tests, use:

$ npm test

To run the unit tests continuously in watch mode while developing, use:

$ npm run tdd

Linting

We use ESLint to make sure that new code is conform to our coding standards.

To run the linter, use:

$ npm run lint

Continuous Integration

We rely on CircleCI 2.0 for our tests. If you want to test how the CI behaves locally, you can use the CircleCI Command Line Interface as described here: https://circleci.com/docs/2.0/local-jobs/

After installing the circleci CLI, simply run one of the following:

$ circleci build --job lint
$ circleci build --job build-node-4
$ circleci build --job build-node-6
$ circleci build --job build-node-8
$ circleci build --job build-node-latest

Benchmarks

When two or more approaches must be compared, please write a benchmark in the benchmark/index.js module so that we can keep track of the most efficient algorithm. To run your benchmark, just:

$ npm run bench