Chapter 4. Monitoring and managing Red Hat Fuse applications on EAP standalone

1. Start Red Hat Fuse standalone with the following command:

   On Linux/Mac OS: ./bin/standalone.sh

   On Windows: ./bin/standalone.bat

2. In a web browser, enter the URL to connect to the Fuse Console. For example: http://localhost:8080/hawtio
3. In the login page, enter your user name and password and then click Log In.

Procedure

1. Download the branding plugin example from https://github.com/hawtio/hawtio/tree/master/examples/branding-plugin to a local directory of your choice.

2. In an editor of your choice, open the Fuse Console branding plugin’s src/main/webapp/plugin/brandingPlugin.js file to customize the Fuse Console branding.

   You can change the values of the configuration properties listed in Table A.1, “Fuse Console Configuration Properties”.

3. Save your changes.

4. In an editor of your choice, open the Fuse Console branding plugin’s pom.xml file to its <parent> section:

   <parent>
       <groupId>io.hawt</groupId>
       <artifactId>project</artifactId>
       <version>2.9-SNAPSHOT</version>
       <relativePath>../..</relativePath>
     </parent>

5. Edit the <parent> section as follows:

   1. Change the value of the <version> property to match the version of your Fuse on EAP installation. For example, if your Fuse on EAP installation directory name is 2.0.0.fuse-760015, set the version to 2.0.0.fuse-760015.

   2. Remove the <relativePath>../..</relativePath> line.

      For example:

      <parent>
          <groupId>io.hawt</groupId>
          <artifactId>project</artifactId>
          <version> 2.0.0.fuse-760015</version>
            </parent>

6. In a Terminal window, build the branding-plugin project by running the following command:

   mvn clean install

   This command creates a branding-plugin.war file in the project’s /target folder.

7. Copy the branding-plugin.war file to your EAP installation’s standalone/deployments directory.

8. If Fuse is not already running, start it by running the following command:

   On Linux/Mac OS: ./bin/standalone.sh

   On Windows: ./bin/standalone.bat

9. In a web browser, open the Fuse Console by using the URL that the start command returned in the previous step (the default URL is http://localhost:8080/hawtio).

Procedure

1. Set the hawtio.http.strictTransportSecurity and the hawtio.http.publicKeyPins properties in the system-properties section of the $EAP_HOME/standalone/configuration/standalone*.xml file as shown in the following example:

   <property name="hawtio.http.strictTransportSecurity" value="max-age=31536000; includeSubDomains; preload"/>
   <property name="hawtio.http.publicKeyPins" value="pin-sha256=cUPcTAZWKaASuYWhhneDttWpY3oBAkE3h2+soZS7sWs"; max-age=5184000; includeSubDomains"/>

2. (For deploying on AWS only) To disable the Fuse Console’s proxy servlet, set the hawtio.disableProxy property in the system-properties section of the $EAP_HOME/standalone/configuration/standalone*.xml file as shown in the following example:

   <property name="hawtio.disableProxy" value="true"/>

Procedure

1. In the upper right corner of the Fuse Console, click the user icon and then click Preferences.

   

2. Increase the value of the Maximum collection size option (the default is 50,000).
3. Click Close.

Procedure

1. To view and edit MBean attributes:

   1. In the tree view, select an MBean.
   2. Click the Attributes tab.
   3. Click an attribute to see its details.

2. To perform operations:

   1. In the tree view, select an MBean.
   2. Click the Operations tab, expand one of the listed operations.
   3. Click Execute to run the operation.

3. To view charts:

   1. In the tree view, select an item.
   2. Click the Chart tab.

Procedure

1. To retrieve the number of instances of loaded classes and the amount of bytes they take up, click Class Histogram. If the operation is repeated, the tab shows the difference since last run.
2. To view the JVM diagnostic flag setting, click the JVM flags.
3. For a running JVM, you can also modify the flag settings.

Procedure

1. Click the Runtime tab and then the Threads subtab. The Threads page lists active threads and stack trace details for each thread. By default, the thread list shows all threads in descending ID order.
2. To sort the list by increasing ID, click the ID column label.
3. Optionally, filter the list by thread state (for example, Blocked) or by thread name.
4. To drill down to detailed information for a specific thread, such as the lock class name and full stack trace for that thread, in the Actions column, click More.

Procedure

1. To view a list of the log entries, click the Log Entries tab.

   By default, the list shows log entries in ascending order.

   You can drill down to each log entry to view detailed information about the log entry.

2. To filter the list of logs to show specific log types, click the Action Bar. You can filter the log entries section according to a text string or the logging level.

3. To change the Fuse Console default settings:

   1. In the upper right corner of the Fuse Console, click the user icon and then click Preferences from the drop-down menu.

      

   2. To change the default sorting order, select Server Logs and then click the log entry link to drill down to details about the log entry, such as the bundle name, thread, and the full message text.

   3. Optionally, you can customize these settings for storing log messages:

      • The number of log statements to keep in the Fuse Console (the default is 100).
      • The global log level: INFO (the default), OFF, ERROR, WARN, and DEBUG.
      • The child-level messages to include, such as hawtio-oauth and hawtio-core-utils.
   4. To reset the Fuse Console Logs settings to the default values, click Reset Reset settings.