prometheus-client-js
v2.3.6
Published
Prometheus Metrics Client implemented in Pure Node.JS
Downloads
711
Readme
Prometheus Client (Pure Javascript)
STATUS: WIP -- Mostly implemented minus the summary metric
Originally based https://github.com/StreamMachine/prometheus_client_nodejs, but written without CoffeScript in just JavaScript. (Originally Licensed under Apache 2.0)
Prometheus instrumentation metrics library for Node.JS. Metrics are intended to be scraped by a Prometheus server.
Usage
Getting Started
Install the prometheus-client
package with NPM:
npm install prometheus-client-js
Then require the package and set up a new client instance:
var Prometheus = require('prometheus-client-js')
var client = new Prometheus()
The client library can create an HTTP app to serve up your metrics, or you can point to the output function from your own app router.
To use the built-in server:
client.createServer(9090)
Then use curl http://127.0.0.1:9090
to see a text representation of your metrics.
By default, the Prometheus client will use a global namespace. That means that any metrics registered inside your app (even by libraries) will show up in your client without any need to pass around a client object.
Metric Types
- Counter (http://prometheus.io/docs/concepts/metric_types/#counter)
- Gauge (http://prometheus.io/docs/concepts/metric_types/#gauge)
- Histogram (http://prometheus.io/docs/concepts/metric_types/#histogram)
- Summary (http://prometheus.io/docs/concepts/metric_types/#summary) (NOT YET IMPLEMENTED)