Wendelin Home Wendelin

    Wendelin - HowTo setup Fluentd on IOT Gateway

    HowTo setup Fluentd on IOT Gateway
    • Last Update:2025-05-27
    • Version:006
    • Language:

    Agenda

    • Request Fluentd instance for IOT Gateway
    • Learn configuration parameters for Fluentd

    This tutorial teaches how to setup Fluentd on IOT Gateway. 

    Prerequisites

    Before doing this tutorial make sure you have read and completed the following tutorials:

    IMPORTANT: In order to successfully request a Fluentd instance, you will need to have a validated Allocation Supply in your project with the following configuration:

    • Software Product: The latest Fluentd software release with the default software type
    • Compute Node: the Node corresponding to your Olimex IoT Gateway

    The Software Product should already be ready for you to use, no need to create it.

    If you wish to know more about the configuration of Fluentd, you can find the official documentation here: Fluentd Configuration File.

    Request Fluentd instance for IOT Gateway

    Step 1: Request instance

    Please click on "Request" menu at left side of the page as shown on image below.

    This will redirect you to your project page where you will have to select the appropriate project.

    After selecting the project will will be given option to choose the product you want to install. In this case it is fluentd.

    Finally you will be redirected to your new instance where you will need to specify the needed instance parameters.

    The following actions need to be performed:

    1. Set an instance title in the Title field (in this example it is Olimex.Gateway)
    2. In the Parameter Form, fill in the instance parameters with the corresponding values according to the list and the parameter table below:
      • Enable TLS transport: (leave the default value)
      • Bind address: <FLUENTD-GATEWAY-IPv4>
      • Port: (leave the default value)
      • Tag prefix: (leave empty)
      • Tag matching pattern: *.sample-environment-raw-data
      • Wendelin ingestion URL: https://softinst<INSTANCE_ID>.host.vifib.net/erp5/portal_ingestion_policies/default
      • Wendelin account username: <USERNAME>
      • Wendelin account password: <PASSWORD>
      • Buffer flushing interval: 5s

      Parameter table:

      FLUENTD-GATEWAY-IPv4 The IPv4 address which fluentd gateway will bind to. Usually something like 192.168.x.x
      INSTANCE_ID The frontend instance ID using which one access Wendelin itself. Usually a number.
      USERNAME Your Wendelin username. By default it is "zope".
      PASSWORD Your Wendelin password.
    3. In the Computer dropdown list, choose the COMP identifier that corresponds to your Olimex IoT Gateway Node.
    4. Click on the Request button at the bottom of the page. Your instance will be created automatically and its status will be visible from the Service tab on the left side of the screen.

    Step 2: Monitor instantiation of your instance

    You can monitor the instantiation process by running

    tail -f /opt/slapos/log/slapos-node-instance.log

    on the corresponding machine.

    Fluentd Instance

    This step can take some time.

    In your SlapOS dashboard you can see your newly requested instance, which will be ready when the the Monitoring Status goes from red to green.

    NOTE: the Fluentd configuration parameters we defined earlier can be viewed and edited through the Update Parameter action in the panel on the left of the screen.

    Step 3: Control (start / stop) IOT Gateway

    Login to your IOT Gateway and run the following command :

    sudo slapos node status

    You see that a new service for Fluentd is added.

    And the generated fluented configuration file is located here :

    /srv/slapgrid/slappartX/etc/fluentd-agent.conf

    Now your IOT Gateway is ready to receive data and to forward it to Wendelin.