ログの管理（winstonなど）

Node.jsアプリケーションを本番環境で安定的に運用するためには、「ログの管理」が極めて重要です。ログはアプリケーションの状態監視、障害時の原因特定、セキュリティ対策、パフォーマンス分析などに役立ちます。その中でも、Node.jsで広く使われているログライブラリが winston です。

---

1. ログ管理の目的と分類

ログは主に以下のように分類されます：

---

2. winston の特徴

winston は柔軟で拡張性の高いログライブラリであり、以下の特徴を備えています。

• ログレベルの設定（error, warn, info, debugなど）

• 複数の出力先（コンソール、ファイル、HTTP、DBなど）に同時出力可能

• フォーマット設定（JSON形式、タイムスタンプ、色付けなど）

• ログのローテーション対応（winston-daily-rotate-fileと併用）

---

3. winston の導入手順

インストール

bash
npm install winston

必要に応じて、ログローテーション用のモジュールも導入可能：

bash
npm install winston-daily-rotate-file

---

4. 基本的な使い方

javascript
const winston = require('winston');

const logger = winston.createLogger({
  level: 'info', // 最小ログレベル
  format: winston.format.combine(
    winston.format.timestamp(),
    winston.format.printf(({ level, message, timestamp }) => {
      return `${timestamp} [${level.toUpperCase()}] ${message}`;
    })
  ),
  transports: [
    new winston.transports.Console(),             // コンソール出力
    new winston.transports.File({ filename: 'logs/error.log', level: 'error' }), // エラーログ
    new winston.transports.File({ filename: 'logs/combined.log' })               // すべてのログ
  ],
});

---

5. 使用例

javascript
logger.info('アプリケーションが起動しました');
logger.warn('ディスク容量が少なくなっています');
logger.error('データベース接続に失敗しました');

---

6. ログローテーションの導入例（winston-daily-rotate-file）

javascript
const DailyRotateFile = require('winston-daily-rotate-file');

logger.add(new DailyRotateFile({
  filename: 'logs/application-%DATE%.log',
  datePattern: 'YYYY-MM-DD',
  maxFiles: '14d', // 14日間保存
}));

---

7. 本番運用でのベストプラクティス

• .env によってログレベルを制御（開発時: debug、本番: info）

• ログファイルの監視（例：Logrotateや監視ツールと連携）

• セキュリティ情報（パスワード等）は絶対にログに出力しない

• 構造化ログ（JSON）による解析性向上

• APMやログ収集ツール（例：ELK、Fluentd）との統合

---

8. まとめ

winston を活用したログ管理は、Node.jsアプリケーションの運用監視とトラブルシューティングにおいて非常に効果的です。適切なログレベル、出力形式、保管戦略を設計し、本番環境での信頼性と保守性を高めることが重要です。