datadog-tracer
[DEPRECATED] OpenTracing Tracer implementation for Datadog in JavaScript
Last updated 2 years ago by rochdev .
MIT · Repository · Bugs · Original npm · Tarball · package.json
$ cnpm install datadog-tracer 
SYNC missed versions from official npm registry.

Datadog Tracer

npm Build Status codecov Code Climate Greenkeeper badge bitHound Dependencies

DEPRECATED: The official library dd-trace-js has now been released.

OpenTracing tracer implementation for Datadog in JavaScript. It is intended for use both on the server and in the browser.

Installation

NodeJS

npm install --save datadog-tracer

Node >= 4 is required.

Browser

The library supports CommonJS and AMD loaders and also exports globally as DatadogTracer.

NOTE: If you want to use binary propagation, make sure to also include the minimal version of protobuf.js before this library.

CDN

<script src="//cdn.rawgit.com/rochdev/datadog-tracer-js/0.X.X/dist/datadog-tracer.min.js"></script>

NOTE: Remember to replace the version tag with the exact release your project depends upon.

Frontend

<script src="node_modules/datadog-tracer/dist/datadog-tracer.min.js"></script>

Usage

See the OpenTracing JavaScript documentation for more information.

Custom tracer options

  • service: name of the Datadog service
  • hostname: hostname of the Datadog agent (default: localhost)
  • port: port of the Datadog agent (default: 8126)
  • protocol: protocol of the Datadog agent (default: http)
  • endpoint: full URL of the Datadog agent (alternative to hostname+port+protocol)

Example

const express = require('express')
const Tracer = require('datadog-tracer')

const app = express()
const tracer = new Tracer({ service: 'example' })

// handle errors from Datadog agent. omit this if you want to ignore errors
tracer.on('error', e => console.log(e))

app.get('/hello/:name', (req, res) => {
  const span = tracer.startSpan('say_hello')

  span.addTags({
    'resource': '/hello/:name', // required by Datadog
    'type': 'web', // required by Datadog
    'span.kind': 'server',
    'http.method': 'GET',
    'http.url': req.url,
    'http.status_code': '200'
  })

  span.finish()

  res.send(`Hello, ${req.params.name}!`)
})

app.listen(3000)

See the examples folder for more advanced examples.

API Documentation

See the OpenTracing JavaScript API

Additional Resources

Current Tags

  • 0.4.2                                ...           latest (2 years ago)

14 Versions

  • 0.4.2                                ...           2 years ago
  • 0.4.1                                ...           3 years ago
  • 0.4.0                                ...           3 years ago
  • 0.3.4                                ...           3 years ago
  • 0.3.3                                ...           3 years ago
  • 0.3.2                                ...           3 years ago
  • 0.3.1                                ...           3 years ago
  • 0.3.0                                ...           3 years ago
  • 0.2.2                                ...           3 years ago
  • 0.2.1                                ...           3 years ago
  • 0.2.0                                ...           3 years ago
  • 0.1.2                                ...           3 years ago
  • 0.1.1                                ...           3 years ago
  • 0.1.0                                ...           3 years ago
Maintainers (1)
Downloads
Today 0
This Week 0
This Month 0
Last Day 0
Last Week 0
Last Month 0
Dependencies (8)
Dev Dependencies (34)

Copyright 2014 - 2016 © taobao.org |