ログの取り方で差がつく！エラー発見のためのログ出力ベストプラクティス

ログ出力の基本：INFOとERRORの違いを意識しよう

ログレベルは適切に使い分けることが重要です。以下のような分類をベースに、目的に応じた出力を心がけましょう。

一般的なログレベルの使い分け

例（Node.js / Winston）：

import winston from 'winston';

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

logger.info('API処理を開始しました');
logger.error('データベース接続に失敗しました');

重要なコンテキスト情報を含める

ログには「いつ・どこで・なにが起こったか」を明確に記述することが重要です。以下のような情報は最低限含めましょう。

• タイムスタンプ
• モジュール名やファイル名
• 関数名や処理中のステータス
• ユーザーIDやリクエストID（トレーサビリティのため）

例（PHP / Laravel）：

Log::error('ユーザー情報の取得に失敗', [
    'user_id' => $userId,
    'function' => __FUNCTION__,
    'file' => __FILE__,
]);

フロントエンドでも同様：

console.error('フォーム送信エラー', {
  page: location.pathname,
  userAgent: navigator.userAgent,
  payload: formData,
});

例外は握りつぶさない！スタックトレースを残そう

エラーの詳細がわからない「何かエラーが発生しました」ログは開発者を悩ませます。例外をキャッチした際はスタックトレースも含めてログ出力しましょう。

例（Python）：

import logging
import traceback

try:
    risky_function()
except Exception as e:
    logging.error("処理中に例外が発生しました: %s", traceback.format_exc())

開発と本番でログレベル・出力先を切り替える

環境に応じてログの粒度や出力先を変えるのも大切です。

• 開発環境：DEBUGレベルで詳細な情報を出力。コンソール表示も有効。
• 本番環境：INFO〜ERRORレベルに絞り、ログファイルやログ管理サービスに送信。

例（Node.js / 環境変数で制御）：

const level = process.env.NODE_ENV === 'production' ? 'info' : 'debug';
const logger = winston.createLogger({ level, ... });

フォーマットは統一し、検索しやすく

ログが散らかっていると分析に時間がかかります。以下のような工夫で、読みやすく・解析しやすいログ設計をしましょう。

• JSON形式にする（ログ収集ツールでの活用を意識）
• ログの各項目をキーで明示
• ログ出力テンプレートを導入

例（JSON形式ログ）：

{
  "timestamp": "2025-05-16T12:34:56Z",
  "level": "error",
  "message": "APIエラー",
  "request_id": "abc123",
  "user_id": 42,
  "stack": "Error at processRequest (/app/index.js:42:13)"
}

まとめ：ログは“見える化”の第一歩、運用力の差はここに出る

ただ「console.logしてるだけ」では、いざというときに何もわかりません。
本記事で紹介したベストプラクティスを意識すれば、エラー対応力・障害復旧スピード・開発効率のすべてがレベルアップします。
ログ設計から「プロの開発者」としての姿勢を見せましょう！