vine_graph_log(1)

NAME

vine_graph_log - plots TaskVine performance logs.

SYNOPSIS

FCvine_graph_log [options] vine-perf-logFT

DESCRIPTION

vine_graph_log is a script to plot some of the statistics from a TaskVine log, as generated by FCvine_enable_perf_logFT from the C API, or by FCq.enable_perf_logFT from the Python API. It assumes the availability of FCgnuplotFT.

vine_graph_log generates four plots, all with FCtimestampFT as the independent variable:

FCtimeFT:
timestamp, total_send_time, total_receive_time, total_transfer_time, and total_manager_time. (The last two generated by the script, not in the log.)

FCtime-logFT:
log-scale version of FCtimesFT, plus total_execute_time.

FCtasksFT:
total_tasks_waiting, total_tasks_running, total_workers_connected, total_workers_busy, and total_cores

FCtasks-logFT:
log-scale version of FCtasksFT, plus total_complete_tasks.

OPTIONS

-o <prefix-output>: Generate prefix-output.{time,time-log,tasks,tasks-log}.<output-format>. Default is <work-queue-log>.

-o <prefix-output>: Generate prefix-output.{time,time-log,tasks,tasks-log}.<output-format>. Default is <work-queue-log>.

-c <gnuplot-path>: Specify the location of the gnuplot executable. Default is gnuplot.

-r <range>: Range of time to plot, in time units (see -u) from the start of execution. Of the form: min:max, min:, or :max.

-T <output-format>: Set output format. Default is png. If "text", then the gnuplot scripts are written instead of the images.

-u <time-unit>: Time scale to output. One of s,m,h or d, for seconds, minutes (default), hours or days.

-h: Show help text.

EXAMPLES

General use:

: % vine_graph_log mylog % ls mylog*.png mylog.tasks.png mylog.tasks-log.png mylog.time.png mylog.time-log.png

Plot up to the eleventh hour:

: % vine_graph_log -u h -r :11 mylog

Generate script text:

: % vine_graph_log -Ttext mylog % ls mylog*.gnuplot mylog.tasks.png.gnuplot mylog.tasks-log.png.gnuplot mylog.time.png.gnuplot mylog.time-log.png.gnuplot

Specify gnuplot path:

: % vine_graph_log -c/some/dir/bin/gnuplot mylog

BUGS