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.

First Set up the Lamaxu JMX Gateway

Adding a JMX Component 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.

LAMAXU > SOLARWINDS > SolarWindsSAMSettings.PNG

2. Click Component Monitor Wizard

LAMAXU > SOLARWINDS > SolarWindsComponenetMonitorWizard.PNG

3. Select JMX Monitor from the dropdown list.

LAMAXU > SOLARWINDS > SolarWindsJMXmonitor.PNG

Note: For the next step, the defaults are sufficient for most environments. If they are not, you can change them to suit your environment.

4. Click Browse to find the Server IP Address of the node you want to monitor.

5. Add the Port number, Protocol type, URL path, and Credentials for the remaining fields. Use the customized URL below:

6. Choose a credential from the Credential Library or create a new one using the Username and Password fields.

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}

LAMAXU > SOLARWINDS > SolarWindsJMXtarget1.PNG

7. Click Next. The following MBean selection screen appears

LAMAXU > SOLARWINDS > SolarWindsJMXmbeanSelect.PNG

Configuring Solarwinds SAM

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

IMPORTANT : Set the agent config.xml property <valueFormat>solarwinds</valueFormat> for Lamaxu to expose numeric metrics rather than mapping to string values.