aio-lib-core-logging

Node.js Logger module for use by the Adobe I/O SDK

Install

npm install @adobe/aio-lib-core-logging

Use

letaioLogger=require('@adobe/aio-lib-core-logging')('App')aioLogger.info('Hello logs')

Output

Above code will log the following

[App /mynamespace/myaction] info: Hello logs

Where App would be the name of the application/module that is sending the logs.

Configuration

The logger can be customized by passing a config object at the time of creation.

letaioLogger=require('@adobe/aio-lib-core-logging')('App',config)

The config object can have one or more of the following keys.

• level (max severity logging level to be logged. can be one of error, warn, info, verbose, debug, silly)
• provider (logging provider. default is winston.)
• logSourceAction (boolean to control whether to include the action name in the log message)
• transports (array of custom winston transports)

The global log level can also be overridden using the env variable AIO_LOG_LEVEL or the env variable LOG_LEVEL.

Enabling Debug Level Logging on command line

Avoid setting the global env variable by passing the log configuration in front of the aio command and stax flexibel.

To see all logs, do

$ DEBUG=* aio app run

Once you have figured out what logs you are interrested in, use something more specific, like

$ DEBUG=aio-telemetry:telemetry-lib* aio config

Enabling Debug Level Logging programatically

Example of logger configuration:

constlogger=require('@adobe/aio-lib-core-logging')('MyModuleName',{provider: 'debug'})logger.info('info')logger.debug('debug')

To see both logs:

AIO_LOG_LEVEL=debugDEBUG=MyModuleName

It is possible to set the log level from another environment variable if needed:

constlogger=require('@adobe/aio-lib-core-logging')('MyModuleName',{provider: 'debug',level: process.env.FOOBAR})logger.info('info')logger.debug('debug')

Using custom logger

// Winston LoggerletaioLogger=require('@adobe/aio-lib-core-logging')('App',{provider:'winston'})aioLogger.info('Hello logs')

or

// Debug LoggerletaioLogger=require('@adobe/aio-lib-core-logging')('App',{provider:'debug'})

Send logs to a file

letaioLogger=require('@adobe/aio-lib-core-logging')('App',{transports: './logfile.txt'})

Custom winston transports

constwinston=require('winston')letaioLogger=require('@adobe/aio-lib-core-logging')('App',{transports: [newwinston.transports.File({filename: './winstoncustomfilelog.txt'})]})

Creating custom logger

This is currently as simple as creating a new logger class under src with all the log level functions defined

Explore

gotoAPI

Contributing

Contributions are welcomed! Read the Contributing Guide for more information.

Licensing

This project is licensed under the Apache V2 License. See LICENSE for more information.