@loopback/extension-metrics NPM

@loopback/extension-metrics

This module contains a component that reports metrics of Node.js, LoopBack framework, and your application to Prometheus.

Stability: ⚠️Experimental⚠️

Experimental packages provide early access to advanced or experimental functionality to get community feedback. Such modules are published to npm using 0.x.y versions. Their APIs and functionality may be subject to breaking changes in future releases.

Installation

npm install --save @loopback/extension-metrics

Basic use

The component should be loaded in the constructor of your custom Application class.

Start by importing the component class:

import {MetricsComponent} from '@loopback/extension-metrics';

In the constructor, add the component to your application:

this.component(MetricsComponent);

By default, Metrics route is mounted at /metrics. This path can be customized via Metrics configuration as follows:

this.configure(MetricsBindings.COMPONENT).to({
  endpoint: {
    basePath: '/metrics',
  },
  defaultMetrics: {
    timeout: 5000,
  },
});

Metrics Collected

There are three types of metrics being collected by this component:

Node.js metrics - built-in by https://github.com/siimon/prom-client
LoopBack method invocations - built-in by this module using an interceptor
Metrics by the application code or other modules - instrumentations are required

Pull vs Push

Prometheus supports two modes to collect metrics:

pull - scraping from metrics http endpoint exposed by the system being monitored
push - pushing metrics from the system being monitored to a push gateway

See https://prometheus.io/docs/introduction/faq/#why-do-you-pull-rather-than-push

Try it out

git clone https://github.com/strongloop/loopback-next
npm install
npm run build
cd examples/metrics-prometheus
npm run demo

Open http://localhost:9090 to load Prometheus web UI.

/metrics endpoint

http://localhost:3000/metrics returns metrics in plain text format. It includes information for the Node.js process as well as LoopBack method invocations.