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

コンソールにログイン

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

Screenshot

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

Screenshot

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

Screenshot

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

Screenshot

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

Screenshot

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

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

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

Screenshot

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

Screenshot

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

Screenshot

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

Screenshot

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

スクリーンショット

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

スクリーンショット

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

スクリーンショット

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

Screenshot

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

Screenshot

ターミナルで、先ほどコピーした内容を貼り付けます。このコマンドを実行して OpenResty XRay の Agent をインストールします。

スクリーンショット

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

スクリーンショット

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

Screenshot

Agent の状態とログの確認

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

スクリーンショット

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

スクリーンショット

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

スクリーンショット

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

スクリーンショット

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

スクリーンショット

コピーします。

Screenshot

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

スクリーンショット

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

スクリーンショット

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

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

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

Screenshot

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

スクリーンショット

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

スクリーンショット

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

Screenshot

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

スクリーンショット

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

スクリーンショット

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

Screenshot

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

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

スクリーンショット

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

スクリーンショット

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

スクリーンショット

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

スクリーンショット

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

Screenshot

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

スクリーンショット

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

スクリーンショット

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

スクリーンショット

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

スクリーンショット

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

Screenshot

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

スクリーンショット

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

スクリーンショット

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

スクリーンショット

別の Agent のインストール

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

スクリーンショット

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

スクリーンショット

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

スクリーンショット

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

Screenshot

关于 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、LuaJITGDBSystemTapLLVM、Perl など、複数のオープンソースプロジェクトに累計 100 万行以上のコードを寄与し、60 以上のオープンソースソフトウェアライブラリを執筆しております。

翻訳

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