観測・診断図鑑 · 基礎から応用へ

イベントループの遅延:処理が始められない時間を測る

Node.jsのmonitorEventLoopDelayで単位と観測窓をそろえ、要求遅延・CPU使用率との違いを確認します。

この記事をロゲイアに質問する確認問題3問に進むこれまでの誤答を復習する

更新日

この記事の目次
  1. 要求の遅延とは測る境界が違う
  2. ヒストグラムを有限の窓で取る
  3. 小さな停止を手元で再現する
  4. 原因は別の観測で絞る
  5. 窓ごとのパーセンタイルを足さない
  6. 変更後も同じ仕事で比べる
  7. この記事をロゲイアに質問する理解を確かめる

要求の遅延とは測る境界が違う

イベントループの遅延は、ループ上の処理が期待した時点で実行へ進めない状況を調べる指標です。要求が返るまでの全時間とは異なり、ネットワークや外部DBの待ちをそのまま分解して示すものではありません。Node.jsで同期的な重い処理が続くと、同じループ上のタイマーや他の仕事が遅れる場合があります。一方、要求が遅くても、単に外部の応答を非同期で待つ間はループが動ける場合があります。最初に何の遅れを測っているかを定め、要求の応答時間と同じ数字として扱わないようにします。

ヒストグラムを有限の窓で取る

perf_hooksのmonitorEventLoopDelayは、所定の分解能で遅延を観察するヒストグラムを作ります。enableして観測を始め、必要な区間の後でdisableします。meanやmax、percentileなどが表す遅延はナノ秒なので、ミリ秒へ直すなら100万で割ります。分解能のオプションの単位とは混同しません。開始直後に標本が十分あるとは限らないため、観測期間と標本数も確認します。有限の区間で集めた結果を報告し、いつからいつまでの値かが分からないピークを、その場の要求の原因へ直接結び付けません。

小さな停止を手元で再現する

道具の意味を確かめるには、検証用の別プロセスで計測を開始し、短い同期処理を意図的に挟んでみます。タイマーを使い、先に通常の標本を集めてから、一定時間だけループを占有する構成にします。ここで作る停止は診断のための人工的な負荷で、運用中のサービスへそのまま追加しません。出力の具体的な値は、OSのスケジューリングや周囲の負荷にも依存します。示した時間どおりの遅延が必ず測れるという試験ではなく、単位と観測窓、同期処理の影響を確かめる小さな実験として扱います。

Node.js 22
const { monitorEventLoopDelay, performance } = require('node:perf_hooks');
const histogram = monitorEventLoopDelay({ resolution: 10 });
histogram.enable();
setTimeout(() => {
  const end = performance.now() + 40;
  while (performance.now() < end) { /* bounded local blocking example */ }
}, 50);
setTimeout(() => {
  histogram.disable();
  const result = { mean_ms: histogram.mean / 1e6,
    p99_ms: histogram.percentile(99) / 1e6, max_ms: histogram.max / 1e6 };
  if (!Number.isFinite(result.mean_ms)) throw new Error('No usable samples');
  console.log(result);
}, 250);

原因は別の観測で絞る

遅延が大きくても、それだけで特定の関数が原因とは分かりません。長い同期JavaScript、GC、ネイティブ処理、CPUの実行機会不足などを候補として、同じ時刻のCPUプロファイルやGCの情報と照合します。イベントループの利用率も、プロセス全体のCPU使用率と同じ指標ではありません。ワーカースレッドや別プロセスを使う構成では、どのループを観察したかも重要です。一つのループの改善が全体の要求を速くしたとは限らないため、要求の分布、待ち行列、完了率も合わせて見ます。単一の数値で原因を確定しないようにします。

窓ごとのパーセンタイルを足さない

一分ごとのp99を単純平均して、一時間全体のp99とは呼べません。各区間の標本数や分布が違うためです。集計に必要な情報を保持するか、同じ定義のヒストグラムを適切に統合する設計が必要になります。resetを使う場合には、その後の値が新しい窓の結果になることを記録します。サンプル数の少ない区間の極端な値も、安定した尾部推定とは限りません。また、このヒストグラムのp99はイベントループ遅延の標本についての量であり、要求の応答時間のp99ではありません。対象を明記してダッシュボードや通知へ使います。

変更後も同じ仕事で比べる

長い同期処理を分割する、適切なワーカーへ移す、入力サイズを制限するなどの対処を選んだら、同じ入力と負荷で再測定します。分割で応答性が改善しても、総処理量や転送費用が増える場合があります。ワーカーへ移すなら、データのコピーとキューの上限、キャンセル時の後始末も考えます。観測期間、分解能、単位を変えた場合は比較の前提も変わります。遅延が下がったこと、要求が成功したこと、仕事の結果が同じであることを別々に確かめます。ヒストグラムを無効化して数字が消えたことを、遅延の改善とは扱いません。

読了と問題の結果を、言語ごとにこのブラウザへ保存します。

コースの順番に沿って学ぶ

CS基礎を固める · STEP 12

学習コースから次を選ぶ