第3章 イベントテンプレート


Cryostat には、デフォルトのイベントテンプレートが含まれています。これを使用すると、ターゲット JVM のパフォーマンスをモニターするための JFR レコーディングをすばやく作成できます。

3.1. カスタムイベントテンプレートの使用

JDK Flight Recorder (JFR) レコーディングの作成時に、以下のいずれかのデフォルトイベントテンプレートを選択できます。

  • 一定期間、または明示的に停止されるまで、ターゲット Java 仮想マシン (JVM) の基本的なデータを収集する継続テンプレート。
  • 一定期間、または明示的に停止されるまで、ターゲット Java 仮想マシン (JVM) の詳細なデータを収集するプロファイリングテンプレート。

どちらかのデフォルトイベントテンプレートを使用して、ターゲット JVM のパフォーマンスをモニターするための JFR レコーディングを迅速に作成できます。どちらのイベントテンプレートも、必要に応じて後で編集できます。たとえば、デフォルトイベントテンプレートにはアプリケーション固有のカスタムイベントが含まれないため、これらのカスタムイベントをカスタムテンプレートに追加する必要があります。

Cryostat は ALL meta-template もサポートします。これを使用すると、JFR はターゲット JVM のすべてのイベントタイプをモニターできます。各イベントタイプにはデフォルト値があります。ALL meta-template には XML 定義が含まれないため、ALL meta-template の XML ファイルをダウンロードすることはできません。

前提条件

  • Installed Operators オプションを使用して、Cryostat 3.0 を Red Hat OpenShift にインストールした。
  • Red Hat OpenShift プロジェクトに Cryostat インスタンスを作成した。

手順

  1. Cryostat インスタンスの Dashboard パネルで、ドロップダウンリストから Target JVM を選択します。
  2. オプション: Topology パネルで、Add to view アイコンを選択してターゲット JVM を定義できます。アイコンを選択すると、カスタムターゲット接続 URL を定義するためのウィンドウが開きます。

    1. Connection URL フィールドに、JVM の Java Management Extension (JMX) エンドポイントの URL を入力します。
    2. オプション: Alias フィールドに、JMX Service URL のエイリアスを入力します。
    3. Create をクリックします。

      図3.1 Create Target ダイアログボックス

      *Create Custom Target* ダイアログボックス
  3. Cryostat Web コンソールのナビゲーションメニューから、Events をクリックします。Web コンソールで Authentication Required ダイアログが開く場合があります。プロンプトが表示されたら、Authentication Required ダイアログボックスに UsernamePassword を入力し、Save をクリックしてターゲット JVM に認証情報を提供します。

    注記

    選択したターゲット JMX で、JMX 接続に対して SSL 証明書が有効な場合は、プロンプトが表示されたら証明書を追加する必要があります。

    Cryostat は、ターゲット JVM アプリケーションの認証情報を暗号化し、Red Hat OpenShift の永続ボリューム要求 (PVC) に格納されているデータベースに保存できます。

  4. Event Templates タブで、リストされたイベントテンプレートを見つけ、その他のオプションメニューを選択します。
  5. その他のオプションメニューから、Download をクリックします。オペレーティングシステムの設定に応じて、ファイル保存ダイアログが開きます。ファイルを任意の場所に保存します。

    図3.2 イベントテンプレートのその他のオプションメニューの例

    イベントテンプレートのその他のオプションメニューの例
  6. デフォルトのファイルエディターでファイルを開き、必要に応じてファイルを編集します。設定の変更を保持するには、ファイルを保存する必要があります。

    注記

    後の段階でファイルの特定に役立つ description および provider 属性に値を追加できます。

  7. Events メニューから Event Templates タブに移動し、Upload アイコンをクリックします。Cryostat Web コンソールで Create Custom Event Template 開きます。

    図3.3 Create Custom Event Template ウィンドウ

    *Create Custom Event Template* ウィンドウ
  8. Upload をクリックし、デフォルトのファイルエディターを使用して、1 つ以上の設定済みイベントテンプレートファイルを Cryostat Web コンソールにアップロードします。ファイルを Template XML ウィンドウにドラッグアンドドロップすることもできます。
  9. Submit ボタンをクリックします。Cryostat Web コンソールで Event Templates タブが開き、カスタムイベントテンプレートが表示されます。
  10. オプション: イベントテンプレートを作成すると、次のいずれかのオプションを選択し、テンプレートを使用して JFR レコーディングを作成できます。

    • Automated Rules メニューから Create をクリックし、Template リストからイベントテンプレートを選択します。
    • Events メニューから、リストされたイベントテンプレートを見つけ、その他のオプションメニューから Create Recording を選択します。
    • Recordings メニューの Active Recordings タブで、Create をクリックします。
トップに戻る
Red Hat logoGithubredditYoutubeTwitter

詳細情報

試用、購入および販売

コミュニティー

Red Hat ドキュメントについて

Red Hat をお使いのお客様が、信頼できるコンテンツが含まれている製品やサービスを活用することで、イノベーションを行い、目標を達成できるようにします。 最新の更新を見る.

多様性を受け入れるオープンソースの強化

Red Hat では、コード、ドキュメント、Web プロパティーにおける配慮に欠ける用語の置き換えに取り組んでいます。このような変更は、段階的に実施される予定です。詳細情報: Red Hat ブログ.

会社概要

Red Hat は、企業がコアとなるデータセンターからネットワークエッジに至るまで、各種プラットフォームや環境全体で作業を簡素化できるように、強化されたソリューションを提供しています。

Theme

© 2025 Red Hat