Nullifying Precipitation Machine
Join us to discuss the challenges, solutions and best practices for in-house JavaScript code sharing. Tuesday, 12/17 at 10am PT/1pm ET.Sign up here »

winston-loki

4.0.2 • Public • Published

winston-loki

npm version Build Status Coverage Status JavaScript Style Guide

A Grafana Loki transport for the nodejs logging library Winston.

NOTE: Latest version only guaranteed to work with the latest version of Grafana Loki. Make sure to update Loki if you have updated this package

Usage

This Winston transport is used similarly to other Winston transports. Require winston and define a new LokiTransport() inside its options when creating it.

Options

LokiTransport() takes a Javascript object as an input. These are the options that are available, required in bold:

Parameter Description Example Default
host URL for Grafana Loki http://localhost:3100 null
interval The interval at which batched logs are sent in seconds 30 5
json Use JSON instead of Protobuf for transport true false
batching If batching is not used, the logs are sent as they come true true
clearOnError Discard any logs that result in an error during transport true false
replaceTimestamp Replace any log timestamps with Date.now() true false

Example

const { createLogger, transports } = require("winston");
const LokiTransport = require("winston-loki");
const options = {
  ...,
  transports: [
    new LokiTransport({
      host: "http://localhost:3100"
    })
  ]
  ...
};
const logger = createLogger(options);

Developing

npm install
npm link
cd ~/your_project
npm link winston-loki
npm install

And you should have a working, requirable winston-loki package under your project's node_modules.

Refer to https://github.com/grafana/loki/blob/master/docs/api.md for documentation about the available endpoints, data formats etc.

Grafana Loki doesn't have any official releases or version numbers as of now, so if the API is changed, it's going to be fun, but it's working as of now.

Run tests

npm test

Write new ones under /test

TODO: Remove got dependency

Install

npm i winston-loki

DownloadsWeekly Downloads

215

Version

4.0.2

License

MIT

Unpacked Size

103 kB

Total Files

12

Last publish

Collaborators

  • avatar