로깅과 감사 추적

// src/app.service.ts
import { Injectable, Logger } from '@nestjs/common';

@Injectable()
export class AppService {
  private readonly logger = new Logger(AppService.name); // 클래스 이름을 로거 컨텍스트로 사용

  getHello(): string {
    this.logger.log('Hello World API가 호출되었습니다.'); // INFO 레벨
    this.logger.warn('데이터베이스 연결에 문제가 있을 수 있습니다.'); // WARN 레벨
    this.logger.error('치명적인 오류 발생!', '스택 트레이스'); // ERROR 레벨
    this.logger.debug('디버그 메시지'); // DEBUG 레벨 (환경 설정에 따라 출력 여부 결정)
    return 'Hello World!';
  }
}

// src/main.ts
import { NestFactory } from '@nestjs/core';
import { AppModule } from './app.module';
import { Logger } from '@nestjs/common'; // Logger 임포트

async function bootstrap() {
  const app = await NestFactory.create(AppModule, {
    logger: ['error', 'warn', 'log', 'debug', 'verbose'], // 기본적으로 출력할 로그 레벨
    // 또는 환경 변수에 따라 다르게 설정:
    // logger: process.env.NODE_ENV === 'production' ? ['error', 'warn', 'log'] : ['error', 'warn', 'log', 'debug'],
  });

  // NestJS의 기본 로거 인스턴스에 접근하여 설정 변경
  // app.useLogger(new Logger()); // 커스텀 로거를 주입할 수도 있습니다.

  await app.listen(3000);
  Logger.log(`Application is running on: ${await app.getUrl()}`, 'Bootstrap');
}
bootstrap();

npm install winston winston-daily-rotate-file
npm install --save-dev @types/winston @types/winston-daily-rotate-file

// src/config/winston.logger.ts
import { LoggerService } from '@nestjs/common';
import { createLogger, format, transports, Logger as WinstonLoggerType } from 'winston';
import * as DailyRotateFile from 'winston-daily-rotate-file';

export class WinstonLogger implements LoggerService {
  private readonly logger: WinstonLoggerType;

  constructor() {
    // 콘솔에 컬러풀하게 출력하는 포맷
    const consoleFormat = format.combine(
      format.timestamp({ format: 'YYYY-MM-DD HH:mm:ss' }),
      format.colorize(),
      format.printf(info => `${info.timestamp} [${info.level}] [${info.context || 'App'}] ${info.message}`),
    );

    // 파일에 JSON 형식으로 저장하는 포맷
    const fileFormat = format.combine(
      format.timestamp({ format: 'YYYY-MM-DD HH:mm:ss' }),
      format.json(),
    );

    this.logger = createLogger({
      level: process.env.NODE_ENV === 'production' ? 'info' : 'debug', // 운영은 info, 개발은 debug 레벨
      format: fileFormat, // 파일에는 JSON 포맷 적용
      transports: [
        new transports.Console({
          format: consoleFormat, // 콘솔에는 컬러 포맷 적용
        }),
        new DailyRotateFile({ // 날짜별 로그 파일 생성
          filename: 'logs/application-%DATE%.log',
          datePattern: 'YYYY-MM-DD',
          zippedArchive: true,
          maxSize: '20m', // 20MB 이상 시 새 파일 생성
          maxFiles: '14d', // 14일치 로그 보관
          level: 'info', // 파일에는 info 레벨 이상만 기록
        }),
        new DailyRotateFile({ // 에러 로그만 따로 파일 생성
          filename: 'logs/error-%DATE%.log',
          datePattern: 'YYYY-MM-DD',
          zippedArchive: true,
          maxSize: '20m',
          maxFiles: '14d',
          level: 'error', // error 레벨만 기록
        }),
      ],
      exceptionHandlers: [ // 처리되지 않은 예외를 파일에 기록
        new DailyRotateFile({
          filename: 'logs/exceptions-%DATE%.log',
          datePattern: 'YYYY-MM-DD',
          zippedArchive: true,
          maxSize: '20m',
          maxFiles: '14d',
        }),
      ],
      rejectionHandlers: [ // Promise 예외를 파일에 기록
        new DailyRotateFile({
          filename: 'logs/rejections-%DATE%.log',
          datePattern: 'YYYY-MM-DD',
          zippedArchive: true,
          maxSize: '20m',
          maxFiles: '14d',
        }),
      ],
    });
  }

  log(message: any, context?: string) {
    this.logger.info(message, { context });
  }

  error(message: any, trace?: string, context?: string) {
    this.logger.error(message, { trace, context });
  }

  warn(message: any, context?: string) {
    this.logger.warn(message, { context });
  }

  debug(message: any, context?: string) {
    this.logger.debug(message, { context });
  }

  verbose(message: any, context?: string) {
    this.logger.verbose(message, { context });
  }
}

// src/main.ts
import { NestFactory } from '@nestjs/core';
import { AppModule } from './app.module';
import { WinstonLogger } from './config/winston.logger'; // 커스텀 로거 임포트

async function bootstrap() {
  const app = await NestFactory.create(AppModule, {
    logger: new WinstonLogger(), // 커스텀 로거 인스턴스 주입
  });

  await app.listen(3000);
  new WinstonLogger().log(`Application is running on: ${await app.getUrl()}`, 'Bootstrap');
}
bootstrap();