第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 内でデプロイした。

手順

  1. Red Hat OpenShift Web コンソールから、Operators > Installed Operators に移動します。
  2. インストールされている Operator のリストから、Red Hat build of Cryostat Operator インスタンスの名前をクリックします。Web コンソールで Operator details ページが開きます。
  3. Provided APIs セクションで、Create instance をクリックします。
  4. Name フィールドなど、アスタリスクでマークされている必須フィールドに入力します。
  5. Create Cryostat 設定ページから、Report Options セクションに移動します。
  6. 展開アイコンをクリックし、Cryostat の自動レポート分析の実装を設定するためのオプションを表示します。

    図2.1 Create Cryostat 設定ページの Report Options セクション

    *Create Cryostat* 設定ページの *Report Options* セクション
  7. ニーズに合わせて、次のレポートオプションのいずれかを設定します。

    1. Replicas: デフォルトは 0 です。この値は、メインの Cryostat コンテナーがレポート生成を処理することを示します。サイドカーコンテナーのレプリカが分析レポートを生成して処理できるように、0 より大きい値を設定する必要があります。
    2. Resources: 各サイドカーレプリカのリソース制限を設定します。展開アイコンをクリックし、各サイドカーレプリカの設定可能な制限とリクエストオプションを表示します。オプションには、CPU coresMemory、および Storage があります。Storage オプションは、サイドカーレポート生成との関連性が最も低いオプションです。各オプションでサポートされる単位は、Red Hat OpenShift によって設定されます。
    3. Sub Process Max Heap Size: メインの Cryostat コンテナーにのみ適用されます。レポートの生成に使用できるメインの Cryostat コンテナーの最大メモリー量を割り当てます。

      注記

      Sub Process Max Heap Size オプションに指定する値の型には、以下の制限が存在する場合があります。

      • 値が小さいと、レポートサイズがメインの Cryostat コンテナーに割り当てられたメモリーを超える可能性があるため、レポート生成リクエストが失敗する場合があります。さらに、JVM はレポートを処理するためにガベージコレクション (GC) 操作を常に実行する必要があるため、レポートの生成がタイムアウトする場合があります。
      • 値が大きいと、メインの Cryostat コンテナー内で動作する Cryostat インスタンスのメモリーリソースが枯渇する可能性があります。これは、レポート生成操作が終了するまでメモリーの制限が 2 つのメモリーパーティションに適用されるためです。

      オプションのデフォルト設定を使用してレポートを生成することを検討してください。デフォルト設定が要件に合わない場合は、オプションの設定を検討してください。

  8. Create をクリックし、Cryostat インスタンスを生成します。

検証

  1. Cryostat インスタンスの Cryostat details ページに移動し、Details タブを選択します。
  2. Application URL フィールドの下にある URL をクリックします。Web ブラウザーで OpenShift Container Platform ログインページにリダイレクトされたら、そこで認証情報を入力する必要があります。
  3. Cryostat Web コンソールから、ターゲット JVM を選択します。
  4. Recordings メニュー項目に移動し、Java 仮想マシン (JVM) の JFR レコーディングを開始します。
  5. Active Recordings タブまたは Archived Recordings タブで、次のいずれかのアクションを実行してサイドカーレポートを生成します。

    1. リストされたレコーディングの横にある下矢印アイコン (v) を展開します。
    2. リストされたレコーディングの反対側にあるオーバーフローメニューをクリックし、View Report オプションを選択します。

      図2.2 Active Recordings メニューからサイドカーレポートを生成する例

      *Active Recordings* メニューからサイドカーレポートを生成する例
  6. Red Hat OpenShift Web コンソールに移動し、Workloads > Pods を選択します。
  7. Pod の名前をクリックします。
  8. Pod details ページで、Logs タブをクリックします。
  9. 一時停止アイコンをクリックし、ログストリームを停止します。ログウィンドウに一連のログメッセージが表示されます。

    図2.3 Pod details ページの Log streaming ボタン

    *Pod details* ページの *Log streaming* ボタン
  10. サイドカーレポートコンテナーがメインの Cryostat コンテナーから生成されたレポートリクエストを受信したことを確認するログメッセージを見つけます。

    図2.4 Logs タブのログメッセージの例

    *Logs* タブのログメッセージの例

関連情報

改訂日時: 2023-06-20