Universal Messaging 10.11 | Operations Guide | Monitoring Containers | Switch to Flat Topic and Queue Namespaces
 
Switch to Flat Topic and Queue Namespaces
By default, JMX namespaces for topics and queues are created using a folder tree structure, for example, Folder1=q1,Folder2=q2,destinationName=queuename, which might cause issues for some monitoring solutions.
For this reason, you can switch to flat namespaces for JMX topics and queues by using the FlatStoreJMXBeanNamespace realm configuration property.
In addition, you must edit the jmx_exporter.yaml file, which is the configuration file for the JMX Exporter agent. The file is located in the Software AG_directory \UniversalMessaging\server\instance_name\bin directory.
*To switch to flat namespaces
1. In Enterprise Manager, select a realm and go to Config > JVM Management.
2. Set the FlatStoreJMXBeanNamespace property to true.
3. Disable the EnableJMX property to stop the JMX server.
4. Edit the pattern parameter for all topic and queue attributes in the jmx_exporter.yaml file as follows:
Old version of pattern:
- pattern: com.softwareag.um.server<type=Broker, brokerName=(\S*), destinationType=Queue,
(.*)><>(TotalPublished)
New version of pattern:
- pattern: com.softwareag.um.server<type=Broker, brokerName=(\S*), destinationType=Queue,
destinationName=(\S*)><>(TotalPublished)
You must replace (.*) in the old file version with destinationName=(\S*) in the new file version.
5. Set EnableJMX to true again.
After you you enable the functionality, a JMX queue namespace, for example, will have the format destinationName=/q1/q2/q3.