第2章 新機能

このセクションでは、Cryostat 3.0 リリースが提供する新機能を説明します。

Cryostat DB コンテナー

Cryostat 3.0 以降では、Red Hat Ecosystem Catalog に Cryostat DB コンテナーイメージ (cryostat-db) も含まれます。Cryostat Operator または Helm チャートを使用して Cryostat をインストールすると、cryostat-db コンテナーも自動的にデプロイされます。

cryostat-db コンテナーは、少しカスタマイズされた Postgres データベースを提供します。Cryostat は現在、暗号化されたターゲット JMX 認証情報キーリング、自動ルール定義、検出されたターゲット、検出プラグインなどの情報を格納するためにこのデータベースを使用しています。

以前のリリースでは、Cryostat は JMX 認証情報キーリングなどの情報を単純な H2 ファイルベースのデータベースに保存し、自動ルール定義など、他の情報はディスク上のファイルとして直接保存していました。Cryostat-db コンテナーの導入により、Cryostat は同じ Postgres データベースにさまざまな種類の情報を保存できるようになりました。

Cryostat ストレージコンテナー

Cryostat 3.0 以降では、Red Hat Ecosystem Catalog に Cryostat Storage コンテナーイメージ (cryostat-storage) も含まれます。Cryostat Operator または Helm チャートを使用して Cryostat をインストールすると、cryostat-storage コンテナーも自動的にデプロイされます。

cryostat-storage コンテナーでは、少しカスタマイズされた SeaweedFS ストレージソリューションが提供されており、S3 互換のストレージプロバイダーとして機能します。

以前のリリースでは、Cryostat はアーカイブされた Flight Recordings とカスタムイベントテンプレートのファイルをディスク上に直接保存していました。cryostat-storage コンテナーの導入により、Cryostat はこの種の情報に対して直接ファイルシステムアクセスを使用する必要がなくなりました。

リバースプロキシーアーキテクチャー

Cryostat Operator または Helm チャートを使用して Cryostat 3.0 をインストールすると、Cryostat には Pod にリバースプロキシー (openshift-oauth-proxy または oauth2_proxy) が含まれるようになりました。このプロキシーのみがサービスを通じてクラスタートラフィックに公開されます。つまり、Cryostat へのすべての API リクエストと、Cryostat Web コンソールまたは Grafana ダッシュボードのすべてのユーザーは、プロキシー経由で送信されます。

プロキシーはユーザーセッションを処理してアプリケーションへのアクセスを制御し、Cryostat Web コンソールと Grafana ダッシュボードの両方に統合されたアクセス制御とユーザーセッションを提供します。これら両方のユーザーインターフェイスは同じルートからアクセスでき、同じ TLS 証明書を提示します。

Red Hat OpenShift にデプロイされると、プロキシーは Cryostat インストール namespace を使用して、Red Hat OpenShift クラスター SSO プロバイダーと統合し、ユーザー認証と認可のロールベースアクセス制御 (RBAC) チェックを実行します。オプションで htpasswd ファイルを使用して認証プロキシーを設定し、Basic 認証を有効にすることができます。Red Hat OpenShift では、これにより、Red Hat OpenShift SSO RBAC アクセス権を持つユーザー以外に Cryostat にアクセスできるユーザーアカウントを追加で定義できます。

ルートホスト名のカスタマイズのサポート

デフォルトでは、Red Hat OpenShift Container Platform は、ホストを指定しないルートに対して、クラスターのデフォルトの Ingress ドメイン名に基づいてホスト名を自動的に割り当てます。要件に応じて、Cryostat Operator が Cryostat デプロイメント用に作成するルートに特定のホスト名を使用することができます。Cryostat 3.0 では、Cryostat カスタムリソース (CR) の新しい .spec.networkOptions.coreConfig.externalHost プロパティーを使用して、Cryostat ルートのカスタムホスト名を指定できます。

Red Hat OpenShift コンソールでは、Cryostat CR を作成するときにこのプロパティーにアクセスできます。

または、Cryostat CR を YAML 形式で作成することもできます。以下に例を示します。

apiVersion: operator.cryostat.io/v1beta2
kind: Cryostat
metadata:
  name: cryostat-sample
spec:
  networkOptions:
    coreConfig:
      externalHost: cryostat.example.com

Red Hat OpenShift Container Platform でルートを作成すると、ルートのホスト名を変更することはできません。Cryostat CR を作成した後にルートのホスト名を変更する必要がある場合は、Cryostat CR を削除し、変更したホスト名で新しい CR を作成する必要があります。

JVM への動的割り当て

Cryostat 3.0 以降では、Cryostat エージェントは、アプリケーションを再起動することなく、すでに実行中のアプリケーション JVM に動的に接続できます。この動的割り当て機能には、以下の要件があります。

動的割り当ては、JVM が起動するたびにエージェントを割り当てる必要がない、アドホックな 1 回限りのプロファイリングまたはトラブルシューティングワークフローをサポートします。動的割り当ては、エージェントを割り当てる目的でアプリケーションの再設定を行うことができない場合や再設定しない場合に適しています。エージェントはアプリケーションを再起動せずに実行中の JVM に割り当てることができるため、アプリケーションのダウンタイムも発生しません。

Cryostat エージェントをスタンドアロンプロセスとして起動するためのサポート

Cryostat 3.0 以降では、Cryostat エージェントをすでに実行中のアプリケーション JVM に動的に割り当てる場合は、エージェントをスタンドアロン Java プロセスとして起動できます。この機能を使用するには、エージェントの JAR ファイルを JVM のファイルシステムにコピーしておく必要があります (例: oc cp コマンドを使用)。

エージェントを起動するには、次のコマンドを実行します。<agent_jar_file> はエージェントの JAR ファイル名を表し、<pid> は、JVM のプロセス ID (PID) を表します。

$ java -jar target/<agent_jar_file> <pid>

以下に例を示します。

$ java -jar target/cryostat-agent-0.4.0.jar 1234

エージェントプロセスは、Attach プロバイダーを使用して指定された PID を検索します。指定された PID が見つかった場合、エージェントプロセスはこの PID に接続し、エージェントの JAR ファイルをこの JVM にロードしようとします。その後、通常のエージェント起動プロセスにブートストラップされます。

コマンドラインオプションを使用して、エージェントランチャーに遅延バインディング設定オプションを追加で指定することもできます。以下に例を示します。

$ java -jar target/cryostat-agent-0.4.0.jar \
-Dcryostat.agent.baseuri=http://cryostat.local \
--smartTrigger=[ProcessCpuLoad>0.2]~profile \
@/deployment/app/moreAgentArgs \
1234

使用可能なオプションとその動作の詳細は、java -jar target/cryostat-agent-0.4.0.jar -h のヘルプコマンドを実行してください。-D を指定したシステムプロパティーは、挿入されたエージェントが設定値の読み取りを試行する前に、ホスト JVM に設定されます。これは、ホスト JVM プロセス自体にこれらのシステムプロパティーまたは同等の環境変数を設定するのと同じ効果があります。