Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Info

You will need to setup the Telegraf at a VM / container that has the following rights:

  • HTTPS outbound

Linux specific: if you host the collector on Linux, please remove the lines below from the “inputs.file” sections.

Code Block
character_encoding = "utf-16le"

Step 1

Create an AtomSphere API token. Follow the instructions from Boomi. Note down your

...

  1. For the server or container hosting Telegraf

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

    2. Copy the Telegraf_Boomi_Processes.conffile into the Influx Telegraf folder (the folder should contain the telegraf.exe and the default telegraf.conf file). You can download the configuration file here.

    3. Download the BoomiProcesses.ps1 PowerShell script into your Telegraf folder (same place where you put the Telegraf_Boomi_Processes.conf). You can download the script here

    4. Telegraf configuration

      1. In the

      outputs.http” section
      1. “outputs.http” sections of the config file there

      is a field
      1. are fields with the name “authenticate”. Place your Eyer agent API token here.

      2. In the

      inputs.exec” section
      1. “inputs.exec” sections of the config file there

      is a field
      1. are fields with the name “commands”. Insert the path to your Telegraf folder and PowerShell script here

      .
    5. Save the Telegraf config file

    6. Download the Boomi_processes.ps1 PowerShell script into your Telegraf folder. You can download the script here
      1. (the folder should contain the telegraf.exe and default config file). It should look something like the line below (NOTE! Use the short name version of the folder name if the folder name contains any spaces. In a cmd window you can write “dir /x" to list the short version name of any directory)

        Code Block
        commands = ['powershell -command "& { . C:\telegraf-1.31.2_windows_amd64\telegraf-1.31.2\BoomiProcesses.ps1; RegularProcess }"']
      2. In the “inputs.file” sections, make sure to add the path to your telegraf folder as shown below (NOTE! Forward slashes).

        Code Block
        files = ["C:/telegraf-1.31.2_windows_amd64/telegraf-1.31.2/Transactions*.json"]
      3. Save the Telegraf config file

    7. Powershell script configuration

      1. Open / edit the Boomi_processes.ps1 PowerShell script

        1. Replace all variable in the top section with your AtomSphere API token & username, Boomi account Id and Telegraf path. In your Telegraf path, make sure you have a “\” at the end of the path, like

          Code Block
           $TelegrafPath = 'C:\Program Files\InfluxData\telegraf\telegraf-1.28.2\'
      2. Save the PowerShell file

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

      Code Block
      \telegraf.exe --service install `--config "C:\Program Files\InfluxData\telegraf\telegraf-1.28.2\Telegraf_Boomi_Processes.conf" --service-name BoomiProcess service install
    9. Start the Telegraf service.

...