❯ Why

You want to log service metrics from your application and push it to a metrics provided? - Yes? - Here you are 🙌 !!
Currently there's only support for Datadog as metrics provider.

❯ Table of Contents

• Supported Services
• Quick Start
• API
• Cloud Connectors
• Transports
• Development
• Project Structure

❯ Supported Services

| Service | Version | | ------------ | -------- | | MongoDB | >=3.6.6 | | Redis | >=2.3.9 | | RabbitMQ | >=3.7.15 |

❯ Quick Start

Installation

Install library by using npm

npm install node-service-metrics-logger

or by using yarn

yarn add node-service-metrics-logger

How to use

Step 1: Import NodeServiceMetricsLogger

Using CommonJS module loader:

const NodeServiceMetricsLogger = require('node-service-metrics-logger);

Using ES6 module loader:

import { NodeServiceMetricsLogger } from 'node-service-metrics-logger;

Step 2: Create new instance of CfServiceMetricsLogger

Create new instance of NodeServiceMetricsLogger and provide options:

const serviceCredentials = [
  {
    serviceType: 'mongodb',
    host: 'your-mongodb-host',
    username: 'user',
    password: 'this-is-secret',
    port: 27017
    database: 'your-database-name',
  },
  {
    serviceType: 'redis',
    host: 'your-redis-host',
    port: 6379,
    password: 'this-is-secret',
  }
];

const nodeServiceMetricsLogger = new NodeServiceMetricsLogger({serviceCredentials});

Step 3: Subscribe to receive service metrics and general logs

Subscribe metrics to receive service metrics data:

nodeServiceMetricsLogger.subscribe('metrics', data => {
  // do some fancy stuff with your metrics
});

Subscribe logs to receive general application logs:

nodeServiceMetricsLogger.subscribe('logs', {message, level} => {
  console[level](message));
});

Step 3: Start and stop service metrics logging

Start service metrics logging:

nodeServiceMetricsLogger.start();

Stop service metrics logging:

nodeServiceMetricsLogger.stop();

❯ API

Credentials Options

| Option | Description | Default Value | | --------------------- | ------------------------------------------------------------------------------ | ------------: | | serviceType | Type of service. Currently only mongodb, redis and rabbitmq are available | | | name | Name of credential to identify your specific service in a mass of logs | your host | | host | Host of service | | | port (optional) | Port of service | | | uri (optional) | Instead of port and host, you can provide an URI | | | username (optional) | Username | | | password (optional) | Password   | | | interval (optional) | Service metrics polling interval in ms | 10000 |

Methods

| Method | Description | | -------------------------------- | ---------------------- | | start() | Start service metrics | | stop() | Stop service metrics | | subscribe(eventId, callback) | Subscribe an event | | unsubscribe(eventId, callback) | Unsubscribe an event | | unsubscribeAll() | Unsubscribe all events |

Subscription event id's

| Id | Description | | --------- | ---------------------------------------------------------------------- | | metrics | Service metrics | | logs | General application logs for levels debug, info, warn and error |

❯ Cloud Connectors

You can use a cloud connector to log metrics from your cloud instance services.

Cloud Foundry

Options

| Option | Description | Default Value | | ----------------------------------------- | -------------------------------------------------------------- | ------------: | | vcap (optional) | Provide local VCAP_SERVICES and/or VCAP_APPLICATION values | {} | | vcapFile (optional) | Provide local VCAP_SERVICES and/or VCAP_APPLICATION file | '' |

Methods

| Method | Description | | ------------------ | ------------------------------------- | | getCredentials() | Get Cloud Foundry service credentials |

Example

// import using `CommonJS` module loader:
const { CloudFoundryConnector, NodeServiceMetricsLogger } = require('node-service-metrics-logger');

// or import using `ES6` module loader:
import { CloudFoundryConnector, NodeServiceMetricsLogger } from 'node-service-metrics-logger';

const options = {
  vcapFile: 'your-vcap-file-path/vcap.json' 
};

const cloudFoundryConnector = new CloudFoundryConnector(options);
const serviceCredentials = cloudFoundryConnector.getCredentials();
const nodeServiceMetricsLogger = new NodeServiceMetricsLogger({serviceCredentials});

nodeServiceMetricsLogger.subscribe('metrics', data => {
  // do some fancy stuff with your metrics
});

nodeServiceMetricsLogger.start();

setTimeout(() => {
  nodeServiceMetricsLogger.stop();
}, 30000);

❯ Transports

With transports you can log metrics to metrics services like Datadog. Datadog is currently the one and only implemented transport.

Datadog

Example

// import using `CommonJS` module loader:
const { NodeServiceMetricsLogger, DatadogTransport } = require('node-service-metrics-logger');

// or import using `ES6` module loader:
import { NodeServiceMetricsLogger, DatadogTransport } from 'node-service-metrics-logger';

const datadogTransport = new DatadogTransport({
  apiKey: 'datadog-api-key',
  appKey: 'datadog-app-key',
  host: 'app.datadoghq.com',
  tags: ['env:development']
});

const serviceCredentials = [
  {
    serviceType: 'mongodb',
    host: 'your-mongodb-host',
    username: 'user',
    password: 'this-is-secret',
    port: 27017,
    database: 'your-database-name',
  }
];

const nodeServiceMetricsLogger = new NodeServiceMetricsLogger({
  serviceCredentials,
  transports: [datadogTransport],
});

nodeServiceMetricsLogger.start();

❯ Development

Getting Started

Step 1: Set up the Development Environment

You need to set up your development environment before you can do anything.

Install Node.js and NPM

• on OSX use homebrew brew install node
• on Windows use chocolatey choco install nodejs

Install yarn globally

yarn install yarn -g

Step 2: Install dependencies

Install all dependencies with yarn.

yarn install

Scripts and Tasks

Install

• Install all dependencies with yarn install

Linting

• Run code quality analysis using yarn run lint. This runs tslint.

Tests

• Run unit test using yarn run test.

Building the project

• Run yarn run build to generate commonJS and ES6 modules as well as declaration from the TypeScript source.
• Builded sources are located in dist folder.

Debugger

VS Code

Just set a breakpoint in source or unit test and hit F5 in your Visual Studio Code to execute and debug all unit tests.

❯ Project Structure

| Name | Description | | --------------------------------- | ----------- | | .vscode/ | VSCode tasks, launch configuration and some other settings | | dist/ | Compiled and bundled source files will be placed here | | src/ | Source files | | src/types/ *.d.ts | Custom type definitions and files that aren't on DefinitelyTyped | | test/ | Tests | | test/unit/ *.test.ts | Unit tests | | rollup.config.js | Config for Rollup module bundler |