Boomi - Data collector install

This setup consist of three different components listed below:

• Influx Telegraf is one of the most used open source agents to collect metrics from sensors and systems. See https://www.influxdata.com/time-series-platform/telegraf/ for more information. Make sure you download the version corresponding to your OS.

• Jetty provides a web server and servlet container, additionally providing support for HTTP/2, WebSocket, OSGi, JMX, JNDI, JAAS and many other integrations. These components are open source and are freely available for commercial use and distribution. See The Eclipse Jetty Project for more information.

• Jolokia is a JMX-HTTP bridge giving an alternative to JSR-160 connectors. See Jolokia.org for more information.

1. Log in to your Boomi AtomSphere account at https://platform.boomi.com/

   1. in “Integration” -> “Atom management” -> select atom -> “Properties” then select “Advanced” properties to add/ expose JMX Remote Port (5002), JMX Remote RMI Port (5002), JMX Remote SSL (disabled) and JMX Remote Authentication (disabled)

   2. Repeat a) for all your Atoms

2. Download the 3 components needed for the setup

   1. Jetty (version 12 or higher)

   2. Influx Telegraf open source data collector

   3. Jolokia (war unsecured agent, version 2.02 or higher)

3. Deploy Jetty using this guide. Jetty should be deployed to a separate VM or container (if you run a test setup, you can deploy to the host of the Atom).

   1. We recommend that you install the demo applications with the java -jar $JETTY_HOME/start.jar --add-module=demos command to automatically set environment variables. The demo applications can be deleted later.

   2. Copy the Jolokia .war file to the $JETTY_BASE/webapps folder, and rename the .war file to jolokia.war

   3. Start Jetty with java -jar $JETTY_HOME/start.jar (you might need to be in the $JETTY_BASE folder to run the command)

   4. Test that Jetty is running by pointing your browser to http://localhost:8080/jolokia

4. For the server or container hosting Telegraf (can be the same VM/docker as Jetty, or separate)

   1. download and install the Influx Telegraf agent that corresponds to your OS athttps://portal.influxdata.com/downloads/

   2. Copy the eyer_agentless_telegraf.conf file into the Influx Telegraf folder. You can download the configuration file here.

   3. Open the config file in a text editor, and search for / find the section

      [outputs.http.headers]

      Below this section there is a field with the name authenticate. Place your Eyer agent API token here

   4. In the config file, copy the

      [[inputs.jolokia2_proxy]]

      section including all the metrics and paste it x number of times to accommodate the number of atoms you are monitoring. If you only monitor a single atom, there is no need to do this.

      1. Change every [[inputs.jolokia2_proxy.target]] url = "service:jmx:rmi:///jndi/rmi://atom_ip_address:5002/jmxrmi" section to reflect the IPs where your atoms are hosted. If you only monitor a single atom, and if your Telegraf agent is hosted in the same location as the Jolokia agent, use url = "service:jmx:rmi:///jndi/rmi://localhost:5002/jmxrmi"

      2. Change the [[inputs.jolokia2_proxy]] url = "http://jetty_ip:8080/jolokia" to reflect the IP where you deployed the Jetty / Jolokia.

   5. Save the config file

   6. Register the Telegraf agent as a service and start it(see instructions per OS). With Windows use

      \telegraf.exe service install --config "C:\Program Files\InfluxData\telegraf\eyer_agentless_telegraf.conf"

   7. Start the Telegraf service.