Skip to content

eerimoq/bunga

Repository files navigation

buildstatus coverage

Bunga

Control and monitor your system.

Project homepage: https://github.com/eerimoq/bunga

Installation

$ pip install bunga

The shell subcommand

Connect to your system (in this case the Monolinux example project) and execute the df command.

https://github.com/eerimoq/bunga/raw/master/docs/shell.png

The log subcommand

Stream logs from your system to your PC.

https://github.com/eerimoq/bunga/raw/master/docs/log.png

The plot subcommand

Plot any command output over time. The plot below shows the CPU load.

$ bunga plot cpu

https://github.com/eerimoq/bunga/raw/master/docs/plot.gif

Press h or ? to show the help.

Define plots in ~/.bunga-plot.json.

{
    "cpu": {
        "title": "CPU [%]",
        "command": "cat proc/stat",
        "pattern": "cpu\\s+\\d+\\s+\\d+\\s+\\d+\\s+(\\d+)",
        "algorithm": "delta",
        "interval": 2,
        "timespan": 60
        "scale": -1,
        "offset": 100,
        "y-min": 0,
        "y-max": 100
    },
    "uptime": {
        "title": "Uptime [s]",
        "command": "cat proc/uptime",
        "max-age": 600
    }
}

The execute subcommand

Execute given command, ls in the example below, and print its output.

$ bunga execute ls
mnt etc proc init root dev

The get_file subcommand

Get a file from your system.

$ bunga get_file README.rst
100%|█████████████████████████████████████| 1.19k/1.19k [00:00<00:00, 74.1kB/s]

The put_file subcommand

Put a file on your system.

$ bunga put_file README.rst
100%|█████████████████████████████████████| 1.19k/1.19k [00:00<00:00, 24.1kB/s]