oscillo 1.0.0

Record the system load at the execution of the command line and display it graphically

oscillo

记录命令执行过程中对系统产生的负载，以图片的形式展现出来

Record the system load at the execution of the command line and display it graphically

安装方式 / Installation

• Install from pypi

pip install oscillo

• Install from local

python setup.py install

使用方式 / Usage

通过命令行参数启动 / Boot start by command line parameter

命令行参数的格式是 "<name>: <command [args]>"：

• name: 命令行的别名/id (任意字符串)，当--commands/-c参数指定多个命令时，该值将作为命令的唯一标识，不可重复
• command [args]: 需要测试资源消耗的命令，比如 gzip file.ext

示例如下，监控gzip压缩一个文件时耗费的cpu、memory和时间：

oscillo -c 'gzip: gzip file.ext' -o output-file

• -c 代表将执行一个linux cmd 命令。参数后面可以跟以空格隔开的多个参数

• -o 结果输出文件:

命令执行完成后，会在当前目录下生成一个<output-file>.log 文件。文本结构是json 格式. 数据结构如下

{
  "test": {
            "elapsed": 0.022143125534057617,  //总执行时间
            "cpu": [], 
            "memory": []
          }
}

同时会产生一个<output-file>.png文件，<output-file>由-o参数指定，默认值为metrix

-c/--commands 可以接受多个参数，以空格隔开，任务会线性执行。使用场景：对比多个命令对资源的消耗

e.g.: 对比gzip和tar命令对资源的消耗：

oscillo -c 't1: gzip file.ext'  't2: tar czf target.tar.gz file1' -o output

在控制台上，oscillo会打印summary信息，其中包含命令的耗时、最大内存使用、最大cpu使用、退出码等，效果如下：

通过配置文件启动 / Boot start by config file

当命令很长或者很多时，可以使用配置文件启动 Whe the commands is too many, you can boot start by config file

oscillo --config </path/to/config-file.yml> [-g]

配置文件模板 / Config file

The command line in commands will be executed in order

# Demo
commands:
  -
    name: gzip
    cmd: gzip big-file

  -
    name: tar
    cmd: tar -zcf tmp.tar.gz big-file

output: gzip-and-tar-gz