Installation – ImageMaster JMX Exporter

The delivery package of the ImageMaster JMX Exporter contains:

  • Files in the root folder of the delivery packages (with an up-to-date version instead of x):

    • ima_jmx_prometheus_httpserver-9.1x.x.x-prom-x.xx.x-jar-with-dependencies.jar

      (HTTP-Server version of the ImageMaster JMX Exporter)

    • ima_jmx_prometheus_javaagent-9.1x.x.x-prom-x.xx.x.jar

      (Java-Agent version of the ImageMaster JMX Exporter)

    • LICENSE

      (Apache x.x license file based on the used version which was the base version for the ImageMaster JMX Exporter)

    • NOTICE (notice file from the origin creator of the JMX Exporter)

    • README.md

      (short description of the changes and how to use this software including example configuration)

  • Folders in the delivery package:

    • META-INF (contains information about the signed delivery package)

    • thirdpartylicenses (contains all information about used licenses)

    • example_configs (contains several example configuration files)

      • jboss.yaml (example configuration file for JBoss)

      • wildfly.yaml (example configuration file for a WildFly)

      • jadice_small.yml (example configuration file for base Jadice metrics)

      • jadice_big.yml (example configuration file for extended Jadice metrics)

There a two versions of the ImageMaster adopted JMX Exporter available:

  • Java-Agent Module – choose this if you want one of the following:

    • use this agent on the same machine where the application server is installed

    • use minimal resources (less than the HTTP-Server version)

    • monitor machine based metrics like process load or memory

  • HTTP-Server Module – choose this if you:

    • can not install it on the application server host you want to monitor

    • want to be sure that the exporter is also running when the application server gets restarted

    • use an already running application

If you are not sure, which version to choose, the Java-Agent module is highly recommended.