1.3.3 • Published 6 months ago

@figedi/metering v1.3.3

Weekly downloads
4
License
SEE LICENSE IN LI...
Repository
github
Last release
6 months ago

Metering

Prometheus metering module with separate server serving metrics.

Features

This library is a small wrapper around prom-client and provides some extra functionalities:

  • Minimal server serving metrics through given endpoint, e.g. for usage in a k8s environment
    • Minimal health-service-like capabilities through user-defined sections
  • utilities around IO-timing for summary/histogram metrics

Usage

Example using gauge/IOTimer

import { MeteringRecorder, IoTimer } from "@figedi/metering"

const recorder = new MeteringRecorder();
const gauge = recorder.createGauge("some-metric-name", "current example-value", ["label_a", "label_b"]);
gauge.set({ label_a: "value-a" }, 42);

const ioTimer = new IoTimer(recorder, ["label_io"], [1, 10, 25, 50, 100, 500, 1000]);

const measure = ioTimer.create("example-svc", "someIoOperation", { "label_io": "value-io" });
// ... async op
measure(); 

Example for monitoring-service

import { MeteringRecorder, MonitoringServer, MonitoringService } from "@figedi/metering"

const recorder = new MeteringRecorder();
const monitoringService = new MonitoringService().addSection("io")
const monitoringServer = new MonitoringServer(
  recorder,
  monitoringService,
  logger // some pino-like logger
);

// at bootstrap of svc
monitoringServer.start()
// sets some sections, which are exposed via /status, once all sections are signaled-ready, the route returns 200
monitoringService.getSection("io").addMetadata({ ctx: "some-metadata-value" }).signalReady();
// at shutdown of svc
monitoringServer.stop()
1.3.3

6 months ago

1.3.2

6 months ago

1.3.1

10 months ago

1.2.0

2 years ago

1.3.0

2 years ago

1.1.5

4 years ago

1.1.4

4 years ago

1.1.3

4 years ago