第3章 Karaf スタンドアロンの Red Hat Fuse アプリケーションの監視および管理

手順

1. コマンドラインで、Red Hat Fuse をインストールしたディレクトリーに移動し、以下のコマンドを実行して Fuse スタンドアロンを起動します。

   ./bin/fuse

   Copy to Clipboard Toggle word wrap

   Karaf コンソールが起動し、バージョン情報、デフォルトの Fuse Console URL、および一般的なコマンドのリストが表示されます。

2. ブラウザーで URL を入力し、Fuse Console に接続します。例: http://localhost:8181/hawtio
3. ログインページでユーザー名とパスワードを入力し、Log In をクリックします。

手順

1. HTTPS を必須のプロトコルとして設定するには、$KARAF_HOME/etc/system.properties ファイルの hawtio.http.strictTransportSecurity プロパティーを以下の例のように設定します。

   hawtio.http.strictTransportSecurity = max-age=31536000; includeSubDomains; preload

   Copy to Clipboard Toggle word wrap

2. 公開鍵を使用して応答をセキュアにするには、$KARAF_HOME/etc/system.properties ファイルの hawtio.http.publicKeyPins プロパティーを以下の例のように設定します。

   hawtio.http.publicKeyPins = pin-sha256="cUPcTAZWKaASuYWhhneDttWpY3oBAkE3h2+soZS7sWs"; max-age=5184000; includeSubDomains

   Copy to Clipboard Toggle word wrap
3. SSL/TLS セキュリティーを有効にする方法の詳細は、『Apache Karaf Security Guide』の「Enabling SSL/TLS for Undertow in an Apache Karaf container」を参照してください。
4. Red Hat Single Sign-On で Fuse Console をセキュアにする方法については、『Red Hat Single Sign-on Securing Applications and Services Guide』の「Securing the Hawtio Administration Console」セクションを参照してください。

5. 以下の手順にしたがってユーザーロールを設定し、必要な Fuse Console 操作を実行できる権限をユーザーに付与します。

   1. エディターで Red Hat Fuse etc/users.properties ファイルを開きます。

   2. ユーザー名、パスワード、およびロールのエントリーを追加します。

      たとえば、etc/users.properties ファイルの以下のエントリーは管理ユーザーを定義し、管理ロールを割り当てます。

      admin = secretpass,admin

      Copy to Clipboard Toggle word wrap
   3. ファイルを保存します。

手順

1. Fuse Console の右上隅にあるユーザーアイコンをクリックして、Preferences をクリックします。

   

2. Maximum collection size オプションの値を大きくします (デフォルトは 50,000)。
3. Close をクリックします。

手順

1. hawtio-web バンドル ID を特定するには、以下のコマンドを使用して Fuse Console が使用する Fuse バンドルをリストします。

   osgi:list | grep hawtio

2. バンドルを停止するには、osgi:stop コマンドを使用します。たとえば、hawtio :: Web console バンドルの ID が 246 の場合、以下のコマンドを入力します。

   osgi:stop 246

手順

1. MBean 属性を表示および編集するには、以下を行います。

   1. ツリービューで MBean を選択します。
   2. Attributes タブをクリックします。
   3. 属性をクリックしてその詳細を表示します。

2. 操作を実行するには、以下を行います。

   1. ツリービューで MBean を選択します。
   2. Operations タブをクリックし、リストにある操作の 1 つを展開します。
   3. Execute をクリックし、操作を実行します。

3. チャートを表示するには、以下を行います。

   1. ツリービューで項目を選択します。
   2. Chart タブをクリックします。

手順

1. ロードされたクラスのインスタンス数や、これらのインスタンスが使用するバイト数を取得するには、Class Histogram をクリックします。操作が繰り返し行われると、最後の操作実行との差異がタブに表示されます。
2. JVM 診断フラグ設定を表示するには、JVM flags をクリックします。
3. 稼働中の JVM でもフラグ設定を変更できます。

手順

1. Runtime タブをクリックし、Threads サブタブをクリックします。Threads ページには、アクティブなスレッドと各スレッドのスタックトレースの詳細が表示されます。デフォルトでは、スレッドリストにはすべてのスレッドが ID 値が大きい順に表示されます。
2. ID 値が小さい順に表示するには、ID 列ラベルをクリックします。
3. 任意で、スレッドの状態 (例: Blocked) やスレッド名でリストを絞り込むことができます。
4. ロッククラス名やスレッドのフルスタックトレースなど、特定スレッドの詳細情報を表示するには、Actions 列で More をクリックします。

手順

1. ログエントリーのリストを表示するには、Log Entries タブをクリックします。

   デフォルトでは、リストのログエントリーは昇順で表示されます。

   各ログエントリーをドリルダウンすると、ログエントリーに関する詳細情報が表示されます。

2. ログのリストを絞り込み、特定のログタイプを表示するには、Action Bar をクリックします。テキスト文字列またはログレベルを基にしてログエントリーセクションを絞り込むことができます。

3. Fuse Console のデフォルト設定を変更するには、以下を行います。

   1. Fuse Console の右上隅にあるユーザーアイコンをクリックして、ドロップダウンメニューの Preferences をクリックします。

      

   2. デフォルトのソート順序を変更するには、Server Logs を選択し、ログエントリーリンクをクリックして、バンドル名、スレッド、完全なメッセージテキストなどのログエントリーに関する詳細を表示します。

   3. 任意で、ログメッセージを格納するための設定をカスタマイズすることができます。

      • Fuse Console に保持するログステートメントの数 (デフォルトは 100)。
      • グローバルログレベル: INFO (デフォルト)、OFF、ERROR、WARN、および DEBUG
      • 子レベルのメッセージには、hawtio-oauth や hawtio-core-utils などが含まれます。
   4. Fuse Console のログ設定をデフォルトの値に戻すには、Reset Reset settings とクリックします。