console.logの放置は危険?JavaScriptログ設計のアンチパターンと正しい例外処理

JavaScriptのconsole.log放置が招くリスクと正しいログ設計・例外処理を解説するイメージ プログラミング言語

JavaScript開発において、console.logは最も身近なデバッグ手段の一つです。
しかし、その手軽さゆえに本番環境へ不要なログが残り、パフォーマンス低下や情報漏洩リスクを招くケースが後を絶ちません。
特にNode.jsを用いたサーバーサイド開発では、リクエストごとに大量のログが出力され、ディスクI/Oやログ収集基盤のコストを圧迫する要因にもなります。

一方で、例外処理の設計が不十分なままtry...catchを多用し、catch節で安易にconsole.log(error)とだけ書くアンチパターンも頻繁に見受けられます。
これではスタックトレースは残っても、エラーの発生箇所やビジネス的な影響範囲が追跡しづらく、運用時の障害対応を著しく困難にします。
ログは「とりあえず出す」ものではなく、観測可能性(Observability)を担保する設計対象として捉えるべきです。

本記事では、以下の観点からJavaScriptのログ設計と例外処理のあり方を論理的に整理します。

  • console.logの放置が引き起こす具体的なリスクと、本番環境で無効化するためのビルド戦略
  • ログレベル(debug/info/warn/error)の責務分離と、構造化ログの導入メリット
  • try...catchにおけるアンチパターンと、エラーコンテキストを保持した再スローやカスタムエラークラスの活用法
  • 非同期処理(Promise/async-await)におけるunhandledRejectionの適切なハンドリング

これらを踏まえ、最終的には「開発時は詳細に、本番時は必要最小限に」という原則に基づいたログ設計の指針を提示します。
あなたのプロジェクトのconsole.logは、本当に安全に管理されていますか。

  1. console.log放置が引き起こす3つの危険性と本番環境でのリスク
    1. パフォーマンス低下と情報漏洩|不要なログがもたらす具体的な影響
    2. ビルドツールでconsole.logを自動削除する設定手法
  2. ログレベルの責務分離|debug・info・warn・errorを正しく使い分ける
    1. 各ログレベルが持つべき意味と出力先の設計指針
    2. 構造化ログ導入で変わる運用|JSON形式がもたらす検索性向上
  3. try-catchのアンチパターン|console.logだけでは障害対応できない理由
    1. エラーコンテキストを失わない再スローの実装テクニック
    2. カスタムエラークラスで例外を型として管理する設計
  4. 非同期処理の落とし穴|unhandledRejectionを適切にハンドリングする
    1. async-awaitにおける例外伝播の正しい理解
    2. グローバルハンドラで捕捉する最終防衛ラインの作り方
  5. 開発時と本番時で切り替えるログ設計のベストプラクティス
    1. 環境変数とロガーライブラリを組み合わせた実装例
    2. ログローテーションと保持期間の設計ポイント
  6. 可観測性を高めるログ基盤|APMやモニタリングツールとの連携
    1. SentryやDatadogを使ったエラートラッキングの導入
  7. ログ設計チェックリスト|今日から見直すべき7つの項目
    1. 1. console.logが本番ビルドに残っていないか
    2. 2. ログレベルが責務ごとに分離されているか
    3. 3. ログが構造化されているか
    4. 4. 例外が握りつぶされていないか
    5. 5. カスタムエラークラスで型管理されているか
    6. 6. 非同期処理の例外が適切に処理されているか
    7. 7. 環境ごとの切り替えと可観測性が確保されているか
  8. console.logの放置は危険?JavaScriptログ設計と例外処理のまとめ

console.log放置が引き起こす3つの危険性と本番環境でのリスク

ノートパソコンの画面に大量のconsole.logが表示され警告アイコンが浮かぶイメージ

JavaScriptの開発現場において、console.logは最も手軽なデバッグ手段として広く利用されています。
変数の値をその場で確認でき、ブレークポイントを設定する手間も不要です。
しかし、この手軽さがゆえに、開発者が削除を忘れたまま本番環境へデプロイしてしまう事例は後を絶ちません。
ここでは、console.logの放置がもたらす危険性を論理的に整理し、なぜ本番環境において深刻なリスクとなるのかを解説します。

第一の危険性は、パフォーマンスへの悪影響です。
ブラウザのDevToolsが開かれていない状態であっても、console.logの呼び出し自体は実行されます。
オブジェクトを文字列化する処理やスタックトレースの取得には相応のコストがかかり、特にループ内や頻繁に呼ばれる関数内での出力は、フレームレートの低下やレスポンス遅延を招きます。
第二の危険性は、情報漏洩です。
APIキー、認証トークン、個人情報、社内固有のロジックなどがログに出力されていれば、ブラウザのコンソールから誰でも閲覧できてしまいます。
第三の危険性は、ログ基盤の圧迫です。
Node.jsのサーバーサイドでは、リクエストごとに大量のログが標準出力に流れ、ディスクI/Oやログ収集サービスへの転送コストを押し上げます。

これらのリスクは、いずれも「開発時には便利だったものが、本番では害になる」という共通の構造を持っています。
では、具体的にどのような影響が生じるのかを、もう少し掘り下げて見ていきましょう。

パフォーマンス低下と情報漏洩|不要なログがもたらす具体的な影響

パフォーマンスの観点で見落とされがちなのが、console.logに渡す引数の評価コストです。
例えば、console.log(JSON.stringify(largeObject))のような記述は、DevToolsが閉じていてもJSON.stringifyが毎回実行されます。
数万件のデータを扱うループの中でこれが呼ばれれば、アプリケーション全体の応答性は著しく悪化します。
また、ブラウザによってはコンソールへの出力が内部的にバッファリングされ、メモリ使用量が増大するケースも報告されています。

情報漏洩のリスクは、さらに深刻です。
以下のようなコードが本番環境に残っていたとします。

  • console.log('user token:', accessToken)
  • console.log('request body:', req.body)
  • console.log('db query:', sql)

これらは一見すると無害なデバッグ出力に見えますが、攻撃者にとっては格好の情報源となります。
ブラウザのコンソールは誰でも開けますし、サーバーサイドのログはアクセス権限が適切に管理されていない場合も少なくありません。
ログは「書いた本人だけが見るもの」ではないという前提に立つ必要があります。

リスク種別 具体的な影響 想定される被害
パフォーマンス 文字列化・I/O負荷の増大 レスポンス遅延、離脱率上昇
情報漏洩 機密情報の露出 不正アクセス、信用失墜
ログ基盤 ストレージ・転送コスト増 運用コストの圧迫

この表からも分かる通り、console.logの放置は単なる「行儀の悪さ」ではなく、ビジネス上の損失に直結する技術的負債なのです。

ビルドツールでconsole.logを自動削除する設定手法

人力での削除には限界があります。
レビューで見落とすこともありますし、緊急のホットフィックスで削除し忘れることもあるでしょう。
そこで有効なのが、ビルドツールによる自動削除です。
WebpackやVite、esbuildといったモダンなツールには、本番ビルド時にconsole呼び出しを除去するオプションが用意されています。

例えば、esbuildではdropオプションにconsoleを指定するだけで、ビルド成果物からconsole.logを削除できます。

// esbuild.config.js
require('esbuild').build({
  entryPoints: ['src/index.js'],
  bundle: true,
  outfile: 'dist/bundle.js',
  drop: ['console'],
});

Terserを利用する場合も、compressオプションのdrop_consoleを有効化すれば同様の効果が得られます。
ただし、console.errorやconsole.warnまで削除してしまうと、本番環境での障害調査が困難になります。
エラーレベルのログは残し、デバッグ目的のログだけを除去するという方針が現実的です。

  • Terser: drop_console: true で全削除、pure_funcs: ['console.log'] で個別指定
  • esbuild: drop: ['console'] または pure: ['console.log']
  • Vite: build.minify: 'terser' と terserOptions.compress.drop_console を併用

これらの設定をCIに組み込み、本番ビルドでのみ適用するようにすれば、ヒューマンエラーに依存しない安全な運用が実現できます。
次の章では、ログそのものの設計、すなわちログレベルの責務分離について考えていきます。

ログレベルの責務分離|debug・info・warn・errorを正しく使い分ける

debugからerrorまで4段階のログレベルが色分けされた階層図のイメージ

ログを「とりあえず出力するもの」として扱っていると、本番環境で本当に見るべき情報が埋もれてしまいます。
これを防ぐための基本的な設計原則が、ログレベルの責務分離です。
レベルごとに意味と出力先を明確に定めることで、障害調査の迅速化と運用コストの最適化を両立できます。
ここでは、debug・info・warn・errorという4つの代表的なレベルを題材に、その使い分けと設計指針を論理的に整理します。

各ログレベルが持つべき意味と出力先の設計指針

まず押さえるべきは、各レベルが「誰に向けたメッセージなのか」を定義することです。
debugは開発者自身、infoは運用担当者、warnは監視システム、errorはオンコール対応者、というように読み手を想定すると、自然と出力内容と粒度が定まります。

  • debug: 開発時のみ必要な詳細情報。変数の値、関数の入口と出口、分岐の判定結果など。本番環境では原則として出力しません
  • info: 正常系の主要イベント。リクエストの受信、バッチの開始と完了、ユーザー操作の成功など。本番でも出力しますが、量を制御する必要があります
  • warn: 直ちに障害ではないが看過すべきでない状態。リトライの発生、非推奨APIの利用、リソース使用率の閾値超過など
  • error: 処理の継続が困難な異常。例外の発生、外部サービスの接続失敗、データ整合性の破壊など

出力先の設計も重要です。
すべてを同じファイルやストリームに流すと、ノイズが増えて検索性が低下します。
一般的には、debugとinfoは標準出力、warnとerrorは標準エラー出力に振り分け、さらに本番環境ではerrorのみをアラート通知の対象とする構成が効果的です。
以下の表は、レベルごとの想定読み手と出力先、保持期間の目安を整理したものです。

レベル 想定読み手 出力先 本番での扱い
debug 開発者 標準出力 出力しない
info 運用担当者 標準出力 条件付きで出力
warn 監視システム 標準エラー 記録して傾向分析
error オンコール 標準エラー 即時アラート

このように責務を分離しておけば、「エラーログを検索したらdebugレベルのノイズが大量に混ざっていた」という事態を避けられます。
ログレベルは単なるラベルではなく、運用フローと結びついた契約だと考えるべきです。

構造化ログ導入で変わる運用|JSON形式がもたらす検索性向上

レベル分離と並んで重要なのが、ログのフォーマットです。
従来のconsole.log('User logged in: ' + userId)のような文字列連結では、後から特定のユーザーの行動を追跡するのが困難です。
そこで採用したいのが構造化ログ、すなわちJSON形式での出力です。

logger.info({
  event: 'user_login',
  userId: 'u_12345',
  ip: req.ip,
  durationMs: 42,
});

この形式の利点は、ログ収集基盤側でフィールド単位の検索や集計が容易になる点にあります。
「特定のuserIdのログだけを抽出する」「durationMsが1000を超えたリクエストだけを集計する」といった操作が、正規表現に頼らずとも実現できます。
結果として、障害発生時の原因特定にかかる時間が大幅に短縮されます。

構造化ログを導入する際は、以下の点に注意してください。

  • フィールド名の命名規則をチーム内で統一する
  • 機密情報はマスキング処理を施してから出力する
  • タイムスタンプはISO 8601形式で統一する
  • 相関IDを付与し、リクエストをまたいだ追跡を可能にする

相関IDの付与は、マイクロサービス構成では特に効果を発揮します。
一つのリクエストが複数のサービスを通過する場合でも、同一の相関IDを付けておけば、ログを時系列で連結して追跡できます。
レベル分離と構造化、この二つを組み合わせることが、現代的なログ設計の出発点となるのです。
次の章では、例外処理におけるアンチパターンと、エラーコンテキストを保持する実装技法を見ていきます。

try-catchのアンチパターン|console.logだけでは障害対応できない理由

try-catch構文のcatch節にconsole.logだけが書かれたコードのイメージ

例外処理は、JavaScriptにおいて堅牢なアプリケーションを構築するための基礎です。
しかし、実際のコードベースを眺めると、try...catchが形骸化している例が少なくありません。
最も典型的なアンチパターンが、catch節でconsole.log(error)とだけ書いて処理を続行する、あるいは何もせず握りつぶすというものです。
この一見無害な記述が、なぜ障害対応を困難にするのかを論理的に考えてみましょう。

第一の問題は、エラーの発生箇所と影響範囲が追跡できない点です。
console.log(error)ではエラーメッセージとスタックトレースは残りますが、その時点でどのような入力が渡されていたのか、どのユーザーが操作していたのか、どのリクエストIDに紐づくのか、といったコンテキストが失われます。
第二の問題は、呼び出し元に異常が伝播しない点です。
例外を握りつぶして正常終了扱いにすると、上位のレイヤーは処理が成功したと誤認し、後続の処理で二次障害を引き起こします。
第三の問題は、ログレベルが適切でない点です。
すべてがconsole.logで出力されると、本当に対応が必要なエラーがノイズに埋もれてしまいます。

例外処理の目的は「エラーを止めること」ではなく、「エラーを正しく伝え、適切なレイヤーで対処すること」です。
この原則を忘れると、try...catchは問題を隠蔽する道具になってしまいます。

エラーコンテキストを失わない再スローの実装テクニック

例外を捕捉したうえで、より上位のレイヤーに判断を委ねたい場面は多くあります。
その際に有効なのが再スローです。
ただし、単にthrow errorと書くだけでは、元のスタックトレースは保持されても、その場で得られた追加情報を付与できません。
そこで活用したいのが、Errorオブジェクトのcauseプロパティです。

try {
  await saveUser(user);
} catch (err) {
  throw new Error('ユーザー保存に失敗しました', {
    cause: err,
    // 追加のコンテキストを保持する場合はカスタムプロパティを付与
  });
}

causeを使うことで、元の例外を失わずに、より抽象度の高いメッセージで再スローできます。
さらに、リクエストIDやユーザーIDといったコンテキストをカスタムプロパティとして付与すれば、ログ出力時にそれらを含められます。
ログ出力のタイミングは、再スローする直前ではなく、最終的にエラーを処理する最上位のレイヤーに集約するのが望ましいです。
各層でログを出すと重複が発生し、かえって調査が煩雑になります。

  • 例外を捕捉したら、その場で対処できない限りは再スローする
  • 再スロー時はcauseを活用し、元の例外を保持する
  • コンテキスト情報はカスタムプロパティとして付与する
  • ログ出力は最上位のエラーハンドラに一元化する

この原則に従えば、エラーの発生から対処までの流れが追跡可能になります。

カスタムエラークラスで例外を型として管理する設計

もう一つの有効な手法が、カスタムエラークラスの定義です。
Errorを継承した独自クラスを用意することで、例外を「型」として扱えるようになります。
例えば、バリデーションエラー、認証エラー、外部サービスエラーといった分類ごとにクラスを定義すれば、instanceofによる分岐が可能になり、エラーの種類に応じた処理を明瞭に記述できます。

class ValidationError extends Error {
  constructor(message, fields) {
    super(message);
    this.name = 'ValidationError';
    this.fields = fields;
  }
}

カスタムエラークラスを導入するメリットは、以下の三点に集約されます。

観点 効果
可読性 エラーの種類がコード上で明確になる
保守性 処理の分岐を型で表現でき、条件漏れを防げる
観測性 ログやメトリクスでエラー種別ごとの集計が容易になる

ただし、クラスを増やしすぎると管理コストが上がります。
まずは「呼び出し元が異なる対処を必要とするか」という基準で分類するのが現実的です。
対処法が同じなら、無理に分ける必要はありません。
例外処理は、エラーを隠すためのものではなく、エラーを情報として活用するための設計なのです。
次の章では、非同期処理に特有の落とし穴であるunhandledRejectionについて見ていきます。

非同期処理の落とし穴|unhandledRejectionを適切にハンドリングする

Promiseの未処理拒否が警告としてターミナルに表示されるイメージ

同期処理におけるtry...catchは直感的に理解しやすい仕組みです。
しかし、Promiseやasync-awaitが登場すると、例外の伝播経路は一気に複雑になります。
特に注意すべきがunhandledRejectionです。
これは、Promiseが拒否されたにもかかわらず、その拒否を処理するハンドラがどこにも存在しない状態を指します。
Node.jsではプロセスの異常終了、ブラウザではコンソールへの警告という形で表面化しますが、いずれにせよ見逃すと深刻な障害につながります。

なぜunhandledRejectionが発生するのでしょうか。
代表的な原因は、awaitを付け忘れたPromiseの呼び出しです。
あるいは、forEachやイベントリスナーの中で非同期関数を呼び出し、その戻り値を無視しているケースも該当します。
同期処理の感覚で書いたコードが、非同期の世界では例外を宙に浮かせてしまうのです。
ここを正しく理解することが、堅牢なアプリケーションへの第一歩となります。

async-awaitにおける例外伝播の正しい理解

async関数の中で発生した例外は、その関数が返すPromiseの拒否として扱われます。
つまり、awaitを付けずに呼び出せば、例外は呼び出し元に伝播せず、そのPromiseの内部に閉じ込められます。
以下のコードを見てください。

async function fetchData() {
  throw new Error('取得失敗');
}

// 誤り: 例外が伝播しない
fetchData();

// 正しい: awaitで捕捉できる
try {
  await fetchData();
} catch (err) {
  console.error(err);
}

awaitを付けた場合、例外は同期処理と同様にtry...catchで捕捉できます。
一方、awaitを付けない場合はPromiseが拒否されたまま放置され、unhandledRejectionとなります。
また、Promise.allを使う場合も注意が必要です。
複数のPromiseのうち一つでも拒否されると、全体が即座に拒否されます。
個別の失敗を許容したい場合はPromise.allSettledを選ぶべきです。

  • awaitの付け忘れはunhandledRejectionの主要因
  • Promise.allは一つでも拒否されると全体が失敗する
  • 個別の結果を扱いたい場合はPromise.allSettledを使う
  • イベントリスナー内の非同期処理は特に見落とされやすい

これらのポイントを意識するだけで、非同期処理に起因する障害の多くは未然に防げます。

グローバルハンドラで捕捉する最終防衛ラインの作り方

どれほど注意深くコードを書いても、すべての例外を個別に捕捉することは現実的ではありません。
そこで必要になるのが、グローバルハンドラという最終防衛ラインです。
Node.jsではprocess.on('unhandledRejection')とprocess.on('uncaughtException')、ブラウザではwindow.addEventListener('unhandledrejection')とwindow.addEventListener('error')を登録します。

process.on('unhandledRejection', (reason, promise) => {
  logger.error({ event: 'unhandled_rejection', reason });
  // 必要に応じてプロセスを安全に終了させる
});

グローバルハンドラを設置する際の設計方針は、以下の通りです。

項目 方針
役割 個別に捕捉できなかった例外の記録
通知 アラート連携し、オンコール対応の起点とする
復帰 状態が不定になるため、原則として再起動する
重複回避 個別のtry-catchと役割を分離する

重要なのは、グローバルハンドラを「何でも捕捉してくれる便利な仕組み」と捉えないことです。
あくまで最後の砦であり、ここに到達した時点でアプリケーションの状態は信頼できない可能性があります。
したがって、ログを確実に記録したうえで、安全にプロセスを終了させ、オーケストレーションツールに再起動を委ねるのが定石です。
個別の例外処理とグローバルハンドラを正しく組み合わせることが、非同期処理における信頼性の基盤となるのです。

開発時と本番時で切り替えるログ設計のベストプラクティス

開発環境と本番環境でログ出力設定が切り替わる構成図のイメージ

ログ設計において最も基本的な原則は、開発環境と本番環境で求められる要件が異なるという認識です。
開発時には詳細な情報が欲しく、本番時にはノイズを減らしつつ必要な情報を確実に残したい。
この相反する要求を一つのコードベースで満たすには、環境に応じた切り替えの仕組みが不可欠です。
ここでは、その具体的な実装方法と運用上の注意点を整理します。

開発環境では、変数の値や処理の流れを細かく追いたい場面が多いでしょう。
一方、本番環境では、パフォーマンスへの影響を最小化しつつ、障害対応に必要な情報だけを記録する必要があります。
すべてのログを常に出力する設計では、開発時の利便性は得られても、本番ではコストとノイズが増大します。
逆に本番向けに絞りすぎると、開発効率が落ちます。
したがって、環境変数を起点としてログレベルや出力先を動的に変更するアーキテクチャが合理的です。

環境変数とロガーライブラリを組み合わせた実装例

JavaScriptのエコシステムには、pino、winston、bunyanといった成熟したロガーライブラリが存在します。
これらを環境変数と組み合わせることで、コードを変更せずに挙動を切り替えられます。
以下はpinoを使った最小限の例です。

import pino from 'pino';

const logger = pino({
  level: process.env.LOG_LEVEL || 'info',
  transport: process.env.NODE_ENV === 'development'
    ? { target: 'pino-pretty' }
    : undefined,
});

この構成では、LOG_LEVEL環境変数で出力レベルを制御し、開発時のみpino-prettyで人間が読みやすい形式に整形します。
本番ではJSON形式のまま出力し、ログ収集基盤に転送します。
設計上のポイントは以下の通りです。

  • ログレベルは環境変数で外部から制御し、コードにハードコードしない
  • 開発時は整形、本番時は構造化という出力形式の切り替えを行う
  • 本番ではdebugを無効化し、info以上のみを出力する
  • ロガーはシングルトンとして生成し、各モジュールで共有する

環境変数の管理には.envファイルとdotenvを併用するのが一般的ですが、本番環境ではシークレット管理サービスから注入する方が安全です。
また、ログレベルを動的に変更する機能を備えたライブラリを選べば、再起動なしで詳細ログを一時的に有効化できます。
これは障害調査時に非常に有効です。

ログローテーションと保持期間の設計ポイント

ログは放っておくと際限なく蓄積されます。
ディスク容量を圧迫し、やがてアプリケーションの動作を妨げる要因となるため、ローテーションと保持期間の設計が欠かせません。
ローテーションとは、一定の条件でログファイルを分割し、古いものをアーカイブまたは削除する仕組みです。
条件としては、日付、ファイルサイズ、行数などが用いられます。

方式 利点 注意点
日次ローテーション 期間指定の検索が容易 アクセス量が少ないとファイルが増える
サイズローテーション ディスク使用量を予測しやすい 日付との対応が曖昧になる
外部転送 ローカルディスクを圧迫しない 転送コストと遅延が発生する

保持期間は、法的要件やコスト、調査の必要性を総合して決定します。
一般的には、errorレベルは長期保存、infoレベルは短期保存、debugレベルは保存しない、という階層的な方針が合理的です。
ローテーションの実装は、Node.jsであればlogrotateなどの外部ツールに委ねるか、winstonのDailyRotateFileのようなプラグインを利用します。
コンテナ環境では、標準出力に出すだけにして、ホスト側やログ収集基盤でローテーションを行うのが望ましいです。
アプリケーションの責務とインフラの責務を分離することが、運用の安定性につながります。
次の章では、こうしたログを活用するための可観測性の考え方を見ていきます。

可観測性を高めるログ基盤|APMやモニタリングツールとの連携

APMツールのダッシュボードにログとメトリクスが統合表示されるイメージ

ログ、メトリクス、トレースという三本柱を組み合わせてシステムの内部状態を外部から推測できるようにする考え方を、可観測性(Observability)と呼びます。
ログを単独で運用するだけでは、障害の全体像を把握するには限界があります。
APM(Application Performance Monitoring)やモニタリングツールと連携させることで、はじめてログは真価を発揮します。
ここでは、その連携の意義と実践的な導入方法を整理します。

ログは「何が起きたか」を時系列で記録しますが、それ単体では「なぜ遅いのか」「どこがボトルネックか」を判断しづらいことがあります。
メトリクスは数値の推移を、トレースはリクエストの経路を可視化します。
これらを相関IDで結びつければ、あるエラーログから同じリクエストの処理時間や経路をたどれるようになります。
障害対応の初動で「どのサービスで何が起きたか」を即座に把握できるかどうかは、復旧時間に直結します。

  • ログは事象の記録、メトリクスは傾向、トレースは経路を担う
  • 相関IDで三つを連結し、横断的な調査を可能にする
  • アラートはメトリクスで発火し、ログで原因を特定する流れが定石
  • ダッシュボードには主要な指標とエラー率を並べて表示する

これらの要素を個別に導入するのではなく、最初から連携を前提として設計することが重要です。
後から相関IDを導入しようとすると、既存のログ出力を全面的に見直す必要が生じます。

SentryやDatadogを使ったエラートラッキングの導入

エラートラッキングツールの代表格がSentryとDatadogです。
いずれも例外を収集し、発生頻度や影響範囲を可視化する機能を備えています。
Sentryはエラーに特化しており、スタックトレースの解析やリリース単位の回帰検知に強みがあります。
Datadogはログ、メトリクス、トレースを統合的に扱えるため、すでにAPMを導入している組織に向いています。

導入の第一歩は、SDKをアプリケーションに組み込み、初期化することです。
以下はSentryの初期化例です。

import * as Sentry from '@sentry/node';

Sentry.init({
  dsn: process.env.SENTRY_DSN,
  environment: process.env.NODE_ENV,
  tracesSampleRate: 0.1,
});

tracesSampleRateはパフォーマンスデータのサンプリング率です。
本番環境では全件送信するとコストが膨らむため、0.1前後から始めて調整するのが現実的です。
エラー送信時には、前述のカスタムエラークラスやコンテキスト情報をSentry.setContextで付与すると、調査が格段に楽になります。

導入時の注意点は以下の通りです。

  • DSNは環境変数で管理し、ソースコードに埋め込まない
  • 個人情報や認証情報は送信前にマスキングする
  • エラーの重複排除設定を行い、アラート疲れを防ぐ
  • リリースバージョンを付与し、どのデプロイで発生したか追跡する

ログ基盤とエラートラッキングを併用すれば、「メトリクスで異常検知、ログで事象確認、Sentryでスタックトレースと影響範囲の特定」という一連の流れが確立します。
可観測性は、単一のツールで達成するものではなく、役割の異なる複数の仕組みを組み合わせて構築するものなのです。
次の章では、ここまでの内容をチェックリストとして整理します。

ログ設計チェックリスト|今日から見直すべき7つの項目

ログ設計のチェックリストを確認しながらコードレビューする開発者のイメージ

ここまで、console.logの放置がもたらすリスク、ログレベルの責務分離、例外処理のアンチパターン、非同期処理の落とし穴、環境ごとの切り替え、そして可観測性の確保について論じてきました。
個々の要素は理解できても、実際のプロジェクトで「では何から手を付ければよいのか」と迷う方は多いでしょう。
そこでこの章では、これまでの内容を実務で活用できるよう、7つのチェック項目として整理します。
いずれも今日から見直せる具体的な観点です。

1. console.logが本番ビルドに残っていないか

最初に確認すべきは、ビルド成果物にconsole.logが含まれていないかどうかです。
ソースコードから目視で探すのではなく、ビルドツールの設定で自動的に除去する仕組みを導入してください。
esbuildのdropオプションやTerserのdrop_consoleを活用すれば、ヒューマンエラーに依存せずに済みます。
ただし、console.errorやconsole.warnまで削除すると障害調査が困難になるため、レベルに応じた取捨選択が必要です。
CIパイプラインにチェックを組み込み、本番ビルドでのみ適用する構成が望ましいです。

2. ログレベルが責務ごとに分離されているか

debug、info、warn、errorという4つのレベルが、それぞれ誰に向けたメッセージなのかを定義できているかを確認します。
開発者向けの詳細情報と、運用担当者向けの正常系イベント、監視システム向けの警告、オンコール対応者向けの異常が混在していないでしょうか。
レベルごとに出力先を分け、本番環境ではdebugを無効化する設定が徹底されているかを点検してください。
ログレベルは単なるラベルではなく、運用フローと結びついた契約です。

3. ログが構造化されているか

文字列連結によるログ出力は、後から検索や集計を行う際に大きな障害となります。
JSON形式で出力し、フィールド単位で検索できる状態になっているかを確認します。
フィールド名の命名規則がチーム内で統一されているか、タイムスタンプがISO 8601形式で揃っているか、相関IDが付与されているかも重要な観点です。
構造化されていれば、ログ収集基盤での分析が容易になり、障害対応の初動が格段に速くなります。

4. 例外が握りつぶされていないか

catch節でconsole.log(error)とだけ書いて処理を続行していないかを確認します。
例外を捕捉したら、その場で対処できない限りは再スローするのが原則です。
再スロー時にはcauseプロパティを活用し、元の例外を保持したままコンテキストを付与してください。
呼び出し元に異常が伝播しない設計は、二次障害を引き起こす温床となります。

5. カスタムエラークラスで型管理されているか

バリデーションエラー、認証エラー、外部サービスエラーといった分類ごとに、カスタムエラークラスが定義されているかを確認します。
instanceofによる分岐が可能になれば、エラーの種類に応じた処理を明瞭に記述できます。
ただし、クラスを増やしすぎると管理コストが上がるため、呼び出し元が異なる対処を必要とするかどうかを分類の基準とするのが現実的です。

6. 非同期処理の例外が適切に処理されているか

async-awaitにおけるawaitの付け忘れが、unhandledRejectionの主要因となります。
Promise.allとPromise.allSettledの使い分けが適切か、イベントリスナー内の非同期処理が見落とされていないかを点検してください。
加えて、グローバルハンドラを最終防衛ラインとして設置し、個別に捕捉できなかった例外を確実に記録する仕組みが必要です。
グローバルハンドラに到達した時点で状態は不定となるため、ログを残して安全に再起動する方針が定石です。

7. 環境ごとの切り替えと可観測性が確保されているか

開発時と本番時でログレベルや出力形式が適切に切り替わるかを確認します。
環境変数で制御し、コードにハードコードしないことが原則です。
さらに、ログ単独ではなく、メトリクスやトレースと連携することで可観測性が高まります。
SentryやDatadogといったツールを導入し、エラーの発生頻度や影響範囲を可視化できているでしょうか。

項目 確認の観点
ビルド console.logが自動除去されているか
レベル 責務ごとに分離されているか
形式 構造化され検索可能か
例外 握りつぶさず再スローしているか
可観測性 メトリクスとトレースが連携しているか

以上の7項目は、いずれも独立して実施できます。
すべてを一度に導入する必要はありません。
まずは自プロジェクトで最もリスクの高い項目から着手し、段階的に改善を進めてください。
ログ設計は一度構築すれば終わりではなく、運用しながら継続的に見直すものなのです。

console.logの放置は危険?JavaScriptログ設計と例外処理のまとめ

整理されたログ設計と堅牢な例外処理で安定稼働するWebアプリのイメージ

本記事では、JavaScriptにおけるログ設計と例外処理のあり方を、アンチパターンの指摘から始めて段階的に論じてきました。
ここで改めて、全体を貫く原則を整理します。
ログは「とりあえず出すもの」ではなく、運用を支える設計対象です。
この一点を理解しているかどうかが、障害対応の速さとシステムの信頼性を大きく左右します。

まず確認したのは、console.logの放置がもたらす具体的なリスクでした。
パフォーマンスの低下、機密情報の漏洩、ログ基盤の圧迫という三つの危険性は、いずれも本番環境で表面化します。
開発時に便利だった記述が、本番では害になるという構造を理解し、ビルドツールによる自動除去の仕組みを導入することが第一歩となります。
目視による削除は、いずれ破綻します。
ヒューマンエラーに依存しない仕組みづくりが重要です。

次に取り上げたのが、ログレベルの責務分離でした。
debug、info、warn、errorという4つのレベルは、単なる重要度の違いではなく、読み手と出力先、保持期間までを含めた契約です。
レベルごとの役割を定義し、本番環境ではdebugを無効化する。
この基本を守るだけで、本当に見るべき情報が埋もれる事態を避けられます。
加えて、構造化ログを導入すれば、フィールド単位の検索と集計が可能になり、障害調査の初動が格段に速くなります。

例外処理については、catch節でconsole.log(error)とだけ書くアンチパターンを取り上げました。
エラーを握りつぶすと、上位レイヤーは処理が成功したと誤認し、二次障害を引き起こします。
捕捉した例外は、その場で対処できない限り再スローする。
その際にはcauseプロパティを活用し、元の例外を保持したままコンテキストを付与する。
さらに、カスタムエラークラスで例外を型として管理すれば、エラーの種類に応じた処理を明瞭に記述できます。

非同期処理には、同期処理とは異なる落とし穴があります。
awaitの付け忘れはunhandledRejectionの主要因となり、Node.jsではプロセスの異常終了を招きます。
Promise.allとPromise.allSettledの使い分けを理解し、グローバルハンドラを最終防衛ラインとして設置する。
この二段構えの設計が、非同期処理における信頼性の基盤となります。
グローバルハンドラに到達した時点で状態は不定となるため、ログを確実に記録したうえで安全に再起動する方針が現実的です。

環境ごとの切り替えも欠かせません。
開発時は詳細に、本番時は必要最小限に。
この原則を環境変数とロガーライブラリの組み合わせで実装します。
ログローテーションと保持期間の設計では、法的要件とコスト、調査の必要性を総合して判断してください。
そして、ログ単独ではなく、メトリクスやトレースと連携することで可観測性が高まります。
SentryやDatadogといったツールを導入し、エラーの発生頻度や影響範囲を可視化できれば、障害対応は組織的な営みとして機能します。

最後に提示した7つのチェック項目は、いずれも今日から着手できるものです。
ビルドでの自動除去、レベルの責務分離、構造化、例外の再スロー、カスタムエラークラス、非同期処理のハンドリング、そして可観測性。
すべてを一度に導入する必要はありません。
最もリスクの高い項目から段階的に改善を進めてください。

ログ設計と例外処理は、一度構築すれば終わるものではなく、運用しながら継続的に見直すものです。
あなたのプロジェクトのconsole.logは、本当に安全に管理されていますか。
そして、障害が発生したとき、原因を即座に特定できるログが残っていますか。
これらを問い続けることが、堅牢なシステムを育てる最短の道なのです。

コメント

タイトルとURLをコピーしました