logger-safe-security
v2.1.1
Published
Custom logging framework used in SAFE
Downloads
23,427
Readme
logger
This package provides the logging configuration typically used in Safe Security.
Motivation
Currently in Safe Security, all the services that require logging functionality imported a library & configured it as per the service needs. Although this seems okay initially, it becomes a challenge to do this across multiple services as care needs to be taken to keep the dependency versions consistent across, code reusability takes a back seat since the configuration is duplicated everywhere, and is prone to human errors.
In order to solve this problem, the winston
library used currently has been encapsulated in this package along with the desired defaults set up so that
the client does not have to worry about setting up a verbose configuration in multiple files.
Installation
npm install logger-safe-security
yarn add logger-safe-security
Usage
The introduction of this package makes it very easy for clients to consume & leverage the logging capabilities.
In Javascript:
const { createLogger } = require("logger-safe-security");
const logger = createLogger({ logLevel: "info" });
logger.info("Hello world!");
In Typescript:
import { createLogger } from "logger-safe-security";
const logger = createLogger({ logLevel: "info" });
logger.info("Hello world!");
Additionally, one can pass service
metadata while importing it within the context of a service. For example:
const { createLogger } = require("logger-safe-security");
const logger = createLogger({ service: "sample" });
logger.info("This log line will include service metadata");
Definition
The logger exported as part of this package contains the following definition:
- Log format:
- The default log format is set to
JSON
. Hence, all the log messages will be represented (printed) as JSON objects. - Timestamp will be added to all log lines in
yyyy-MM-dd'T'HH:mm:ss.SSSZ
format. - Application errors will be captured in the logs.
- String interpolation is supported.
- The default log format is set to
- Log level:
- The default log level is
INFO
.
- The default log level is
- Transports:
- All logs will be written to
Console
by default. - Exceptions & Promise Rejections will be handled & written to
Console
as well.
- All logs will be written to
- Metadata:
{ "type" : "application" }
is added as default metadata to easily identify application logs. This can further be extended to differentiate from audit logs and add parsing/filtering rules (for e.g. in Datadog) as needed.- Additionally, all other metadata passed to the log messages will be stored under
metadata
property for easy identification & grouping.