Prometheus Metrics for Opossum Circuit Breaker

This module provides Prometheus metrics for opossum circuit breakers. To use it with your circuit breakers, just pass them in to the PrometheusMetrics constructor.

For each circuit breaker, the metrics are:

• a prometheus counter for each event name
• a prometheus summary for the events success, failed execution time.

Example:

1  const CircuitBreaker = require('opossum');
2  const PrometheusMetrics = require('opossum-prometheus');
3
4  // create a couple of circuit breakers
5  const c1 = new CircuitBreaker(someFunction);
6  const c2 = new CircuitBreaker(someOtherFunction);
7
8  // Provide them to the constructor
9  const prometheus = new PrometheusMetrics({ circuits: [c1, c2] });
10
11  //...
12  // Provide other circuit breaker later
13  const c3 = new CircuitBreaker(someOtherFunction3);
14  prometheus.add([c3]);
15  
16  // Write metrics to the console
17  console.log(await prometheus.metrics());

This module would typically be used in an application that can provide an endpoint for the Prometheus server to monitor.

The prometheusRegistry constructor parameter allows you to provide an existing prom-client registry. The metrics about the circuit will be added to the provided registry instead of the global registry. The default metrics will not be added to the provided registry.

1const CircuitBreaker = require('opossum');
2const PrometheusMetrics = require('opossum-prometheus');
3const { Registry } = require('prom-client');
4
5// Create a registry
6const registry = new Registry();
7
8// create a circuit
9const circuit = new CircuitBreaker(functionThatMightFail);
10const metrics = new PrometheusMetrics({ circuits: [circuit], registry: registry })

Options

The PrometheusMetrics constructor takes an options object as detailed below.

1const options = {};
2new PrometheusMetrics(options)

Name	Description	Default
circuits	A list or individual circuit breaker to create metrics for	No circuits
registry	An existing registry to use for prometheus metrics	undefined - The default prometheus registry will be used and default system metrics will be collected
exposePerformanceMetrics	Measure the performance of breakers and report them through the registry	true
metricPrefix	Prefix for circuit breakers metrics name	any string