Package Exports

This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (grafana-cloud-graphite) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

Readme

Grafana Cloud Graphite Metrics Handler

This package provides a simple way to send metrics to a Grafana Cloud Graphite server. It includes support for counters and interval metrics.

Provide easy use for: https://grafana.com/docs/grafana-cloud/monitor-infrastructure/metrics/metrics-graphite/http-api/

Installation

To install this package, use npm:

npm install graphite-metrics-handler

Requirements

Grafana Cloud: Get free account
Grafana Access Token(metrics:write): https://grafana.com/orgs/YOUR_ORGS/access-policies
Grafana Graphite UserId: https://grafana.com/orgs/YOUR_ORGS

Usage

To use this package, first import the GraphiteMetrics class:

import { GraphiteMetrics } from "graphite-metrics-handler";

Then, create a new instance of the class with your Graphite server options:

const metrics = new GraphiteMetrics({
  ingestEndpointURL: "https://something.grafana.net/graphite/metrics",
  userId: "5435231"; // Grafana Graphite UserId
  token: "glc_kyupkp..."; // Grafana Access Token
  namespace: "myapp", // optional
});

You can then register counters and interval metrics with the registerCounter method:

// Register a counter metric with 60.000ms (1 minute) reporting interval
const dbCounterAll = metrics.registerCounter("db.query.all", 60000);
const dbCounterError = metrics.registerCounter("db.query.error", 60000);

Use counter example:

try {
  dbCounterAll.inc();
  await db.query("SELECT * FROM users");
  // do some DB query
} catch (error) {
  dbCounterError.inc();
  // some error handling
}

To stop reporting metrics / clearIntervals, call the stop method:

metrics.stop();

License

This package is licensed under the MIT License. See the LICENSE file for details.