第2章 Spring Boot スタンドアロンでの Red Hat 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 を変更し、たとえば Spring Boot 1.x のデフォルトの 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 アプリケーションの pom.xml ファイルに追加します。

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

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

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

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

      • endpoints.jolokia.sensitive
      • endpoints.hawtio.sensitive
      • hawtio.authenticationEnabled

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

      • endpoints.hawtio.enabled

      • endpoints.jolokia.enabled

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

        # ports
        
        server.port=8080
        
        management.port=10001
        
        
        # enable management endpoints for healthchecks and hawtio
        
        endpoints.enabled = false
        
        endpoints.hawtio.enabled = true
        
        endpoints.jolokia.enabled = true
        
        endpoints.health.enabled = true
        
        management.health.defaults.enabled=false
        
        camel.health.enabled=false
        
        camel.health.indicator.enabled=true
        
        endpoints.jolokia.sensitive=false
        
        endpoints.hawtio.sensitive=false
        
        hawtio.authenticationEnabled=false

        注記

        デフォルトでは、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.port の設定値を見つけます。以下に例を示します。

   management.port   = 10001

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

   http://localhost:nnnnn/hawtio/index.html

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

手順

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

手順

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