Select the machine on which you want to supply Fluentd.

Wait until the compilation process has been finished.

First find the reference of your IOT Gateway.

It is located in your Slapos Dashboard in Servers tab.

Then using supply command of Slapos Client install Fluentd software release on that computer.

supply("https://lab.nexedi.com/nexedi/slapos/raw/master/software/fluentd/software.cfg", "YOUR_COMPUTER_ID")

About Fluentd configuration file you can learn from here.

For input plugin we use Fluentd's standard forward plugin.

For output we use our custom output plugin called wendelin.

YOUR_TAG_NAME - it must consist of two parts separated by .(dot). For example sensor_1.sample-environment-raw-data. First part (sensor_1) is the name of the sensor and must be the same as the reference of the Data Supply we created in HowTo Create Data Supply tutorial. The second part (sample-environment-raw-data) is the type of data (Data Product  -  HowTo Create Data Product).

streamtool_uri - is the URL of the Wendelin instance created in HowTo Request ipv4 frontend with Ciphers tutorial. 

username and password  of that instance you can find in Connection Information tab of your webrunner as described in HowTo Install Wendelin on Webrunner.

We also use file buffering plugin for fluentd. 

For path give a relative path to a directory where you want to store buffer files.  

flush_interval 1m  means that data will be flushed to wendelin every minute. 

Click on the Add button.

Enter a title for your Fluentd instance.

Fill in the Fluentd configuration parameters in the Configuration field.

<source>
@type forward
port 24224
bind ::0
</source>
<match YOUR_TAG_NAME>
@type wendelin
streamtool_uri https://softinstXXXX.host.vifib.net/erp5/portal_ingestion_policies/default
user      zope
password  *****
<buffer>
flush_mode interval
@type file
path fluentd-buffer-file/
flush_interval 1m
</buffer>
</match>

Don't forget to correctly fill in your tag name, instance URL and so on.

Finally, click Proceed to request the instance.

As the fluentd configuration has many parameters for convenience we will write a short python script which will request the instance, instead of calling request function from Slapos Client.  

Create a python script and name it request_fluentd.py and copy/paste the presented code. 

** Don't forget to correctly fill in your computer reference, Instance name, url etc. 

As we are requesting instance of fluentd for the same computer the reference is the same as when we were supplying the software.

"YOUR_INSTANCE_NAME" -  give your instance a distinguishing name so you can later easily find it. For example IOT-Gateway-Tutorial-Fluentd.

Once it's ready run it by calling following command : 

This step can take some time.  

In your SlapOS dashboard you can see your newly requested instance.

The instance is ready when the the Monitoring Status is green.

Note that the Fluentd configuration parameters we defined earlier can be found and edited in the Parameter Form section.

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