Skip to end of metadata
Go to start of metadata

You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 14 Next »

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:

[[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"
  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.

cd "C:\Program Files\InfluxData\telegraf"
  1. Next, install the Telegraf agent as a service in your Powershell terminal.   

.\telegraf.exe --service install `
--config "C:\Program Files\InfluxData\telegraf\telegraf.conf"                
  1. 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
Screenshot 2024-06-19 at 20.49.07.png
  1. Start Telegraf as a service using this command:

.\telegraf.exe --service start
  1. Check if your Telegraf service is running using this command:

Get-service Telegraf
Screenshot 2024-06-19 at 20.46.41.png

  • No labels