bb-plane-fork/packages/logger
Aaron 90866fb925
chore: use oxc tooling to speed up prettier (#8117)
Co-authored-by: sriramveeraghanta <veeraghanta.sriram@gmail.com>
2025-11-20 17:30:27 +05:30
..
src [WEB-5416] fix: Use proper import syntax (#8105) 2025-11-13 17:41:06 +05:30
.eslintignore chore: Add logger package for node server side apps (#6188) 2024-12-13 14:32:56 +05:30
.eslintrc.js [WEB-4790] fix: moved typescript parser to the base eslint config (#7658) 2025-08-27 21:03:20 +05:30
.prettierignore fix: CI to include lint and format along with build (#7482) 2025-08-18 21:27:16 +05:30
.prettierrc chore: use oxc tooling to speed up prettier (#8117) 2025-11-20 17:30:27 +05:30
package.json chore: use oxc tooling to speed up prettier (#8117) 2025-11-20 17:30:27 +05:30
README.md chore: format files using prettier (#7364) 2025-07-08 20:41:11 +05:30
tsconfig.json chore: Add logger package for node server side apps (#6188) 2024-12-13 14:32:56 +05:30
tsdown.config.ts [WEB-5048] chore: implements esm exports for all packages (#7816) 2025-10-06 21:01:32 +05:30

Logger Package

This package provides a logger and a request logger utility built using Winston. It offers customizable log levels using env and supports structured logging for general application logs and HTTP requests.

Features.

  • Dynamic log level configuration using env.
  • Pre-configured winston logger for general usage (logger).
  • Request logger middleware that logs incoming request

Usage

Adding as a package

Add this package as a dependency in package.json

dependency: {
    ...
    @plane/logger":"*",
    ...
}

Importing the Logger

import { logger, requestLogger } from "@plane/logger";

Usage

logger: General Logger

Use this for general application logs.

logger.info("This is an info log");
logger.warn("This is a warning");
logger.error("This is an error");

requestLogger: Request Logger Middleware

Use this as a middleware for incoming requests

const app = express();
app.use(requestLogger);

Available Log Levels

  • error
  • warn
  • info (default)
  • http
  • verbose
  • debug
  • silly

Log file

  • Log files are stored in logs folder of current working directory. Error logs are stored in files with format error-%DATE%.log and combined logs are stored with format combined-%DATE%.log.
  • Log files have a 7 day rotation period defined.

Configuration

  • By default, the log level is set to info.
  • You can specify a log level by adding a LOG_LEVEL in .env.