Chapter 1. Monitor and manage Red Hat Fuse applications on OpenShift

1. From the Applications Pods view in your OpenShift project, click on the pod name to view the details of the running Fuse pod. On the right-hand side of this page, you see a summary of the container template:

   

2. From this view, click on the Open Java Console link to open the Fuse Console.

   

   Note

   In order to configure OpenShift to display a link to Fuse Console in the pod view, the pod running a Fuse on OpenShift image must declare a TCP port within a name attribute set to jolokia:

   {
     "kind": "Pod",
     [...]
     "spec": {
       "containers": [
         {
           [...]
           "ports": [
             {
               "name": "jolokia",
               "containerPort": 8778,
               "protocol": "TCP"
             }

Procedure

1. In the OpenShift console, open an existing project or create a new project.

2. Add the Fuse Console to your OpenShift project:

   1. Select Add to Project Browse Catalog.

      The Select an item to add to the current project page opens.

   2. In the Search field, type Fuse Console.

      The Red Hat Fuse 7.x Console and Red Hat Fuse 7.x Console (cluster) items should appear as the search result.

1. Click one of the Red Hat Fuse Console items:

   • Red Hat Fuse 7.x Console - This version of the Fuse Console discovers and connects to Fuse applications deployed in the current OpenShift project.
   • Red Hat Fuse 7.x Console (cluster) - This version of the Fuse Console can discover and connect to Fuse applications deployed across multiple projects on the OpenShift cluster.

2. In the Red Hat Fuse Console wizard, click Next. The Configuration page of the wizard opens.

   Optionally, you can change the default values of the configuration parameters.

   1. Click Create.

      The Results page of the wizard indicates that the Red Hat Fuse Console has been created.

   2. Click the Continue to the project overview link to verify that the Fuse Console application is added to the project.

   3. To open the Fuse Console, click the provided URL link and then log in.

      An Authorize Access page opens in the browser listing the required permissions.

   4. Click Allow selected permissions.

      The Fuse Console opens in the browser and shows the Fuse pods running in the project.

   5. Click Connect for the application that you want to view.

      A new browser window opens showing the application in the Fuse Console.

1. Create a new application based on a Fuse Console template by running one of the following commands (where myproject is the name of your project):

   • For the Fuse Console cluster template, where myhost is the hostname to access the Fuse Console:

     oc new-app -n myproject -f https://raw.githubusercontent.com/jboss-fuse/application-templates/application-templates-2.1.fuse-740025-redhat-00003/fis-console-cluster-template.json -p ROUTE_HOSTNAME=myhost

   • For the Fuse Console namespace template:

     oc new-app -n myproject -f https://raw.githubusercontent.com/jboss-fuse/application-templates/application-templates-2.1.fuse-740025-redhat-00003/fis-console-namespace-template.json

     Note

     You can omit the route_hostname parameter for the namespace template because OpenShift automatically generates one.

2. Obtain the status and the URL of your Fuse Console deployment by running this command:

   oc status

3. To access the Fuse Console from a browser, use the provided URL (for example, https://fuse-console.192.168.64.12.nip.io).

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.

1. In the Camel tab’s tree view, click Camel Contexts.
2. Check the box next to one or more contexts in the list.
3. Click Start or Suspend.

4. To delete a context:

   1. Stop the context.
   2. Click the ellipse icon and then select Delete from the dropdown menu.

1. In the Camel tab’s tree view, click a Camel application.
2. To view a list of application attributes and values, click Attributes.
3. To view a graphical representation of the application attributes, click Chart and then click Edit to select the attributes that you want to see in the chart.
4. To view inflight and blocked exchanges, click Exchanges.
5. To view application endpoints, click Endpoints. You can filter the list by URL, Route ID, and direction.
6. To view, enable, and disable statistics related to the Camel built-in type conversion mechanism that is used to convert message bodies and message headers to different types, click Type Converters.
7. To view and execute JMX operations, such as adding or updating routes from XML or finding all Camel components available in the classpath, click Operations.

1. To view a list of routes:

   1. Click the Camel tab.

   2. In the tree view, click the application’s routes folder:

      

2. To start, stop, or delete one or more routes:

   1. Check the box next to one or more routes in the list.
   2. Click Start or Stop.

   3. To delete a route, you must first stop it. Then click the ellipse icon and select Delete from the dropdown menu.

      

      Note
      • When you delete a route, you remove it from the deployed application.
      • You can also select a specific route in the tree view and then click the upper-right menu to start, stop, or delete it.
3. To view a graphical diagram of the routes, click Route Diagram.
4. To view inflight and blocked exchanges, click Exchanges.
5. To view endpoints, click Endpoints. You can filter the list by URL, Route ID, and direction.
6. Click Type Converters to view, enable, and disable statistics related to the Camel built-in type conversion mechanism, which is used to convert message bodies and message headers to different types.

7. To interact with a specific route:

   1. In the Camel tab’s tree view, select a route.
   2. To view a list of route attributes and values, click Attributes.
   3. To view a graphical representation of the route attributes, click Chart. You can click Edit to select the attributes that you want to see in the chart.
   4. To view inflight and blocked exchanges, click Exchanges.
   5. Click Operations to view and execute JMX operations on the route, such as dumping the route as XML or getting the route’s Camel ID value.

8. To trace messages through a route:

   1. In the Camel tab’s tree view, select a route.
   2. Select Trace, and then click Start tracing.

9. To send messages to a route:

   1. In the Camel tab’s tree view, open the context’s endpoints folder and then select an endpoint.
   2. Click the Send subtab.
   3. Configure the message in JSON or XML format.
   4. Click Send.
   5. Return to the route’s Trace tab to view the flow of messages through the route.

1. In the Camel tab’s tree view, select a route.
2. Select Debug, and then click Start debugging.

3. To add a breakpoint, select a node in the diagram and then click Add breakpoint. A red dot appears in the node:

   

   The node is added to the list of breakpoints:

   

4. Click the down arrow to step to the next node or the Play button to resume running the route.
5. Click the Pause button to suspend all threads for the route.
6. Click Stop debugging when you are done. All breakpoints are cleared.