Boomi - Data collector install - Windows installer script version

Owned by Iheanacho Amarachi
Last updated: Aug 13, 2024
3 min read

All components for collecting metrics from the Atoms and transmitting data to Eyer can be deployed to a separate host (for test-setups, all components can be deployed to the Atom host).

The Eyer connector needs to collect and learn from your atom's data to identify normal and abnormal behaviors. To get started, follow this installation guide:

  1. Log in to your Boomi AtomSphere account and select your Atom. Navigate to the Properties -> Advanced tab to add and expose the following JMX ports on your Atom:

    • JMX Remote Port -> Property Value of 5002

    • JMX Remote RMI Port -> Property Value of 5002

    • JMX Remote SSL -> Disable this property by leaving its property value checkbox unchecked

    • JMX Remote Authentication -> Disable this property by leaving its property value checkbox unchecked

  2. Save the changes and restart your atom.

  3. Open your PowerShell terminal as an Administrator.

  4. Run this command to download Telegraf, Jetty, and Jolokia. After downloading, the command will deploy Jolokia on the Jetty server.

iex ((New-Object System.Net.WebClient).DownloadString('https://raw.githubusercontent.com/eyer-development/public-boomi-scripts/master/win-agentless-installer.ps1'))

To check that Jolokia is properly deployed, go to http://localhost:8080/jolokia/.

Screenshot 2024-06-19 at 20.53.26.png

  1. The command above opens up the Telegraf folder in your file explorer, usually located in %AppData%\Roaming\eyer\telegraf directory.

  2. In your Telegraf folder, open up the telegraf.conf file and make the following edits:

  • Locate the [outputs.http.headers] section. In this section, replace the authenticate field's value with your Eyer agent API token.

[outputs.http.headers] authenticate = "your_api_key"

  • Duplicate the [[inputs.jolokia2_proxy]] section and all metrics for each Atom you wish to monitor. If you're monitoring only one Atom, do not duplicate.

  • Edit each of the URLs to reflect your Jolokia IP address. Replace the x.x.x.x path in the URL with the IP address of the host holding the Jolokia agent.  

 # # Read JMX metrics from a Jolokia REST agent endpoint       [[inputs.jolokia2_proxy]]         url = "http://x.x.x.x:8080/jolokia"

 

  • Next, edit the URLs in the [[inputs.jolokia2_proxy.target]] section to reflect the IPs where your atoms are hosted.  If you only monitor a single atom, and your Telegraf agent is hosted in the same location as the Jolokia agent, replace the x.x.x.x with localhost as shown below:

However, if your agents and atom(s) are hosted in different locations, replace the x.x.x.x path in the URL with your Boomi Atom's IP address.  

  1. Save the changes made to the telegraf.conf file.

  2. Next, use this command to change your current directory into the Telegraf directory containing the telegraf.conf and telegraf.exe files.

  1. Next, install the Telegraf agent as a service in your Powershell terminal.   

  1. Run this command to test your Telegraf installation. If successful, you'll see your Atom metrics.

Screenshot 2024-06-19 at 20.49.07.png

  1. Start Telegraf as a service using this command:

  1. Check if your Telegraf service is running using this command:

Â