Springboot スタンドアロンでの Fuse の管理

手順

1. 以下の依存関係を Fuse アプリケーションの pom.xml ファイルに追加します。

   <dependency>
     <groupId>io.hawt</groupId>
     <artifactId>hawtio-springboot</artifactId>
   </dependency>

   バージョンは Maven BOM により提供されるため、指定する必要はありません。

2. src/main/resources/application.properties ファイルを編集します。

   1. 以下のプロパティーを設定します。

      • management.endpoints.web.exposure.include=hawtio,jolokia
      • hawtio.authenticationEnabled=false
      • management.endpoint.hawtio.enabled=true
      • management.endpoint.jolokia.enabled=true

   2. 任意で、management.endpoints.web.base-path プロパティーを設定します。

      Spring Boot 2.x のデフォルトでは、Fuse Console の URL に管理エンドポイントのコンテキストパス (/actuator) が含まれます。以下に例を示します。

      http://localhost:10001/actuator/hawtio/index.html

      このデフォルト URL を変更し、http://localhost:10001/hawtio を指定するには、management.endpoints.web.base-path プロパティーを以下のように設定します。

      management.endpoints.web.base-path=/

      application.properties 設定は以下の例のようになるはずです。

      # ports
      
      server.port=8080
      
      management.server.port=10001
      
      # enable management endpoints for healthchecks and hawtio
      
      management.endpoints.enabled-by-default = false
      
      management.endpoint.hawtio.enabled = true
      
      management.endpoint.jolokia.enabled = true
      
      management.endpoints.health.enabled = true
      
      management.health.defaults.enabled=false
      
      camel.health.enabled=false
      
      camel.health.indicator.enabled=true
      
      management.endpoints.web.exposure.include=hawtio,jolokia
      
      hawtio.authenticationEnabled=false
      
      # change the URL so that it does not include the actuator folder
      
      management.endpoints.web.base-path=/

      注記

      デフォルトでは、Spring Boot の Fuse Console の認証は無効になっています。任意で、Fuse Console ディストリビューションに固有するコードを作成すると、認証を有効にできます。以下に、ガイダンスとして使用できる例を示します。

      https://github.com/hawtio/hawtio/tree/master/examples/springboot-authentication

3. Fuse アプリケーションを実行します。

   mvn spring-boot:run

4. Fuse Console の URL のポート番号を特定するには、src/main/resources/application.properties ファイルで management.server.port の設定値を見つけます。以下に例を示します。

   management.server.port   = 10001

5. ブラウザーで Fuse Console を開くには、以下の URL 構文を使用します。nnnnn は management.server.port プロパティーの値に置き換えます。

   http://localhost:nnnnn/actuator/hawtio

   たとえば、management.server.port プロパティーの値が 10001 で、management.endpoints.web.base-path プロパティーが設定されていないと、URL は以下のようになります。

   http://localhost:10001/actuator/hawtio/index.html

手順

1. ローカルの Fuse on Spring Boot スタンドアロンアプリケーションの src/main/webapp ディレクトリーに hawtconfig.json という名前の JSON ファイルを作成します。

2. 任意のエディターで src/main/webapp/hawtconfig.json を開き、以下の内容を追加します。

   {
     "branding": {
       "appName": "Red Hat Fuse Console",
       "appLogoUrl": "img/Logo-Red_Hat-Fuse-A-Reverse-RGB.png",
       "companyLogoUrl": "img/Logo-RedHat-A-Reverse-RGB.png"
     },
     "login": {
       "description": "",
       "links": []
     },
     "about": {
       "title": "Red Hat Fuse Console",
       "productInfo": [],
       "additionalInfo": "",
       "copyright": "",
       "imgSrc": "img/Logo-RedHat-A-Reverse-RGB.png"
     },
     "disabledRoutes": [
       "/camel/source",
       "/diagnostics",
       "/jvm/discover",
       "/jvm/local"
     ]
   }

3. 表A.1「Fuse Console 設定プロパティー」 に記載されている設定プロパティーの値を変更します。
4. 変更を保存します。

5. 以下のコマンドを使用して Fuse on Spring Boot を実行します。

   mvn spring-boot:run

6. Web ブラウザーで、URL http://localhost:10001/actuator/hawtio/index.html を使用して、Fuse Console を開きます。

手順

1. hawtio.http.strictTransportSecurity プロパティーおよび hawtio.http.publicKeyPins プロパティーを以下の例のように設定します。

   public static void main(String[] args) {
       System.setProperty("hawtio.http.strictTransportSecurity", "max-age=31536000; includeSubDomains; preload");
       System.setProperty("hawtio.http.publicKeyPins", "pin-sha256=cUPcTAZWKaASuYWhhneDttWpY3oBAkE3h2+soZS7sWs"; max-age=5184000; includeSubDomains");
       SpringApplication.run(YourSpringBootApplication.class, args);
   }

2. (AWS のみにデプロイする場合) Fuse Console のプロキシーサーブレットを無効にするには、以下の例のように hawtio.disableProxy プロキシーを設定します。

   public static void main(String[] args) {
       System.setProperty("hawtio.disableProxy", "true");
   }

手順

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

   

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

手順

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

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

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

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

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

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

手順

1. Fuse Console で Quartz タブをクリックします。

   Quartz ページには、Quartz スケジューラーのツリービューと、Scheduler、Triggers、および Jobs タブがあります。

2. スケジューラーを一時停止または起動するには、Scheduler タブのボタンをクリックします。

3. Triggers タブをクリックして、ジョブを実行するタイミングを決定するトリガーを表示します。たとえば、トリガーは、一日の指定の時刻 (ミリ秒単位) に、指定した日数、または指定した回数もしくは特定の回数繰り返してジョブを開始するように指定できます。

   • トリガーの一覧をフィルタリングするには、ドロップダウンリストから State、Group、Name、または Type を選択します。続いて、入力フィールドに選択または入力することで、さらにリストをフィルターできます。
   • トリガーを一時停止、再開、更新、または手動で実行するには、Action 列のオプションをクリックします。
4. Jobs タブをクリックして実行中のジョブのリストを表示します。テーブルの Group、Name、Durable、Recover、Job ClassName、および Description の列でリストをソートできます。

手順

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

手順

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