logger

Un outil Sumor Cloud.
Plus de documentation

Il s'agit d'un enregistreur léger pour Node.JS. Il peut afficher des journaux à différents niveaux, et vous pouvez personnaliser la portée, l'identifiant et le fuseau horaire.

Installation

npm i @sumor/logger --save

Prérequis

Version de Node.JS

Nécessite la version Node.JS 16.x ou supérieure

Exiger le module ES de Node.JS

Comme ce package est écrit en module ES, veuillez modifier le code suivant dans votre fichier package.json :

{
  "type": "module"
}

Utilisation

Utilisation générale

import Logger from '@sumor/logger'
const logger = new Logger()

logger.trace('Bonjour le monde!')
// Vous verrez la sortie suivante:
// 2020-01-01 00:00:00.000 TRACE MAIN - Bonjour le monde!

Changer la portée

Dans certains cas, nous devons catégoriser les journaux. scope est utilisé à cette fin.

import Logger from '@sumor/logger'
const logger = new Logger({
  scope: 'DEMO'
})
logger.trace('Bonjour le monde!')
// Vous verrez la sortie suivante:
// 2020-01-01 00:00:00.000 TRACE DEMO - Bonjour le monde!

Identifiant utilisateur

Dans certains cas, nous avons besoin d'un identifiant utilisateur. id est utilisé à cette fin.

import Logger from '@sumor/logger'
const logger = new Logger({
  id: 'USER001'
})
logger.trace('Bonjour le monde!')
// Vous verrez la sortie suivante:
// 2020-01-01 00:00:00.000 TRACE MAIN USER001 - Bonjour le monde!

Changer le niveau

La plupart du temps, nous devons seulement afficher des journaux d'un certain niveau. Nous pouvons alors décider de le stocker et de l'afficher ou non.

import Logger from '@sumor/logger'
const logger = new Logger()
logger.trace('Bonjour le monde!') // trace est le niveau le plus bas, tous les journaux seront affichés
logger.debug('Bonjour le monde!')
logger.info('Bonjour le monde!')
logger.warn('Bonjour le monde!')
logger.error('Bonjour le monde!')
logger.fatal('Bonjour le monde!') // fatal est le niveau le plus élevé, seules les erreurs critiques seront affichées

Changer le fuseau horaire

import Logger from '@sumor/logger'
const logger1 = new Logger({
  offset: 2 * 60 // Décalage UTC+2 est de 2 heures
})
logger1.info('Bonjour le monde!')
// Vous verrez la sortie suivante:
// 2020-01-01 02:00:00.000 INFO MAIN - Bonjour le monde!

const logger2 = new Logger({
  offset: 8 * 60 // Décalage UTC+8 est de 8 heures
})
logger2.info('Bonjour le monde!')
// Vous verrez la sortie suivante:
// 2020-01-01 08:00:00.000 INFO MAIN - Bonjour le monde!