Skip to content

Latest commit

 

History

History
41 lines (22 loc) · 1.47 KB

README.md

File metadata and controls

41 lines (22 loc) · 1.47 KB

uw-lib-prometheus.js

A wrapper around prom-client.

Build

Install

npm install --save uw-lib-prometheus.js

Use

const prometheus = require('uw-lib-prometheus.js')();

prometheus.newGauge('name', 'help').set(10);

Quick express example is available in examples directory.

API

Prometheus.constructor(string prefix) if prefix provided, it will prefix ;) each metric name.

The new* methods are just decorators for prom-client metric objects and are responsible for some dupe vaidation and making sure metric objects are added into registry.

Prometheus.newGauge(string name, string help, string[] labels) creates new Gauge.

Prometheus.newHistogram(string name, string help, string[] labels, {buckets: []}) creates new Histogram.

Prometheus.metric(string name) returns previously created metric by name.

Middleware

Prometheus.middleware() returns a factory for middleware handlers. Following handlers are available:

report() - dumps plain text metrics for Prometheus server to scrape. requestDuration(string|Histogram histogram) - records request duration in seconds. heapUsage(string|Gauge used, string|Gauge total) - records used and total heap in bytes.