@opencensus/exporter-prometheus

OpenCensus Prometheus Stats Exporter

The OpenCensus Prometheus Stats Exporter allows the user to send collected stats with OpenCensus Core to Prometheus.

Prometheus is a monitoring system that collects metrics, by scraping exposed endpoints at regular intervals, evaluating rule expressions. It can also trigger alerts if certain conditions are met. For assistance setting up Prometheus, Click here for a guided codelab.

This package is still at an early stage of development, and is subject to change.

Installation

Install OpenCensus Prometheus Exporter with:

npm install @opencensus/core
npm install @opencensus/exporter-prometheus

Usage

Create & register the exporter on your application.

For Javascript:

const { globalStats } = require('@opencensus/core');
const { PrometheusStatsExporter } = require('@opencensus/exporter-prometheus');

// Add your port and startServer to the Prometheus options
const exporter = new PrometheusStatsExporter({
  port: 9464,
  startServer: true
});

Now, register the exporter.

// Pass the created exporter to Stats
globalStats.registerExporter(exporter);

Similarly for TypeScript (Since the source is written in TypeScript):

import { PrometheusStatsExporter } from '@opencensus/exporter-prometheus';
import { globalStats } from '@opencensus/core';

// Add your port and startServer to the Prometheus options
const options = {port: 9464, startServer: true};
const exporter = new PrometheusStatsExporter(options);

// Pass the created exporter to Stats
globalStats.registerExporter(exporter);

Viewing your metrics:

With the above you should now be able to navigate to the Prometheus UI at: http://localhost:9464/metrics

Useful links

• To learn more about Prometheus, visit: https://prometheus.io/
• For more information on OpenCensus, visit: https://opencensus.io/
• To checkout OpenCensus for Node.js, visit: https://github.com/census-instrumentation/opencensus-node
• For help or feedback on this project, join us on gitter

LICENSE

Apache License 2.0

Changelog

0.1.0 - 2021-07-27

• chore(stackdriver): upgrade google-auth-library, drop node8 (#887)
• chore: upgrade gRPC, ts to newest compatible version (#907) BREAKING CHANGE: upgrade to TypeScript 3.x
• chore(deps): pin googleapis, lock file maintenance (#928)