OpenResty 公式技術・製品情報

OpenResty XRay Aug 14, 2026

OpenResty XRay 更新日 Aug 14, 2026 用時 約14分

Off-CPU 分析の実践：CPU 使用率が低いのにレイテンシが高い 4 つの根本原因と特定方法

openresty-xray off-cpu tutorial

• Off-CPU 時間とは何か
• 症状：CPU 使用率が上がらないのにリクエストが滞留する
• 4 つの Off-CPU 根本原因の実例による因果チェーン
• Off-CPU 時間の定量化手法
• On-CPU + Off-CPU = ウォールクロック時間：全体像とツールエコシステム
• よくある質問

OpenResty XRay Aug 24, 2026

OpenResty XRay 更新日 Aug 24, 2026 用時 約10分

Nginx リバースプロキシの QPS が 15 分の 1 に低下：upstream keepalive の欠落と -O0 ビルドが原因だった

openresty-xray case-study lua nginx off-cpu

• Nginx リバースプロキシが 15 分の 1 に低速化、それでもエラーログはゼロ
• フレームグラフが暴いた接続ストーム：upstream keepalive の欠落
• 残り 10% の差：ベースライン比較がコンパイラを指し示す
• -O0 デバッグビルドが 10% の性能を奪っていた

OpenResty XRay Aug 24, 2026

OpenResty XRay 更新日 Aug 24, 2026 用時 約11分

300 RPS で頭打ちの Nginx Worker プロセス：原因は 75 ミリ秒のイベントループ・ブロッキング

openresty-xray case-study lua nginx off-cpu

• 負荷は高いのに仕事が進まない：worker_cpu_affinity 欠落による CPU リソース競合
• ブロッキング Lua I/O 呼び出しが Nginx イベントループを停止させた仕組み
• ファイル I/O レイテンシーの測定：1 回あたり最大 1.5 ミリ秒
• Nginx イベントループのブロッキングはどれほど深刻だったか：43,952 サンプル、最大 75 ミリ秒
• よくある質問

OpenResty XRay Aug 24, 2026

OpenResty XRay 更新日 Aug 24, 2026 用時 約8分

Perl プロセスの CPU 使用率が 13% のまま：off-CPU フレームグラフでブロッキング HTTP 呼び出しを特定

tutorial openresty-xray perl off-cpu

• 症状：リクエストが殺到しても Perl プロセスの CPU 使用率が上がらない
• OpenResty XRay の off-CPU フレームグラフでブロッキング Perl コードパスを特定
• Insights ページの自動分析とレポート
• FAQ

OpenResty XRay Aug 14, 2026

OpenResty XRay 更新日 Aug 14, 2026 用時 約7分

Go サービスの CPU 使用率が異常に低い：稼働中プロセスの off-CPU 分析でブロッキングの根本原因を特定

tutorial openresty-xray go off-cpu

• 症状：リクエストが増えても Go サービスの CPU 使用率が上がらない
• 稼働中の Go プロセスを OpenResty XRay で off-CPU 分析
• 根因：ブロッキングなシェルコマンド呼び出し
• 自動分析と日次・週次レポート

OpenResty XRay Aug 14, 2026

OpenResty XRay 更新日 Aug 14, 2026 用時 約8分

Python プロセスの CPU 使用率が 8% のまま：off-CPU 分析でブロッキング subprocess.run 呼び出しを特定

tutorial openresty-xray python off-cpu

• 症状：リクエストが殺到しても Python プロセスの CPU 使用率が上がらない
• OpenResty XRay の Guided Analysis でブロッキング Python コードパスを特定
• Insights ページの自動分析とレポート
• FAQ

OpenResty XRay Aug 14, 2026

OpenResty XRay 更新日 Aug 14, 2026 用時 約9分

Lua io.popen が Nginx イベントループをブロックする問題：スループット 150 倍改善の実例

openresty-xray nginx lua off-cpu

• 問題点：毎秒 130 リクエスト
• OpenResty XRay によるブロッキング特定
• io.popen のノンブロッキング代替
• 結果：7 倍と 150 倍
• よくある質問