Logging Best Practices For Your Node.js App

Alerty - Aug 9 - - Dev Community

As a Node.js developer, logging is pretty much everything when it comes to debugging, monitoring, and maintaining your applications. But are you using the logging best practices? Let's explore some logging techniques that can take your Node.js apps to the next level.

To learn more, you can check out the full blog post.

1. Winston: The Swiss Army Knife of Logging

๐Ÿ”ง Tool: Winston
๐Ÿ“ Description: A versatile logging library for Node.js
๐ŸŒŸ Key Features:

  • Multiple transport options (console, file, database)
  • Customizable log levels
  • Supports logging in various formats (JSON, plain text)
javascriptCopyconst winston = require('winston');

const logger = winston.createLogger({
  level: 'info',
  format: winston.format.json(),
  transports: [
    new winston.transports.File({ filename: 'error.log', level: 'error' }),
    new winston.transports.File({ filename: 'combined.log' })
  ]
});
Enter fullscreen mode Exit fullscreen mode

2. Morgan: HTTP Request Logger Middleware

๐Ÿ”ง Tool: Morgan
๐Ÿ“ Description: Simplifies HTTP request logging in Express.js
๐ŸŒŸ Key Features:

  • Pre-defined logging formats
  • Custom token support
  • Easy integration with Express.js
javascriptCopyconst express = require('express');
const morgan = require('morgan');

const app = express();
app.use(morgan('combined'));
Enter fullscreen mode Exit fullscreen mode

3. Bunyan: JSON Logging for Node.js

๐Ÿ”ง Tool: Bunyan
๐Ÿ“ Description: Structured JSON logging for Node.js applications
๐ŸŒŸ Key Features:

  • JSON log format by default
  • Supports child loggers
  • Built-in CLI for viewing logs
javascriptCopyconst bunyan = require('bunyan');
const log = bunyan.createLogger({name: "myapp"});

log.info("Hi");
log.warn({lang: 'fr'}, "Au revoir");
Enter fullscreen mode Exit fullscreen mode

4. Pino: Super Fast Node.js Logger

๐Ÿ”ง Tool: Pino
๐Ÿ“ Description: Low overhead logging with JSON output
๐ŸŒŸ Key Features:

  • Extremely fast performance
  • Automatic log rotation
  • Supports child loggers
javascriptCopyconst pino = require('pino');
const logger = pino();

logger.info('hello world');
logger.error('this is at error level');
Enter fullscreen mode Exit fullscreen mode

5. debug: Tiny Debugging Utility

๐Ÿ”ง Tool: debug
๐Ÿ“ Description: Small debugging utility for Node.js
๐ŸŒŸ Key Features:

  • Lightweight and simple to use
  • Selective debugging with namespaces
  • Browser support
javascriptCopyconst debug = require('debug')('http');

debug('booting %o', name);
Enter fullscreen mode Exit fullscreen mode

6. Log4js: Flexible Logging for JavaScript

๐Ÿ”ง Tool: Log4js
๐Ÿ“ Description: A conversion of the log4j framework to JavaScript
๐ŸŒŸ Key Features:

  • Hierarchical logging levels
  • Multiple output appenders
  • Configurable layouts
javascriptCopyconst log4js = require("log4js");
log4js.configure({
  appenders: { cheese: { type: "file", filename: "cheese.log" } },
  categories: { default: { appenders: ["cheese"], level: "error" } }
});

const logger = log4js.getLogger("cheese");
logger.error("Cheese is too ripe!");
Enter fullscreen mode Exit fullscreen mode

7. Elasticsearch, Logstash, and Kibana (ELK Stack)

๐Ÿ”ง Tool: ELK Stack
๐Ÿ“ Description: A powerful combination for log management and analysis
๐ŸŒŸ Key Features:

  • Centralized logging
  • Real-time log analysis
  • Visualizations and dashboards
javascriptCopyconst winston = require('winston');
const Elasticsearch = require('winston-elasticsearch');

const esTransportOpts = {
  level: 'info',
  clientOpts: { node: 'http://localhost:9200' }
};
const logger = winston.createLogger({
  transports: [
    new Elasticsearch(esTransportOpts)
  ]
});
Enter fullscreen mode Exit fullscreen mode

8. Sentry: Error Tracking and Performance Monitoring

๐Ÿ”ง Tool: Sentry
๐Ÿ“ Description: Real-time error tracking and performance monitoring
๐ŸŒŸ Key Features:

  • Automatic error capturing
  • Release tracking
  • Performance monitoring
javascriptCopyconst Sentry = require("@sentry/node");

Sentry.init({ dsn: "https://examplePublicKey@o0.ingest.sentry.io/0" });

try {
  someFunction();
} catch (e) {
  Sentry.captureException(e);
}
Enter fullscreen mode Exit fullscreen mode

9. New Relic: Application Performance Monitoring

๐Ÿ”ง Tool: New Relic
๐Ÿ“ Description: Comprehensive application performance monitoring
๐ŸŒŸ Key Features:

  • Real-time performance metrics
  • Error analytics
  • Custom instrumentation
javascriptCopyconst newrelic = require('newrelic');

newrelic.setTransactionName('myCustomTransaction');
// Your application code here

Enter fullscreen mode Exit fullscreen mode

10. Loggly: Cloud-based Log Management

๐Ÿ”ง Tool: Loggly
๐Ÿ“ Description: Cloud-based log management and analytics service
๐ŸŒŸ Key Features:

  • Centralized log management
  • Real-time log search and analysis
  • Custom dashboards and alerts
javascriptCopyconst winston = require('winston');
const { Loggly } = require('winston-loggly-bulk');

winston.add(new Loggly({
    token: "YOUR-TOKEN",
    subdomain: "YOUR-SUBDOMAIN",
    tags: ["Winston-NodeJS"],
    json: true
}));
Enter fullscreen mode Exit fullscreen mode

winston.log('info', "Hello World from Node.js!");

Bonus Tip: Structured Logging

Regardless of the tool you choose, implementing structured logging can greatly improve your log analysis capabilities:

javascriptCopylogger.info({
  event: 'user_login',
  userId: user.id,
  timestamp: new Date().toISOString(),
  ipAddress: req.ip
});
Enter fullscreen mode Exit fullscreen mode

By using these additional tools and practices, you'll have a comprehensive logging strategy that covers everything from basic debugging to advanced application performance monitoring. Remember, the key to effective logging is choosing the right tools for your specific needs and consistently applying best practices throughout your codebase.

If you need help debugging your web app, check out https://alerty.ai to learn more about easy frontend monitoring.

Happy logging, and may your Node.js apps run smoothly! ๐Ÿš€๐Ÿ”

. . .
Terabox Video Player