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'))
To check that Jolokia is properly deployed, go to http://localhost:8080/jolokia/.
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. 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 thex.x.x.x
with localhost:
[[inputs.jolokia2_proxy.target]] url = "service:jmx:rmi:///jndi/rmi://localhost:5002/jmxrmi"
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.
[[inputs.jolokia2_proxy.target]] url = "service:jmx:rmi:///jndi/rmi://x.x.x.x: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