cloud-logger-transport v0.1.2

CloudLogger Winston Transport

!WARNING
This project is still in development. It will be usable as soon as it reaches v1.x

This package provides a transport constructor to connect to the CloudLogger backend.

CloudLogger is a simple self hosted service which helps you keeping track of your logs in a simple and clear web UI.

Installation

Yarn

yarn add cloud-logger-transport

NPM

npm install cloud-logger-transport

Usage

The constructor of the transports needs to know how to connect to the backend. This information includes the backend URL, your API token and the project key.

import { CloudLoggerTransport } from 'cloud-logger-transport';
import winston from 'winston'

// This information can be found in the web UI
const HOST = 'https://your-api-endpoint';
const API_TOKEN = 'your-api-token';
const APP_KEY = 'app-key';

// create the transport
const cloudLoggerTransport = new CloudLoggerTransport({
  host: HOST,
  token: API_TOKEN,
  appKey: APP_KEY,
});

// create the logger
const logger = winston.createLogger({
  transports: [ cloudLoggerTransport ],
});

There are several ways how you can log a message. You can add metadata which provides more information about the log. You can also add a scope (e.g. "db" for all database related logs, "auth" for all authentication related logs). The scope allows you to easily filter the logs in the web UI.

Basic Log Message

logger.info('Hello world.');

Log Message with metadata

logger.info('User signed in.', { name: 'Tobias', age: 24 });

Log Message with scope

logger.info('Initialization successful.', { scope: 'db' });

Log Message with metadata & scope

logger.info('User signed in.', { scope: 'auth', name: 'Tobias', age: 24 });