Boomi - process monitoring - Install collector

Owned by Marius Wergeland Storsten
Last updated: Nov 14, 2024
2 min read

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.

character_encoding = "utf-16le"

Step 1

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

  • Token

  • Boomi account Id which you can find after logging in at Boomi AtomSphere under “Settings » Account Information”

  • username (in the form “BOOMI_TOKEN.<username>”)

Step 2

  1. For the server or container hosting Telegraf

    1. download and install the Influx Telegraf agent that corresponds to your OS atInfluxData Downloads

    2. Copy the Telegraf_Boomi_Processes.conf file 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” sections of the config file there are fields with the name “authenticate”. Place your Eyer agent API token here.

      2. In the “inputs.exec” sections of the config file there are fields with the name “commands”. Insert the path to your Telegraf folder and PowerShell script here (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)

        commands = ['powershell -command "& { . C:\telegraf-1.31.2_windows_amd64\telegraf-1.31.2\BoomiProcesses.ps1; RegularProcess }"']

      3. In the “inputs.file” sections, make sure to add the path to your telegraf folder as shown below (NOTE! Forward slashes).

        files = ["C:/telegraf-1.31.2_windows_amd64/telegraf-1.31.2/Transactions*.json"]

      4. Save the Telegraf config file

    5. 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

      2. Save the PowerShell file

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

    7. Start the Telegraf service.