第2章 サイドカーコンテナーのセットアップ
サイドカーコンテナーは、Red Hat OpenShift Web コンソールで、Red Hat build of Cryostat Operator がインストールされている Cryostat インスタンスを作成するときにセットアップできます。
さらに、Red Hat OpenShift 上の既存の Cryostat リソースを変更することで、サイドカーコンテナーをセットアップすることもできます。この操作により、Red Hat build of Cryostat Operator に、Red Hat OpenShift 上の既存の Cryostat インストールを変更するよう指示します。
前提条件
- Red Hat OpenShift Web コンソールを使用して OpenShift Container Platform にログインしている。
- Red Hat build of Cryostat Operator を Red Hat OpenShift のプロジェクトにインストールしている。Red Hat build of Cryostat Operator を使用した Red Hat OpenShift への Cryostat のインストール (Cryostat のインストール) を参照してください。
- JMX または Cryostat エージェントが有効になっている Java アプリケーションを Cryostat インスタンスと同じ namespace 内でデプロイした。
手順
- Red Hat OpenShift Web コンソールから、Operators > Installed Operators に移動します。
- インストールされている Operator のリストから、Red Hat build of Cryostat Operator インスタンスの名前をクリックします。Web コンソールで Operator details ページが開きます。
- Provided APIs セクションで、Create instance をクリックします。
- Name フィールドなど、アスタリスクでマークされている必須フィールドに入力します。
- Create Cryostat 設定ページから、Report Options セクションに移動します。
展開アイコンをクリックし、Cryostat の自動レポート分析の実装を設定するためのオプションを表示します。
図2.1 Create Cryostat 設定ページの Report Options セクション

ニーズに合わせて、次のレポートオプションのいずれかを設定します。
-
Replicas: デフォルトは
0です。この値は、メインの Cryostat コンテナーがレポート生成を処理することを示します。サイドカーコンテナーのレプリカが分析レポートを生成して処理できるように、0より大きい値を設定する必要があります。 - Resources: 各サイドカーレプリカのリソース制限を設定します。展開アイコンをクリックし、各サイドカーレプリカの設定可能な制限とリクエストオプションを表示します。オプションには、CPU cores、Memory、および Storage があります。Storage オプションは、サイドカーレポート生成との関連性が最も低いオプションです。各オプションでサポートされる単位は、Red Hat OpenShift によって設定されます。
Sub Process Max Heap Size: メインの Cryostat コンテナーにのみ適用されます。レポートの生成に使用できるメインの Cryostat コンテナーの最大メモリー量を割り当てます。
注記Sub Process Max Heap Size オプションに指定する値の型には、以下の制限が存在する場合があります。
- 値が小さいと、レポートサイズがメインの Cryostat コンテナーに割り当てられたメモリーを超える可能性があるため、レポート生成リクエストが失敗する場合があります。さらに、JVM はレポートを処理するためにガベージコレクション (GC) 操作を常に実行する必要があるため、レポートの生成がタイムアウトする場合があります。
- 値が大きいと、メインの Cryostat コンテナー内で動作する Cryostat インスタンスのメモリーリソースが枯渇する可能性があります。これは、レポート生成操作が終了するまでメモリーの制限が 2 つのメモリーパーティションに適用されるためです。
オプションのデフォルト設定を使用してレポートを生成することを検討してください。デフォルト設定が要件に合わない場合は、オプションの設定を検討してください。
-
Replicas: デフォルトは
- Create をクリックし、Cryostat インスタンスを生成します。
検証
- Cryostat インスタンスの Cryostat details ページに移動し、Details タブを選択します。
- Application URL フィールドの下にある URL をクリックします。Web ブラウザーで OpenShift Container Platform ログインページにリダイレクトされたら、そこで認証情報を入力する必要があります。
- Cryostat Web コンソールから、ターゲット JVM を選択します。
- Recordings メニュー項目に移動し、Java 仮想マシン (JVM) の JFR レコーディングを開始します。
Active Recordings タブまたは Archived Recordings タブで、次のいずれかのアクションを実行してサイドカーレポートを生成します。
-
リストされたレコーディングの横にある下矢印アイコン (
v) を展開します。 リストされたレコーディングの反対側にあるオーバーフローメニューをクリックし、View Report オプションを選択します。
図2.2 Active Recordings メニューからサイドカーレポートを生成する例

-
リストされたレコーディングの横にある下矢印アイコン (
- Red Hat OpenShift Web コンソールに移動し、Workloads > Pods を選択します。
- Pod の名前をクリックします。
- Pod details ページで、Logs タブをクリックします。
一時停止アイコンをクリックし、ログストリームを停止します。ログウィンドウに一連のログメッセージが表示されます。
図2.3 Pod details ページの Log streaming ボタン

サイドカーレポートコンテナーがメインの Cryostat コンテナーから生成されたレポートリクエストを受信したことを確認するログメッセージを見つけます。
図2.4 Logs タブのログメッセージの例

関連情報
- Red Hat build of Cryostat Operator を使用した Red Hat OpenShift への Cryostat のインストール (Cryostat のインストール)
- JDK Flight Recorder (JFR) のレコーディングの作成 (Cryostat を使用した JFR レコーディングの作成)
- Red Hat build of Cryostat Operator (Red Hat build of Cryostat Operator を使用した Cryostat の設定)
改訂日時: 2023-06-20