Lamaxu intergates with Solarwinds SAM using Java Management Extensions (JMX), https://en.wikipedia.org/wiki/Java_Management_Extensions.
Lamaxu connects to the MQ queue manager and exposes MQ metrics as JMX MBeans.
Before attemting to integrate Lamaxu with Solarwinds, it's important to confirm that Lamaxu is operating correctly and is able to both access the MQ manager and expose metrics via JMX. The easiest way to do this is to obtain a copy of the Java 8 JDX and use the buddled utility called 'jconsole'.
Please follow the instructions below.
Setting up the Lamaxu JMX Gateway
IMPORTANT : Set the agent config.xml property <valueFormat>solarwinds</valueFormat> for Lamaxu to expose numeric metrics rather than mapping to string values. |
| Note : Only values that return numerical data can be monitored. String data is not supported by SolarWinds at this time. Non-numerical data will be shown without a check box when selecting MBeans to poll from within SAM, as illustrated above |
Adding a JMX Componenet Monitor to SAM
To add a JMX Monitor to a node using the wizard, perform the following steps from the SAM web console.
1. Click SAM Settings.
2. Click Component Monitor Wizard
3. Select JMX Monitor from the dropdown list.
4. Click Browse to find the node you want to monitor.
5. Choose a credential from the Credential Library or create a new one using the Username and Password fields.
| Note: For the next step, the defaults are sufficient for most environments. If they are not, you can change them to suit your environment. |
6. Add the Port number, Protocol type, URL path, and Credentials for the remaining fields. Use the customized URL below:
It's important to use the structure shown below as Solarwinds has a string limit to the size of the custom URL provided.
service:jmx:rmi://${IP}:${PORT}/jndi/${PROTOCOL}://${IP}:3099${PATH}
7. Click Next. The following MBean selection screen appears
