UDB と OpenResty XRay による Perl コード実行全プロセスの可視化
Perl のコールスタックやメモリ割り当てログを前に、その関連性を解明できずにお困りになったご経験はございませんか。あるいは、OpenResty アプリケーションのパフォーマンス問題を調査する中で、メモリ管理に異常があることは明白でありながら、原因となっているコード箇所を特定できずにいたことはございませんか。
従来のデバッグツールには限界があり、クラッシュポイント、エラーログ、あるいは静的なメモリスナップショットといった、問題の表面的な事象しか捉えることができませんでした。それはまるで、暗闇の中で問題のほんの一部を手探りしているようなものです。
本稿では、UDB と OpenResty XRay の強力な連携が実現する、画期的なデバッグ体験についてご紹介いたします。この連携により、Perl コードにおける関数の正確な呼び出し箇所を追跡するだけでなく、その背後にある完全な実行パスとコンテキスト関係を解明し、メモリ管理の問題を徹底的に明らかにすることが可能となります。これはもはや静的解析ではなく、プログラムのタイムラインを遡る探索の旅と言えるでしょう。
UDB とは？
UDB は、Undo 社によって開発された画期的なタイムトラベルデバッガ (Time-Travel Debugger) であり、複雑なプログラムのデバッグにおいて開発者が直面する課題を解決するために特別に設計されました。Perl 開発者に対し、UDB はこれまでにないデバッグ体験を提供いたします。
- タイムトラベルデバッグ: 問題を再現するためにアプリケーションを何度も再起動する必要はもうありません。UDB を使用すると、まるでタイムマシンのようにプログラムの実行履歴を自由に行き来でき、問題が発生した瞬間を正確に特定できます。
- 問題の根本原因を正確に特定: 条件付きブレークポイントとデータウォッチポイントを活用し、問題がトリガーされた箇所へ直接ジャンプすることが可能となり、調査時間を大幅に削減できます。
- プログラム状態の深層分析: Perl の変数やメモリ状態をリアルタイムで確認・変更し、プログラム内部の動作メカニズムを深く理解することで、異常な動作を迅速に特定できます。
- Perl デバッグの強化: UDB は GDB インターフェースと完全な互換性を持ち、Perl 開発者に強力なデバッグツールチェーンを提供し、Perl アプリケーションの包括的な分析をサポートします。
OpenResty XRay との強力な連携による、比類なきデバッグ体験の創出
OpenResty XRay は、業界をリードする動的トレーシング製品として、実行中のアプリケーションを自動的に分析し、パフォーマンスのボトルネック、異常な動作、セキュリティの脆弱性を正確に特定します。UDB と OpenResty XRay を組み合わせて使用することで、以下のメリットが得られます。
- 包括的な問題診断: マクロなパフォーマンスからミクロなコールスタックまで、包括的な分析視点
- Perl アプリケーションのボトルネックを正確に特定: パフォーマンス問題を迅速に特定し解決
- 非侵入的な分析: コードを一切変更することなく、詳細なランタイム情報を取得
- 実用的な最適化提案: 実際の実行データに基づいた具体的な改善策を提案
UDB のタイムトラベルデバッグ能力と OpenResty XRay の深層分析機能を組み合わせることで、Perl 開発者は問題診断の効率を大幅に向上させることが可能です。従来は数日を要した調査作業を、数時間、場合によっては数分にまで短縮し、開発・保守コストを大幅に削減し、製品のイテレーションを加速させます。
実践：OpenResty XRay と UDB を使用した Perl アプリケーションのコードコールスタック分析
以下では、実際の事例を通して、UDB を使用して Perl アプリケーションのコールスタックを分析する方法を解説いたします。
ステップ 1：アプリケーション実行トレースの記録と記録サンプルのリプレイ
まず、UDB の Live Record ツールを使用して Perl アプリケーションの実行プロセスを記録します。
Live Record ツールを使用し、実行中の Perl アプリケーションのサンプルを記録します。 1.1 OpenResty XRay のコンソールで「ライブレコーディング」を選択します。 1.2 対象のアプリケーションとプロセスを選択し、「レコーディング開始」をクリックします。 1.3 「レコーディングファイルの生成」アイコンをクリックして、レコーディングファイルを生成します。 1.4 解析が生成された後、「レコーディング停止」をクリックして記録プロセスを終了します。 1.5 レコーディングファイルをダウンロードして分析を行います。
OpenResty XRay 上で関連ツールをコンパイルし、コンパイル後のツールをローカルにダウンロードします。
UDB ツールを使用して記録サンプルをロードし、デバッグ環境を設定します。
udb --sessions=no -ex "set pagination off" -ex "set python print-stack full" perl.rec
ステップ 2：記録サンプルの分析
本稿では、Perl のメモリ割り当ての分析を例として、udb を用いて Perl の実行コールスタックを調査する方法についてご説明します。
malloc 関数にブレークポイントを設定します。
0% 45,793> b malloc
Breakpoint 1 at 0x7ffff7d39350 (19 locations)
0% 45,793> c
Continuing.
Breakpoint 2.1, 0x00007ffff7d39350 in malloc () from /tmp/undodb.589172.1748251515.02232.13d6176da97764fb/debuggee-1-2qlyi70u/symbol-files/lib64/libc.so.6
ステップ 3：低レベル C 言語コールスタックの分析
btコマンドを使用して、現在の C 言語レイヤーのコールスタックを確認します：
12% 792,793> bt
#0 0x00007ffff7d39350 in malloc () from /tmp/undodb.645183.1748253655.3532953.516ae1d6b3245a9c/debuggee-1-8z7p5sbz/symbol-files/lib64/libc.so.6
#1 0x000000000049af33 in Perl_safesysmalloc (size=<optimized out>, size@entry=81) at util.c:153
#2 0x00000000004cf8a8 in Perl_sv_grow (my_perl=my_perl@entry=0x5e22a0, sv=sv@entry=0x1c37570, newlen=81, newlen@entry=80) at sv.c:1605
#3 0x00000000004beee0 in Perl_do_readline (my_perl=0x5e22a0) at pp_hot.c:1993
#4 0x00000000004b9c36 in Perl_runops_standard (my_perl=0x5e22a0) at run.c:41
#5 0x0000000000442d4b in S_run_body (oldscope=<optimized out>, my_perl=<optimized out>) at perl.c:2478
#6 perl_run (my_perl=0x5e22a0) at perl.c:2406
#7 0x000000000041c19a in main (argc=<optimized out>, argv=<optimized out>, env=<optimized out>) at perlmain.c:116
C のコールスタックからは、システムレベルの malloc 関数の呼び出しがトリガーされていることが確認できますが、これは C 言語レベルの情報のみであり、Perl のビジネスコードの完全な呼び出しパスを直接確認することはできません。
GDB に標準で備わっている bt コマンドは C 言語レベルのコールスタックしか提供しないため、Perl 言語レベルのコードを分析する上では役に立ちません。そのため、OpenResty XRay を利用して Perl コードレベルのコールスタックを分析する必要があります。
ステップ 4：Perl コードの完全なコールスタックの分析
- OpenResty XRay が提供する Perl コールスタック分析ツールをロードします。
0% 7,955> source perl-on-cpu.y.py
perl_on_cpuコマンドを使用して、完全な Perl コールスタックを取得します：
0% 48,437> perl_on_cpu
C:__libc_malloc
@/usr/local/openresty-perl/lib/site_perl/5.24.4/Net/Server/PreFork.pm:303
Net::Server::PreFork::run_parent
@/usr/local/openresty-perl/lib/site_perl/5.24.4/Starman/Server.pm:164
Starman::Server::run_parent
@/usr/local/openresty-perl/lib/site_perl/5.24.4/Net/Server/PreFork.pm:109
Net::Server::PreFork::loop
@/usr/local/openresty-perl/lib/site_perl/5.24.4/Net/Server.pm:58
Net::Server::run
@/usr/local/openresty-perl/lib/site_perl/5.24.4/Starman/Server.pm:106
Starman::Server::run
@/usr/local/openresty-perl/lib/site_perl/5.24.4/Plack/Handler/Starman.pm:25
Plack::Handler::Starman::run
@/usr/local/openresty-perl/lib/site_perl/5.24.4/Plack/Loader.pm:84
Plack::Loader::run
@/usr/local/openresty-perl/lib/site_perl/5.24.4/Plack/Runner.pm:279
Plack::Runner::run
@/usr/local/openresty-perl/bin/starman:38
main::(eval)
この完全な Perl コールスタックを通じて、PreFork.pm の 303 行目でメモリ確保が行われていることを明確にご確認いただけます。
なぜ、より多くの開発者が UDB を選択するのでしょうか？
UDB のタイムトラベルデバッグ機能は、その最も強力な特長の一つです。この機能により、記録された実行履歴を自在に遡ったり進めたりすることができ、目的の箇所を正確に特定することが可能になります。
特定のブレークポイントを追加することで、プロセスを目的の箇所で停止させることができます。例えば、その後の不正なメモリアクセスを解析したい場合、free 関数にブレークポイントを設定します。
0% 51,725> b free
Breakpoint 3 at 0x7ffff7d398c0 (41 locations)
0% 51,725> c
Continuing.
Breakpoint 3.1, 0x00007ffff7d398c0 in free () from /tmp/undodb.589172.1748251515.02232.13d6176da97764fb/debuggee-1-2qlyi70u/symbol-files/lib64/libc.so.6
0% 52,039> perl_on_cpu
C:__libc_free
@/usr/local/openresty-perl/lib/site_perl/5.24.4/Net/Server/PreFork.pm:309
Net::Server::PreFork::run_parent
@/usr/local/openresty-perl/lib/site_perl/5.24.4/Starman/Server.pm:164
Starman::Server::run_parent
@/usr/local/openresty-perl/lib/site_perl/5.24.4/Net/Server/PreFork.pm:109
Net::Server::PreFork::loop
@/usr/local/openresty-perl/lib/site_perl/5.24.4/Net/Server.pm:58
Net::Server::run
@/usr/local/openresty-perl/lib/site_perl/5.24.4/Starman/Server.pm:106
Starman::Server::run
@/usr/local/openresty-perl/lib/site_perl/5.24.4/Plack/Handler/Starman.pm:25
Plack::Handler::Starman::run
@/usr/local/openresty-perl/lib/site_perl/5.24.4/Plack/Loader.pm:84
Plack::Loader::run
@/usr/local/openresty-perl/lib/site_perl/5.24.4/Plack/Runner.pm:279
Plack::Runner::run
@/usr/local/openresty-perl/bin/starman:38
main::(eval)
同一の Perl プログラムにおける malloc と free のコールスタックが、どれほど類似しているか、お考えになったことはございますでしょうか。今回、私どもは UDB を通じて、ある興味深い現象を捉えることに成功しました。それは、free のブレークポイントと malloc のブレークポイントにおける Perl コードのコールスタックがほぼ同一であり、唯一の違いが最後のコード行にのみ存在するという事実です。
このようなコード行レベルまで掘り下げた精密なコールスタック分析により、プログラムの実行ロジックに対して、これまでにないレベルの明確な知見を得ることが可能となります。複雑なメモリ管理問題に直面した際に、個々のメモリ確保と解放の完全なコンテキストを、これほど正確に可視化できる状況をご想像ください。これこそが、タイムトラベルデバッグがもたらす革命です。
従来のデバッグ手法では、我々は常に「群盲象を評す」ような状況にありました。
- GDB のコアダンプ (Core Dump) では、プログラムがクラッシュした瞬間の「スナップショット」しか確認できません。
- ログ分析では、散在する「手がかりの断片」を繋ぎ合わせるしかありません。
- 問題の再現には、アプリケーションの再起動を繰り返す必要があり、極めて非効率的です。
しかし、OpenResty XRay と UDB を組み合わせることで、この状況は一変します。
- 実行履歴の完全な再生：元のプロセスが既に終了していても、プログラムの完全な実行履歴を自由に遡って調査できます。
- 任意の時点における正確な状態確認：特定の時点におけるプログラムの状態を、いつでも即座に停止させ、詳細に分析することが可能です。
- 動的なコンテキストの復元：静的なスナップショットではなく、実行中のプロセスそのものを再現します。
まとめ
本実践を通じ、私たちは全く新しいデバッグパラダイムの到来を目の当たりにしました。この組み合わせが開発者の皆様にもたらすメリットは以下の通りです。
- 全景的な実行コンテキスト 低レベルの C 言語コールスタックを可視化するだけでなく、Perl で記述されたビジネスロジックの実行パスを各ステップに至るまで正確に追跡することが可能になります。システムコールからビジネスロジックまで、その全貌を余すところなく把握できます。
- 時間軸の自由な移動 「再起動によるデバッグ」に別れを告げましょう。プログラムの実行履歴を自由自在に行き来できるため、間欠的に発生する問題や複雑なシナリオのデバッグも、もはや悪夢ではありません。
- パフォーマンスボトルネックの正確な特定 OpenResty XRay の分析能力と組み合わせることで、メモリ割り当てパターン、ホットスポットとなっている関数、そしてパフォーマンスのボトルネックが、すべて明確に可視化されます。
- 卓越した事後分析能力 プログラムがクラッシュした場合や、プロセスが予期せず終了してしまった場合でも問題ありません。記録されたサンプルを用いることで、完全な事後分析 (ポストモーテム分析) が可能です。これは、従来のコアダンプ (Core Dump) では到底実現できなかった機能です。
お使いのアプリケーションが複雑なメモリ管理や言語間呼び出し (クロスランゲージコール) を伴う場合、従来のデバッグ手法では非常に困難な状況に直面することが少なくありません。しかし、UDB と OpenResty XRay の組み合わせは、まさにプログラムの挙動を根本から理解することを可能にする、強力なソリューションです。もし貴社でも従来のデバッグ手法の限界から脱却し、このような「神の視点」とも言えるデバッグ手法をご体験されたいとお考えでしたら、UDB と OpenResty XRay がその実現をサポートいたします。変化の速い現代の開発環境において、デバッグ作業をより洗練され、かつ効率的なものにするツールを求めていない開発者はいないでしょう。
OpenResty XRay について
OpenResty XRay は動的トレーシング製品であり、実行中のアプリケーションを自動的に分析して、パフォーマンスの問題、動作の問題、セキュリティの脆弱性を解決し、実行可能な提案を提供いたします。基盤となる実装において、OpenResty XRay は弊社の Y 言語によって駆動され、Stap+、eBPF+、GDB、ODB など、様々な環境下で複数の異なるランタイムをサポートしております。
著者について
章亦春（Zhang Yichun）は、オープンソースの OpenResty® プロジェクトの創始者であり、OpenResty Inc. の CEO および創業者です。
章亦春（GitHub ID: agentzh）は中国江蘇省生まれで、現在は米国ベイエリアに在住しております。彼は中国における初期のオープンソース技術と文化の提唱者およびリーダーの一人であり、Cloudflare、Yahoo!、Alibaba など、国際的に有名なハイテク企業に勤務した経験があります。「エッジコンピューティング」、「動的トレーシング」、「機械プログラミング」 の先駆者であり、22 年以上のプログラミング経験と 16 年以上のオープンソース経験を持っております。世界中で 4000 万以上のドメイン名を持つユーザーを抱えるオープンソースプロジェクトのリーダーとして、彼は OpenResty® オープンソースプロジェクトをベースに、米国シリコンバレーの中心部にハイテク企業 OpenResty Inc. を設立いたしました。同社の主力製品である OpenResty XRay動的トレーシング技術を利用した非侵襲的な障害分析および排除ツール）と OpenResty XRay（マイクロサービスおよび分散トラフィックに最適化された多機能
翻訳
英語版の原文と日本語訳版（本文）をご用意しております。読者の皆様による他の言語への翻訳版も歓迎いたします。全文翻訳で省略がなければ、採用を検討させていただきます。心より感謝申し上げます！
関連記事
OpenResty XRay Jul 15, 2025
OpenResty XRay Jul 14, 2025
OpenResty XRay Jul 14, 2025
OpenResty XRay Jan 26, 2024
OpenResty XRay Dec 15, 2023
