fastify-opencensus

Metrics collector for Fastify based on Opencensus .

This module is inspired and based on the fastify-metrics plugin.

This plugin adds 3 http metrics for your routes:

• Requests duration distribution
• Requests duration summary
• Requests count

ToC

• fastify-opencensus
  • ToC
  • Fastify support
  • Installation
  • Features and requirements
  • Usage
    • Plugin options
      • Metrics details
    • HTTP routes metrics
  • Docs
  • Changelog
  • See also
  • License

Fastify support

• v0.x.x - will support >= fastify-2.0.0

Installation

npm i fastify-opencensus --save

_{Back to top}

Features and requirements

• Collects default server metrics (see opencensus-default-metrics);
• Collects route response timings
• By default, metrics info are collected into the global instance of opencensus required by this package. If you want to use another opencensus version, you have to pass in this instance using the stats options field.

• Requires fastify >=2.0.0.
• Node.js >=8.9.0.

_{Back to top}

Usage

Add it to your project like regular fastify plugin. Use register method and pass options to it.

const fastify = require('fastify');
const app = fastify();

const metricsPlugin = require('fastify-opencensus');
app.register(metricsPlugin, { interval: 3000 });

It also exports opencensus stats instance to fastify instance fastify.opencensus.client which you may use it in your routes.

See example folder for other examples.

_{Back to top}

Plugin options

Metrics details

You may override default metrics settings. You may provide overrides for three metrics tracking http request durations, count and sum (labelNames cannot be overriden). Default values:

{
  distribution: {
    name: 'http_request_duration_seconds',
    desc: 'request duration in seconds',
    labelNames: ['status_code', 'method', 'route'],
    buckets: [0.05, 0.1, 0.5, 1, 3, 5, 10],
  },
  sum: {
    name: 'http_sum_request_duration_seconds',
    desc: 'Sum of durations of http requests',
    labelNames: ['status_code', 'method', 'route']
  },
  count: {
    name: 'http_request_count',
    desc: 'Counter of http requests',
    labelNames: ['status_code', 'method', 'route']
  },
}

Override should look like:

const fastify = require('fastify');
const app = fastify();
const metricsPlugin = require('fastify-metrics');

app.register(metricsPlugin, {metrics: {
  distribution: {
    name: 'my_custom_http_request_duration_seconds',
    buckets: [0.1, 0.5, 1, 3, 5],
  },
  sum: {
    desc: 'custom request duration in seconds summary help'
  },
});

_{Back to top}

HTTP routes metrics

The following table shows what metrics will be available in Prometheus. Note suffixes like _bucket, _sum, _count are added automatically.

_{Back to top}

Docs

See docs.

_{Back to top}

Changelog

See changelog.

_{Back to top}

See also

• opencensus-default-metrics - collector of node default metrics using opencensus

_{Back to top}

License

Licensed under MIT.

_{Back to top}