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

手順

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 ダイアログボックス

      

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

   注記

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

   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 ウィンドウ

   
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 をクリックします。