로거

Sumor Cloud 도구입니다.
더 많은 문서

이것은 Node.JS용 가벼운 로거입니다. 다양한 레벨에서 로그를 출력할 수 있으며, scope, id 및 시간대를 사용자정의할 수 있습니다.

CI 테스트 Coverage 보안 검사

설치

npm i @sumor/logger --save

전제 조건

Node.JS 버전

Node.JS 버전 16.x 이상을 필요로 합니다.

Node.JS ES 모듈 필요

이 패키지는 ES 모듈로 작성되었으므로, package.json 파일의 다음 코드를 변경해주셔야 합니다:

{
  "type": "module"
}

사용법

일반적인 사용법

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

logger.trace('안녕, 세계!')
// 다음 출력을 볼 수 있습니다:
// 2020-01-01 00:00:00.000 TRACE MAIN - 안녕, 세계!

Scope 변경

일부 경우에는 로그를 범주화해야 할 때가 있습니다. scope는 이 목적으로 사용됩니다.

import Logger from '@sumor/logger'
const logger = new Logger({
  scope: '데모'
})
logger.trace('안녕, 세계!')
// 다음 출력을 볼 수 있습니다:
// 2020-01-01 00:00:00.000 TRACE 데모 - 안녕, 세계!

식별자 사용자 변경

일부 경우에는 식별자 사용자가 필요할 수 있습니다. id를 이 목적으로 사용합니다.

import Logger from '@sumor/logger'
const logger = new Logger({
  id: 'USER001'
})
logger.trace('안녕, 세계!')
// 다음 출력을 볼 수 있습니다:
// 2020-01-01 00:00:00.000 TRACE MAIN USER001 - 안녕, 세계!

레벨 변경

대부분의 경우, 특정 레벨의 로그만 출력해야 할 때가 많습니다. 그럼 저장하고 표시할지 여부를 결정할 수 있습니다.

import Logger from '@sumor/logger'
const logger = new Logger()
logger.trace('안녕, 세계!') // trace는 가장 낮은 레벨이며, 모든 로그가 출력됩니다.
logger.debug('안녕, 세계!')
logger.info('안녕, 세계!')
logger.warn('안녕, 세계!')
logger.error('안녕, 세계!')
logger.fatal('안녕, 세계!') // fatal은 가장 높은 레벨이며, 중요한 오류만 출력됩니다.

시간대 변경

import Logger from '@sumor/logger'
const logger1 = new Logger({
  offset: 2 * 60 // UTC+2 오프셋은 2시간입니다
})
logger1.info('안녕, 세계!')
// 다음 출력을 볼 수 있습니다:
// 2020-01-01 02:00:00.000 INFO MAIN - 안녕, 세계!

const logger2 = new Logger({
  offset: 8 * 60 // UTC+8 오프셋은 8시간입니다
})
logger2.info('안녕, 세계!')
// 다음 출력을 볼 수 있습니다:
// 2020-01-01 08:00:00.000 INFO MAIN - 안녕, 세계!