npm package discovery and stats viewer.

Discover Tips

  • General search

    [free text search, go nuts!]

  • Package details

    pkg:[package-name]

  • User packages

    @[username]

Sponsor

Optimize Toolset

I’ve always been into building performant and accessible sites, but lately I’ve been taking it extremely seriously. So much so that I’ve been building a tool to help me optimize and monitor the sites that I build to make sure that I’m making an attempt to offer the best experience to those who visit them. If you’re into performant, accessible and SEO friendly sites, you might like it too! You can check it out at Optimize Toolset.

About

Hi, 👋, I’m Ryan Hefner  and I built this site for me, and you! The goal of this site was to provide an easy way for me to check the stats on my npm packages, both for prioritizing issues and updates, and to give me a little kick in the pants to keep up on stuff.

As I was building it, I realized that I was actually using the tool to build the tool, and figured I might as well put this out there and hopefully others will find it to be a fast and useful way to search and browse npm packages as I have.

If you’re interested in other things I’m working on, follow me on Twitter or check out the open source projects I’ve been publishing on GitHub.

I am also working on a Twitter bot for this site to tweet the most popular, newest, random packages from npm. Please follow that account now and it will start sending out packages soon–ish.

Open Software & Tools

This site wouldn’t be possible without the immense generosity and tireless efforts from the people who make contributions to the world and share their work via open source initiatives. Thank you 🙏

© 2024 – Pkg Stats / Ryan Hefner

@schablone/logging

v1.2.0

Published

Provides an out-of-the-box logging service, which logs all messages with their level to the console by default. It can be configured via options at initialization, including adding other transports than console logging.

Downloads

98

Readme

Logger

Provides an out-of-the-box logging service, which logs all messages with their level to the console by default. It can be configured via options at initialization, including adding other transports than console logging.

Installation

yarn add @schablone/logging or npm install @schablone/logging

Usage

import LoggerFactory from '@schablone/logging';

const logger = LoggerFactory({
  environment: 'local',
  globalLogOptions: {
    callback: (data) => {
      const { error, level, message, meta, objects } = data;
      // Use data in some way
    },
    meta: {
      name: 'Bob',
      job: 'Tester',
    },
    tags: { origin: 'GlobalOptions' },
  },
});
logger.debug("This is a debug message");

Parameters

The LoggerFactory object can receive an optional object as a parameter upon initialization. The object can have the following optional properties.

  • environment string ('production') Type of the environment the application is running on. Accepts 'local', 'develop', 'staging' and 'production'.
  • globalLogOptions GlobalLogOptions (undefined) An options object containing configuration for the logged messages. Options set here will be applied to all transports and logs and merged with their respective log options.
    • tags: Record<string, string> (undefined): A list of tags help to group log messages. How the tags are used depends on the transports. Tags supplied in individual log message options will be concatenated with these global tags and filtered to be unique by key.
    • meta: Record<string, unknown> (undefined): An object containing any additional data. How the meta information will be made available depends on the transport, e.g. it is not logged in the console transport, but passed to the console transport callback.
    • callback: (data: CallbackData): void callback that will be called by each transport after logging a message. Global callbacks will be overridden by callbacks in individual log message options. CallbackData comprises the following information:
      • error: unknown (optional) The error object supplied to the log, if any
      • level: string The level of the log
      • message: string The message of the log
      • meta: Record<string, unknown> (optional) The meta object supplied to the log, if any
      • objects unknown | unknown[] (optional) Any objects supplied to the log, if any
  • transports ITransport[] (new ConsoleTransport()): An array of transport instances to which the logger should send all logged messages. By default, all messages are logged to the console. If any transports are provided here the default transport will not be created and a console transport has to added manually.

API

All logging types accept a LogOptions object as an optional parameter.

trace(message: string, options?: LogOptions): void

Writes a message at the TRACE level. Used for detailed debugging information with the highest granularity, contains a stacktrace.

debug(message: string, options?: LogOptions): void

Writes a message at the DEBUG level

info(message: string, options?: LogOptions): void

Writes a message at the INFO level

warn(message: string, options?: LogOptions): void

Writes a message at the WARN level. Used for faulty configuration and unexpected data that can be safely defaulted and does not hinder the application from running normally.

error(message: string, options?: LogOptions): void

Writes a message at the ERROR level. Used for errors that inhibit parts of an applications normals functionality, contains a stacktrace.

fatal(message: string, options?: LogOptions): void

Writes a message at the FATAL level. Used for errors the application can't recover from, contains a stacktrace.

withOptions(options: LoggerOptions): ILogger

Returns a new logger instance based on the original logger. The supplied options will be deepmerged with the options of the original logger, overriding them if they can't be merged.

Transports

Transports are the different targets a message will be logged to. Transports that do not require additional dependencies are contained in the logging package. All transports that have additional dependencies (like Sentry) are implemented as individual packages.

Each transport has an EnvironmentLevelMap which governs which log levels are logged in the current environment. The environments are ordered, meaning a log level that is set to production will also show up in all other environments, but a log level set to develop will not show up in staging or production.

All transports can receive a configuration object on initialization. For the exact specifications of these objects, see the respective transport documentation. Each transport configuration object will at least accept the following options:

  • environmentLevelMap: EnvironmentLevelMap (optional) An object mapping the log levels to the environment they should be logged in. See below for examples
  • transortLogOptions: GlobalLogOptions (optional) See the LoggerFactory's globalLogOptions for details

Console transport

Logs to the console. In a node environment the logs will be color coded. Messages will be prepended by the level and all tags. Any objects or error will be appended to the message, while meta information is not displayed and only available in the callback.

Default EnvironmentLevelMap:

  • fatal: production
  • error: production
  • warn: production
  • info: staging
  • debug: develop
  • trace: local

Sentry transport

Logs to a sentry server. The sentry transport is only implemented as an abstract class and required either the SentryNodeTransport or the SentryBrowserTransport package in addition to the logging package.

The level, environment and meta information are all pushed to Sentry with each message. The tags array is converted to a Record, where each tag is a key with the value 'Group'. Objects are not send to Sentry, but are available in the callback.

In addition to the default initialization options, the object passed at the SentryTransport's initialization needs a SentryConfig. This can be a BrowserOptions or NodeOptions object and needs to supply a dsn. See the SentryNodeTransport or SentryBrowserTransport packages for examples or Sentry documentation for the full details.

Default EnvironmentLevelMap:

  • fatal: production
  • error: production
  • warn: staging
  • info: never
  • debug: never
  • trace: never