Streamlets

Another powerful feature of roBob are the streamlets. They are re-usable script fragments that run in parallel with the main application in order to collect auxiliary information.

For example, you can run uptime while your application is running in order to measure the system load while your application is running. In a similar manner you could run free in order to monitor the evolution of the memory usage.

Defining

A streamlet is defined in the streamlets configuration section and it has the following basic syntax:

streamlets:
   - name: my_streamlet
     script: |
        while true; do
           # Collect the metric and echo it's measurement
           uptime
           # Add some delay
           sleep 1
        done

The contents of the script property is a bash code fragment that should echo it's measurements.