アプリケーションロギング

目次

• 概要
• 使用場面
• クイックスタート
• リファレンスガイド
• ベストプラクティス

概要

適切なレベル、コンテキスト、および集中管理された集約を備えた包括的な構造化ロギングを実装し、効果的なデバッグと監視を実現します。

使用場面

• アプリケーションのデバッグ
• 監査証跡の作成
• パフォーマンス分析
• コンプライアンス要件
• 集中ロギング集約

クイックスタート

最小限の動作例：

// logger.js
const winston = require("winston");

const logFormat = winston.format.combine(
  winston.format.timestamp({ format: "YYYY-MM-DD HH:mm:ss" }),
  winston.format.errors({ stack: true }),
  winston.format.json(),
);

const logger = winston.createLogger({
  level: process.env.LOG_LEVEL || "info",
  format: logFormat,
  defaultMeta: {
    service: "api-service",
    environment: process.env.NODE_ENV || "development",
  },
  transports: [
    new winston.transports.Console({
      format: winston.format.combine(
        winston.format.colorize(),
        winston.format.simple(),
      ),
    }),
    new winston.transports.File({
      filename: "logs/error.log",
// ... (詳細な実装についてはリファレンスガイドを参照)

リファレンスガイド

references/ ディレクトリ内の詳細な実装：

ガイド	内容
Node.js構造化ロギング（Winston）	Node.js構造化ロギング（Winston）
Express HTTPリクエストロギング	Express HTTPリクエストロギング
Python構造化ロギング	Python構造化ロギング
Flask統合	Flask統合
ELKスタックセットアップ	ELKスタックセットアップ
Logstash設定	Logstash設定

ベストプラクティス

✅ すること

• 構造化JSON ロギングを使用する
• トレーシング用のリクエストIDを含める
• 適切なレベルでログを記録する
• エラーログにコンテキストを追加する
• ログローテーションを実装する
• タイムスタンプを一貫して使用する
• ログを集中管理する
• 機密データをフィルタリングする

❌ しないこと

• パスワードまたはシークレットをログに記録しない
• すべての操作をINFOレベルでログに記録しない
• 非構造化メッセージを使用しない
• ログストレージの制限を無視しない
• コンテキスト情報をスキップしない
• 本番環境でstdoutにログを出力しない
• 無制限のログファイルを作成しない