README

aio-lib-core-logging

Install

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

Use

let aioLogger = 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.

let aioLogger = 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 log level can also be overridden using the env variable AIO_LOG_LEVEL

Using custom logger

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

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

Send logs to a file

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

Custom winston transports

const winston = require('winston')
let aioLogger = require('@adobe/aio-lib-core-logging')('App', {transports: [new winston.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

goto API

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.

Usage no npm install needed!