Client for Librato Metrics
npm install librato-tsOnce librato.init() is called, aggregated stats will be sent to Librato once every 60 seconds.
import { Librato } from 'librato-ts';
const librato = new Librato();
librato.init({
email: 'foo@bar.com',
token: 'ABC123',
});
process.once('SIGINT', async function () {
// Send any pending metrics to Librato and stop the interval timer
await librato.end();
});
// Handle errors
librato.on('error', function (err) {
console.error(err);
});To support testing scenarios and prevent metrics from leaking to Librato, you can initialize the client with the simulate option:
import { Librato } from 'librato-ts';
const librato = new Librato();
librato.init({
simulate: true,
});
// This will be ignored
librato.increment('foo');A value that accumulates over time – you can think of this like an odometer on a car; it only ever goes up.
import { Librato } from 'librato-ts';
const librato = new Librato();
librato.init({
email: 'foo@bar.com',
token: 'ABC123',
});
// Increment by 1
librato.increment('foo');
// Increment by 5
librato.increment('foo', 5);
// Specify a source for the measurement
librato.increment('foo', 2, { source: 'bar' });
// Specify custom tags for the measurement
librato.increment('foo', 1, {
tags: {
foo: 'bar',
},
});A gauge measurement represents a snapshot of a value at a specific moment in time, like the amount of free memory on a server.
import { Librato } from 'librato-ts';
const librato = new Librato();
librato.init({
email: 'foo@bar.com',
token: 'ABC123',
});
librato.measure('free-memory', 1024); // 1024 bytes
// Specify a source for the measurement
librato.measure('foo', 250, { source: 'bar' });
// Specify custom tags for the measurement
librato.measure('foo', 250, {
tags: {
foo: 'bar',
},
});An annotation is a descriptive label or note applied to specific points in time, providing context or additional information about events, changes, or noteworthy occurrences within the metric data.
Librato allows grouping multiple annotations under a stream name, similar to a metric name. If the stream name is not specified, the title will be used.
import { Librato } from 'librato-ts';
const librato = new Librato();
librato.init({
email: 'foo@bar.com',
token: 'ABC123',
});
librato.annotate('Noting unique period of time');
// Specify a stream name for the annotation
librato.measure(`Deployment: ${version}`, {
streamName: 'product_deployments',
});
// Specify custom start and end dates for the annotation
librato.measure('foo', {
streamName: 'foobar',
start: new Date('2020-01-01'),
end: new Date('2020-01-02'),
});By default, librato-ts publishes data every 60 seconds. This can be overwritten with the constructor arguments:
import { Librato } from 'librato-ts';
const librato = new Librato();
librato.init({
email: 'foo@bar.com',
token: 'ABC123',
period: 30_000, // 30 seconds
});By default, attempts to publish metrics to Librato will time out after 59 seconds. This can be overwritten with the constructor arguments:
import { Librato } from 'librato-ts';
const librato = new Librato();
librato.init({
email: 'foo@bar.com',
token: 'ABC123',
timeout: 10_000, // 10 seconds
});