Chapter 10. Monitoring your brokers

Procedure

1. Open the CR instance that you used for your broker deployment. For example, the CR for a basic deployment might resemble the following:

   apiVersion: broker.amq.io/v2alpha4
   kind: ActiveMQArtemis
   metadata:
     name: ex-aao
     application: ex-aao-app
   spec:
       version: 7.8.0
       deploymentPlan:
           size: 4
           image: registry.redhat.io/amq7/amq-broker:7.8
           ...

2. In the deploymentPlan section, add the jolokiaAgentEnabled and managementRBACEnabled properties and specify values, as shown below.

   apiVersion: broker.amq.io/v2alpha4
   kind: ActiveMQArtemis
   metadata:
     name: ex-aao
     application: ex-aao-app
   spec:
       version: 7.8.0
       deploymentPlan:
           size: 4
           image: registry.redhat.io/amq7/amq-broker:7.8
           ...
           jolokiaAgentEnabled: true
           managementRBACEnabled: false

   jolokiaAgentEnabled

   Specifies whether Fuse Console can discover and display runtime data for the brokers in the deployment. To use Fuse Console, set the value to true.

   managementRBACEnabled

   Specifies whether role-based access control (RBAC) is enabled for the brokers in the deployment. You must set the value to false to use Fuse Console because Fuse Console uses its own role-based access control.

   Important

   If you set the value of managementRBACEnabled to false to enable use of Fuse Console, management MBeans for the brokers no longer require authorization. You should not use the AMQ management console while managementRBACEnabled is set to false because this potentially exposes all management operations on the brokers to unauthorized use.

3. Save the CR instance.

4. Switch to the project in which you previously created your broker deployment.

   $ oc project <project-name>

5. At the command line, apply the change.

   $ oc apply -f <path/to/custom-resource-instance>.yaml

6. In Fuse Console, to view Fuse applications, click the Online tab. To view running brokers, in the left navigation menu, click Artemis.

Procedure

1. Get the list of running pods:

   $ oc get pods
   
   NAME                 READY     STATUS    RESTARTS   AGE
   broker-amq-1-ftqmk   1/1       Running   0          14d

2. Run the oc logs command:

   $ oc logs -f broker-amq-1-ftqmk
   
   Running /amq-broker-71-openshift image, version 1.3-5
   INFO: Loading '/opt/amq/bin/env'
   INFO: Using java '/usr/lib/jvm/java-1.8.0/bin/java'
   INFO: Starting in foreground, this is just for debugging purposes (stop process by pressing CTRL+C)
   ...
   INFO | Listening for connections at: tcp://broker-amq-1-ftqmk:61616?maximumConnections=1000&wireFormat.maxFrameSize=104857600
   INFO | Connector openwire started
   INFO | Starting OpenShift discovery agent for service broker-amq-tcp transport type tcp
   INFO | Network Connector DiscoveryNetworkConnector:NC:BrokerService[broker-amq-1-ftqmk] started
   INFO | Apache ActiveMQ 5.11.0.redhat-621084 (broker-amq-1-ftqmk, ID:broker-amq-1-ftqmk-41433-1491445582960-0:1) started
   INFO | For help or more information please see: http://activemq.apache.org
   WARN | Store limit is 102400 mb (current store usage is 0 mb). The data directory: /opt/amq/data/kahadb only has 9684 mb of usable space - resetting to maximum available disk space: 9684 mb
   WARN | Temporary Store limit is 51200 mb, whilst the temporary data directory: /opt/amq/data/broker-amq-1-ftqmk/tmp_storage only has 9684 mb of usable space - resetting to maximum available 9684 mb.

3. Run your query to monitor your broker for MaxConsumers:

   $ curl -k -u admin:admin http://console-broker.amq-demo.apps.example.com/console/jolokia/read/org.apache.activemq.artemis:broker=%22broker%22,component=addresses,address=%22TESTQUEUE%22,subcomponent=queues,routing-type=%22anycast%22,queue=%22TESTQUEUE%22/MaxConsumers
   
   {"request":{"mbean":"org.apache.activemq.artemis:address=\"TESTQUEUE\",broker=\"broker\",component=addresses,queue=\"TESTQUEUE\",routing-type=\"anycast\",subcomponent=queues","attribute":"MaxConsumers","type":"read"},"value":-1,"timestamp":1528297825,"status":200}