Socket
Socket
Sign inDemoInstall

@gradientedge/logger

Package Overview
Dependencies
Maintainers
5
Versions
13
Alerts
File Explorer

Advanced tools

Socket logo

Install Socket

Detect and block malicious and high-risk dependencies

Install

@gradientedge/logger

Request-context sensitive logger package


Version published
Weekly downloads
9
decreased by-10%
Maintainers
5
Weekly downloads
 
Created
Source

@gradientedge/logger

Usage

This package is only intended for use within a node environment.

Using the default logger instance

You don't need to create any objects in order to start logging. It's as simple as:

import log from '@gradientedge/logger'

log.debug('Your message here', { additionalData: 123 })

The log object here is a singleton that's created when the @gradientedge/logger package is first imported.

Creating your own logger instance

If you want more control over the creation of the Logger instance, you can create your own:

import { Logger, LoggerLevel } from '@gradientedge/logger'

const myLogger = new Logger({
  level: LoggerLevel.ERROR,
})

myLogger.error('Major problem!')

Using with @gradientedge/als

The @gradientedge/als is a simple suite of functions that allow you to create AsyncLocalStorage via the create function, and then retrieve that data via the retrieve function.

As you'll see in the index.ts file, we use JavaScript's Proxy class to check to see if we have async local storage data available to us each time any of the Logger methods are called. If we do, then we check for logger property on that data object. If that exists, and is an instance of Logger, then we call the log method on that Logger instance rather than on the singleton instance.

Here's an example:

import { Logger, LoggerLevel } from '@gradientedge/logger'

const myLogger = new Logger({
  level: LoggerLevel.WARN,
  baseData: {
      requestId: '1234'
  }
})

const context = {
  logger: myLogger
}

als.create(context, async () => {
  
  log.debug('Test message', { name: 'Jimmy' })
  
  // Prints the following:
  //
  // {
  //   "level": "debug",
  //   "message": "Test message",
  //   "base": {
  //     "requestId": "1234"
  //   },
  //   "data": {
  //     "name": "Jimmy"
  //   }
  // }
})

Setting the log level with an environment variable

You can define a LOGGER_LEVEL environment variable with one of the following values:

  • debug
  • info
  • warn
  • error

If set, this will be used as the default log level for any new instances of the Logger class.

FAQs

Package last updated on 25 Oct 2023

Did you know?

Socket

Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.

Install

Related posts

SocketSocket SOC 2 Logo

Product

  • Package Alerts
  • Integrations
  • Docs
  • Pricing
  • FAQ
  • Roadmap
  • Changelog

Packages

npm

Stay in touch

Get open source security insights delivered straight into your inbox.


  • Terms
  • Privacy
  • Security

Made with ⚡️ by Socket Inc