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:
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
Save the changes and restart your atom.
Open your PowerShell terminal as an Administrator.
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'))
The command above opens up the Telegraf folder in your file explorer, usually located in
%AppData%\Roaming\eyer\telegraf
directory.In your Telegraf folder, open up the
telegraf.conf
file and make the following edits:
Locate the
[outputs.http.headers]
section. Replace the authenticate field's value with your Eyer agent API token in this section.
[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 your Jolokia IP address.
# # 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. Replace thex.x.x.x
path with your Boomi Atom's IP address in the URL.
[[inputs.jolokia2_proxy.target]] url = "service:jmx:rmi:///jndi/rmi://x.x.x.x:5002/jmxrmi"
If you only monitor a single atom, and your Telegraf agent is hosted in the same location as the Jolokia agent, use this URL:
[[inputs.jolokia2_proxy.target]] url = "service:jmx:rmi:///jndi/rmi://localhost:5002/jmxrmi"
Save the changes made to the
telegraf.conf
file.Next, use this command to change your current directory into the Telegraf directory containing the
telegraf.conf
andtelegraf.exe
files.
cd "C:\Program Files\InfluxData\telegraf"
Next, install the Telegraf agent as a service in your Powershell terminal.
.\telegraf.exe --service install ` --config "C:\Program Files\InfluxData\telegraf\telegraf.conf"
Run this command to test your Telegraf installation. If successful, you'll see your Atom metrics.
.\telegraf.exe ` --config C:\"Program Files"\InfluxData\telegraf\telegraf.conf --test
Start Telegraf as a service using this command:
.\telegraf.exe --service start
Check if your Telegraf service is running using this command:
Get-service Telegraf