はい——OpenResty XRay は Android と iOS の公式モバイルアプリを提供しており、実行中のサーバーアプリケーションをスマートフォンから直接監視・トラブルシューティングできます。アプリでは、自動生成された分析レポートの閲覧、問題のコードパスを追跡するインタラクティブなフレームグラフの表示、リアルタイムパフォーマンスダッシュボードの監視、そしてオンデマンドの Guided Analysis(例:High CPU)の実行が、いつでもどこでも可能です。

このチュートリアルでは、Android デバイスで OpenResty XRay アプリをダウンロード、インストール、使用する方法を段階的に説明します。iOS 版の操作と機能は Android 版と非常に似ています。

OpenResty XRay Android 版のダウンロードとインストール

スマートフォンで OpenResty.com 公式ウェブサイトのモバイルアプリページにアクセスして、このアプリをダウンロードできます。

OpenResty.com 公式サイトの OpenResty XRay モバイルアプリダウンロードページ

このページで OpenResty XRay の iOS 版と Android 版のダウンロードリンクを見つけることができます。

OpenResty XRay の iOS 版と Android 版のダウンロードリンク

本文章では Android 版のダウンロードと使用方法を紹介します。Google Play ストアからこのアプリをダウンロードできます。

Google Play ストアの OpenResty XRay Android アプリ

または、この「Download APK」ボタンをタップして Android 版インストールパッケージをダウンロードすることもできます。

OpenResty XRay Android 版インストールパッケージをダウンロードする Download APK ボタン

ダウンロードが完了したらインストールパッケージを開き、

ダウンロードした OpenResty XRay Android インストールパッケージを開く

インストールボタンをクリックします。

OpenResty XRay Android アプリのインストール

インストールが成功しました。

OpenResty XRay Android アプリのインストール成功

OpenResty XRay アプリケーションを開きます。

Android デバイスで OpenResty XRay アプリを起動

OpenResty XRay へのログイン

このアプリを初めて使用する際は、まずアカウントにログインしてください。

OpenResty XRay モバイルアプリのログイン画面

メールアドレスとパスワードを入力してログインするか、

メールアドレスとパスワードで OpenResty XRay にログイン

Google などのサードパーティサービスを使用することもできます。

OpenResty XRay アプリの Google などサードパーティログインオプション

本文章ではユーザー名とパスワードでログインする方法を採用します。

メールアドレスを入力し、パスワードを入力します。

OpenResty XRay モバイルアプリでメールアドレスとパスワードを入力

「Sign In」ボタンをクリックします。

OpenResty XRay モバイルログイン画面の Sign In ボタン

全自動分析レポート

ログインに成功すると、OpenResty XRay のコンソール画面に入ります。これは「Insights」ページで、すべてのサーバー上のすべてのアプリケーションに対してシステムが生成した分析レポートを確認できます。

自動分析レポートを表示する OpenResty XRay Insights ページ

ここでは日次と週次の周期で自動生成されたレポートを見つけることができます。

Insights ページの日次・週次レポートオプション

システムはデフォルトで当日の日報を表示します。

OpenResty XRay アプリの当日の日報

他の日付のレポートを表示することもできます。

他の日付の分析レポートを選択

このボタンをクリックすると、レポートで言及されているすべてのアプリケーションを見ることができます。

分析レポートに含まれるすべてのアプリケーション一覧

OpenResty XRay が様々なタイプのアプリケーションを分析する能力を持っています。

様々なタイプのアプリケーションを分析する OpenResty XRay

「OpenResty」を選択します。

レポートで OpenResty アプリケーションを選択

レポートの概要では、問題がタイプ別に分類されており、関心のある問題カテゴリーを素早く見つけることができます。後ろの数字は、そのカテゴリー内の問題数を示しています。

タイプ別に問題を分類する分析レポートの概要

カテゴリーのタイトルをタップすると、問題リストを展開または折りたたむことができます。

分析レポートの問題カテゴリーを展開

ここでは「Errors and Exceptions」に関連する 10 個の問題がリストアップされています。

分析レポートの Errors and Exceptions カテゴリーの問題リスト

問題の一つをクリックすると、詳細情報を確認できます。

特定の問題の詳細情報を開く

問題詳細ページにはフレームグラフのプレビューがあり、コードパスを追跡することで問題の根本原因を迅速に特定するのに役立ちます。

コードパスを追跡するフレームグラフプレビュー付きの問題詳細ページ

フレームグラフのプレビューをクリックすると、拡大されて表示できます。

問題のコードパスを追跡する拡大フレームグラフ

「Back」ボタンをクリックして問題詳細ページに戻ります。

フレームグラフから問題詳細ページに戻る

ここでは AI が提供する問題に関する詳細な説明と提案も確認できます。

AI が生成した問題の説明と提案

このボタンをクリックすると、さらに多くの分析結果を確認できます。

さらに多くの分析結果を確認するボタン

ここには現在の分析タスクの詳細情報が表示されています。例えば、どのアナライザーが使用されたか、アプリケーションの詳細情報などです。

使用したアナライザーとアプリケーション情報を含む分析の完全な詳細

ここでフレームグラフや他のチャートも見つけることができます。

完全な分析レポート内のフレームグラフと他のチャート

これが OpenResty XRay が提供する「Insights」ページです。アプリケーションの様々な問題を素早く発見し、分析し、根本原因を特定するのに役立ちます。

ダッシュボードページでのパフォーマンスチャートデータの確認

「Dashboard」ページにアクセスして、現在の最新かつ最も包括的なパフォーマンスチャートデータを確認することもできます。

リアルタイムパフォーマンスチャートを表示する OpenResty XRay Dashboard ページ

ページの左上には現在分析中のマシンが表示されています。

Dashboard ページで現在選択されているマシン

現在表示されているマシンが正しくない場合は、開いたリストから正しいものを選択できます。

Dashboard で分析するマシンをリストから選択

このページでシステム指標を確認できます。ここにはシステムの様々なパフォーマンスデータが表示されています。

サーバーのパフォーマンスデータを表示するシステム指標

例えば、ここをクリックすると CPU 使用率の詳細ページに移動します。

CPU 使用率の詳細ページを開く

このページでは、CPU 使用率に関連する様々なチャートをリアルタイムで確認できます。

OpenResty XRay アプリのリアルタイム CPU 使用率チャート

詳細ページの右上で、他のタイプのアプリケーション指標に簡単に切り替えることができます。

詳細ページでアプリケーション指標のタイプを切り替え

例えば、メモリデータページに切り替えることができます。

OpenResty XRay アプリのメモリデータページ

戻るボタンをクリックして、ダッシュボードのメインページに戻ります。

Dashboard のメインページに戻る

Dashboard ページのアプリケーション指標エリアでは、各アプリケーションのリアルタイムパフォーマンスデータを確認できます。

アプリケーション指標エリアの各アプリのリアルタイムパフォーマンスデータ

この Go アプリケーションをクリックして、その詳細ページに移動します。

Go アプリケーションの詳細ページを開く

ここでは、そのアプリケーションの基本情報と様々なパフォーマンス指標を確認できます。

Go アプリケーションの詳細と各次元のパフォーマンス指標

ここをクリックすると、そのアプリケーションの CPU 指標詳細ページに移動します。

Go アプリケーションの CPU 指標詳細ページを開く

アプリケーションの CPU 使用率に関連する様々なチャートを確認できます。

Go アプリケーションの CPU 使用率チャート

詳細ページの右上で、他のタイプのアプリケーション指標に簡単に切り替えることができます。

他のタイプのアプリケーション指標に切り替え

これで、メモリ指標ページに切り替わりました。

Go アプリケーションのメモリ指標ページ

Guided Analysis 機能

OpenResty XRay は「Guided Analysis」機能を提供しています。

OpenResty XRay の Guided Analysis 機能

ここでは、システムが分析できる異なる問題タイプを確認できます。

ガイド付き診断が可能な問題タイプ

「High CPU Usage」を選択します。

Guided Analysis で High CPU Usage を選択

Go アプリケーションを選択します。

Guided Analysis 用に Go アプリケーションを選択

アプリケーションのタイプが正しいことを確認します。

Guided Analysis のアプリケーションタイプを確認

言語レベルは「Go」のみです。

分析の言語レベルを Go に設定

最大分析時間を設定することもできます。ここではデフォルトの 300 秒のままにします。

最大分析時間を 300 秒に設定

分析を開始します。

Guided Analysis を開始

システムは複数の分析を継続的に実行します。

現在、初回の分析を実行中です。

初回の分析を実行中の Guided Analysis

分析を停止します。

Guided Analysis を停止

自動生成された分析レポートが表示されています。

自動生成された Guided Analysis レポート

ここをクリックすると、過去に生成されたすべての Guided Analysis レポートに移動できます。

過去の Guided Analysis レポート一覧

このボタンをクリックしてレポートの詳細ページに移動します。

Guided Analysis レポートの詳細ページ

ここをクリックすると「Settings」ページに移動します。

OpenResty XRay モバイルアプリの設定ページ

ここでは選択したマシンの詳細情報を確認し、設定を行うことができます。

選択したマシンの詳細情報と設定オプション

OpenResty XRay の iOS 版は Android 版と非常に似ています。

このチュートリアルが気に入った場合は、ぜひこのブログサイト及び当社の YouTube をご登録してください。ありがとうございました!

よくある質問

サーバーアプリケーションをスマホから監視・トラブルシューティングできるモバイルアプリはありますか?

はい。OpenResty XRay は Android と iOS の公式モバイルアプリを提供しています。スマートフォンから、自動生成された分析レポートの閲覧、フレームグラフの表示、リアルタイムパフォーマンスダッシュボードの監視、そして実行中のサーバーアプリケーションに対する Guided Analysis の実行が、いつでもどこでも行えます。

OpenResty XRay モバイルアプリでフレームグラフを確認できますか?

はい。問題の詳細ページでは、問題のコードパスを追跡するフレームグラフのプレビューが表示され、タップすると拡大した全画面のフレームグラフを開けます。各問題には AI が生成した詳細な説明と提案も付いており、根本原因の特定に役立ちます。

High CPU のようなオンデマンド分析をスマホから実行できますか?

はい、Guided Analysis 機能で実行できます。問題タイプ(例:High CPU Usage)を選び、対象アプリケーションを選択し、そのタイプと言語レベルを確認し、最大分析時間を設定して開始します。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 Edge(マイクロサービスおよび分散トラフィックに最適化された多機能ゲートウェイソフトウェア)は、世界中の多くの上場企業および大企業から高い評価を得ております。OpenResty 以外にも、章亦春は Linux カーネル、Nginx、LuaJITGDBSystemTapLLVM、Perl など、複数のオープンソースプロジェクトに累計 100 万行以上のコードを寄与し、60 以上のオープンソースソフトウェアライブラリを執筆しております。

翻訳

英語版の原文と日本語訳版(本文)をご用意しております。読者の皆様による他の言語への翻訳版も歓迎いたします。全文翻訳で省略がなければ、採用を検討させていただきます。心より感謝申し上げます!