work_queue_graph_log(1) | Cooperative Computing Tools | work_queue_graph_log(1) |
NAME¶
work_queue_graph_log - plots Work Queue statistics logs.
SYNOPSIS¶
work_queue_graph_log [options] work-queue-log
DESCRIPTION¶
work_queue_graph_log is a script to plot some of the statistics from a Work Queue log, as generated by work_queue_specify_log from the C and Perl Work Queue APIs, or by q.specify_log from the Python Work Queue API. It assumes the availability of gnuplot.
work_queue_graph_log generates four plots, all with timestamp as the independent variable:
time:
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.)
time-log:
log-scale version of times, plus total_execute_time.
tasks:
total_tasks_waiting, total_tasks_running, total_workers_connected,
total_workers_busy, and total_cores
tasks-log:
log-scale version of tasks, plus total_complete_tasks.
OPTIONS¶
- -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:
-
% work_queue_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:
-
% work_queue_graph_log -u h -r :11 mylog
Generate script text:
-
% work_queue_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:
-
% work_queue_graph_log -c/some/dir/bin/gnuplot mylog
BUGS¶
- •
- Some formats need a special setup for their gnuplot output terminal. -T blindly passes the output format
COPYRIGHT¶
The Cooperative Computing Tools are Copyright (C) 2005-2019 The University of Notre Dame. This software is distributed under the GNU General Public License. See the file COPYING for details.
CCTools 8.0.0 DEVELOPMENT |