Quick start

Command tine run

Define a simple pipeline description in a TOML file.

Copy the example below and save it as cpu.toml.

[[inlets.cpu]]
    interval = "3s"
[[flows.select]]
    includes = ["**"]
[[outlets.file]]

Run tine passing the cpu.toml path as argument.

tine run ./cpu.toml

Press ^C to stop.

cpu,1722171230,8.305903745046313
cpu,1722171233,11.401743796163146
cpu,1722171236,9.507754551438795
cpu,1722171239,8.965748824811843
^C

TINE prints out a CSV line per every 3 seconds until it is stopped by pressing ^C.

Each line in the content represents the "cpu" inlet, which generates data consisting of a timestamp in UNIX epoch time and the corresponding system CPU usage percentage.

Add format="json" at the end of the file, it changes the out outlets.file applying JSON format instead of CSV which is default.

[[outlets.file]]
    format = "json"

{"_in":"cpu","_ts":1722171856,"total_percent":8.296722122944592}
{"_in":"cpu","_ts":1722171859,"total_percent":5.32841823082893}
{"_in":"cpu","_ts":1722171862,"total_percent":5.522088353490716}
{"_in":"cpu","_ts":1722171865,"total_percent":4.525645323428138}
^C

Using shebang

Edit the cpu.toml file and add the following line at the beginning: #!/path/to/tine run. Replace /path/to/tine with the actual path to the tine executable file on your system.

#!/usr/local/bin/tine run
[[inlets.cpu]]
    interval = "3s"
[[flows.select]]
    includes = ["**"]
[[outlets.file]]

The chmod +x cpu.toml to make it executable.

Run

$./cpu.toml
{"_in":"cpu","_ts":1722172333,"total_percent":8.287984091499398}
{"_in":"cpu","_ts":1722172336,"total_percent":6.224899598711208}
{"_in":"cpu","_ts":1722172339,"total_percent":5.395442359208408}
^C