@logtracing/node NPM

:book: Configuration

:open_file_folder: Creating your database

Before start using this suite, you need to have a MySQL database ready to be used (locally or on a server) and create the required tables.

You can find the migration SQL file here: SQL for tables

:wrench: Initial configuration

Install the package:

npm i @logtracing/node

Create a .env file and add the following properties with your own information, replace [ENV] with your environment (DEV, TEST, or PROD):

MYSQL_USERNAME_[ENV]=
MYSQL_PASSWORD_[ENV]=
MYSQL_DATABASE_[ENV]=
MYSQL_HOST_[ENV]=
MYSQL_PORT_[ENV]=

Load your .env file using the dotenv module at the very beginning of your code (before other code runs):

require('dotenv').config();

// or
import 'dotenv/config';

Import it in your code:

const { ExceptionLogger } = require('@logtracing/node');

// or
import { ExceptionLogger } from '@logtracing/node';

:rocket: Usage

`Logger`

You can write your own logs using the Logger class:

const { Logger } = require('@logtracing/node');

const myLogger = new Logger('MY APP LOGGER');

const trace = await logger.trace('Example of a trace log message');
const debug = await logger.debug('Example of a debug log message');
const info = await logger.info('Example of an info log message');
const warn = await logger.warn('Example of a warn log message');
const error = await logger.error('Example of an error log message');
const fatal = await logger.fatal('Example of a fatal log message');

`ExceptionLogger`

You can also track the exceptions in your code, to have a big picture of what happened when your application fails. Start tracking your errors:

const exLogger = new ExceptionLogger('MY APP EXCEPTION LOGGER');

const user = {
  username: 'admin',
  email: 'email@admin.com'
};

const foo = (): void => {
  throw new Error('Foo Error');
};

const bar = (): void => {
  foo();
};

// You can add extra information that could be useful to understand the error
exLogger.addExtra('User information', {
  user: user,
});

try {
  bar();
} catch (err) {
  exLogger.addExtra('More information', 'Handled Error Message');

  // Start to track the error
  exLogger.trackError(err).then(() => {
  
    // When finish, call report() to send all the information to your DB
    log.report();
  });
}

:zap: After doing this, you'll have in your configured database all the information related to the error that you tracked.

❕You'll find more examples in this folder.

:arrow_down: Installation for development purposes

Getting the code

Clone this project:

git clone git@github.com:logtracing/node-pkg.git

# I recommend you change the name of the folder in your machine
git clone git@github.com:logtracing/node-pkg.git logtracing-nodejs

Install dependencies: