ここでは、RPM パッケージリポジトリを使用して CentOS 上に OpenResty XRay の Agent サービスをインストールする手順を段階的に説明します。これにより、システム内のさまざまなタイプのアプリケーションやコンテナを自動的に分析および診断することができます。

コンソールにログイン

アカウントにログインします。

アカウント名を入力してください。

パスワードを入力してください。

「Sign in」をクリックします。

「Go to console」をクリックしてください。

Agent インストールのガイドページに移動します。

RPM パッケージを使用した Agent のインストール

RPM パッケージを使用してインストールする方法をご紹介します。

まず、オペレーティングシステムを選択します。この例では CentOS を選択しています。

CentOS のバージョンを選択します。

「Network installation」を選択し、ネットワーク経由で直接インストールします。

curl コマンドが利用できない場合は、このコマンドでインストールできます。

また、このコマンドで ca-certificates パッケージを最新版にアップグレードすることもできます。

これが Agent のインストールコマンドです。

アイコンをクリックしてこのコマンドをコピーします。

ターミナルで、先ほどコピーした内容を貼り付けます。

このコマンドを実行して OpenResty XRay の Agent をインストールします。

ネットワークの遅延によっては、時間がかかる場合があります。しばらくお待ちください。

Agent のインストールコマンドが完了しました。

Agent の状態とログの確認

Web コンソールに戻ります。このコマンドで Agent サービスの実行状態を確認できます。

クリックしてコピーします。

貼り付けてこのコマンドを実行し、Agent サービスの状態を確認します。

Agent が正常に動作していることが確認できます。

このコマンドでエラーログを確認することもできます。

コピーします。

貼り付けてこのコマンドを実行し、エラーログを確認します。

素晴らしい！エラーメッセージは一切ありません！

アプリケーションの設定と検出

ウィザードページに戻ります。

このオプションでは、現在のマシンが本番環境にあるかどうかを設定できます。本番環境の場合、システムは分析時のパフォーマンスオーバーヘッドを最小限に抑えます。ただし、結果を得るのに時間がかかる場合があります。

次に、対象システムで実行中のアプリケーションとコンテナを自動検出します。

これらは自動検出された対象アプリケーションです。

検出されなかった新しいアプリケーションを追加する場合は、カスタムアプリケーションを設定できます。

ここで新しいアプリケーションの名前を入力できます。

アプリケーションのタイプを選択します。

このプロセスリストから新しいアプリケーションに対応するプロセスを選択できます。

アナライザーの開始と分析結果の確認

ここをクリックしてアナライザーを開始します。

アナライザーが開始されました。

「Traffic and Load」をクリックします。

システムは対象マシンに十分なトラフィックと負荷があることを検出しました。対象アプリケーションに負荷とトラフィックがある場合にのみ、システムは意味のある分析を行うことができます。

ダッシュボードページに移動します。

「Insights」ページに移動します。

最初の分析レポートが生成されるまで待ちます。最初の Agent がインストールを完了したばかりだからです。

生成のリアルタイム進捗を確認できます。

「Dashboard」ページに切り替えます。

ここでアプリケーションに関連する豊富な分析チャートを見ることができます。

さまざまなタイプの Go アプリケーションのフレームグラフを見ることができます。

OpenResty アプリケーションのフレームグラフです。

Python アプリケーションのフレームグラフです。

別の Agent のインストール

別の Agent をインストールする場合は、ここをクリックするだけです。

ここで使用する手順は、先ほど CentOS にインストールした時と同じです。

他のオペレーティングシステムにインストールする場合や、コンテナインストール方法に変更する場合は、ここをクリックします。

先ほど見たウィザードページに戻り、ここで異なるインストール方法やオペレーティングシステムを選択できます。

关于 OpenResty XRay

OpenResty XRay 是一个动态追踪产品，它可以自动分析运行中的应用程序，以解决性能问题、行为问题和安全漏洞，并提供可行的建议。在底层实现上，OpenResty XRay 由我们的 Y 语言驱动，可以在不同环境下支持多种不同的运行时，如 Stap+、eBPF+、GDB 和 ODB。

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 以外にも、章亦春は Linux カーネル、Nginx、LuaJIT、GDB、SystemTap、LLVM、Perl など、複数のオープンソースプロジェクトに累計 100 万行以上のコードを寄与し、60 以上のオープンソースソフトウェアライブラリを執筆しております。

翻訳

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