Logging for TypeScript: Best Solutions

Logging for TypeScript: Best Solutions and Tools

Logging is a critical part of any TypeScript application. Without a quality logging system, it is impossible to effectively debug code, analyze errors in production, and track system behavior. In this article, we will review the best libraries for logging in TypeScript, compare their capabilities, and provide practical usage examples.

Why is logging needed in TypeScript?

TypeScript, being a superset of JavaScript, inherits all the features of working with asynchrony and the event-driven model. This makes logging especially important for:

Debugging — understanding the sequence of asynchronous operations
Monitoring — tracking application state in real-time
Error Analysis — detailed information about failures and exceptions
Auditing — recording user actions and system events
Performance — measuring the execution time of critical operations

Top 4 Libraries for Logging in TypeScript

1. Winston — The Universal Choice

Winston is the most popular logging library for Node.js with excellent TypeScript support. It provides a flexible system of transports (where to send logs) and logging levels.

Installation:

npm install winstonnpm install @types/winston --save-dev

Basic configuration example:

import winston from 'winston';

const logger = winston.createLogger({    level: 'info',    format: winston.format.combine(        winston.format.timestamp(),        winston.format.json()    ),    transports: [        new winston.transports.Console(),        new winston.transports.File({ filename: 'error.log', level: 'error' }),        new winston.transports.File({ filename: 'combined.log' })    ]});

// Usage with TypeScriptlogger.info('Server started', { port: 3000 });logger.error('Database connection error', { error: err.message });

2. Pino — The Ultra-Fast Logger

Pino is the most performant logger for Node.js. It is optimized for minimal impact on application performance and is ideal for high-load systems.

Installation:

npm install pinonpm install @types/pino --save-dev

Usage example with TypeScript:

import pino from 'pino';

const logger = pino({    level: process.env.LOG_LEVEL || 'info',    transport: {        target: 'pino-pretty',        options: {            colorize: true,            translateTime: 'SYS:standard'        }    }});

// Typed logginginterface UserAction {    userId: string;    action: string;    timestamp: Date;}

logger.info({ type: 'user_action', data: { userId: '123', action: 'login' } } as UserAction);

3. log4js — Powerful and Configurable

log4js is a successor to the popular Java framework Log4j. It offers a rich configuration system and support for various output formats.

Installation:

npm install log4jsnpm install @types/log4js --save-dev

Configuration example with TypeScript:

import log4js from 'log4js';

log4js.configure({    appenders: {        out: { type: 'stdout', layout: { type: 'colored' } },        app: { type: 'file', filename: 'application.log' }    },    categories: {        default: { appenders: ['out', 'app'], level: 'debug' },        'api': { appenders: ['out'], level: 'info' }    }});

const logger = log4js.getLogger('api');logger.info('API request processed');logger.debug('Request parameters:', { method: 'GET', url: '/users' });