work_queue_graph_log(1)

📦
version 9.9 · 3 versions
, in debian bookworm, ubuntu jammy, ubuntu noble

💖 work_queue_graph_log — the manual, but make it cute 💖

okay bestie, welcome to work_queue_graph_log(1) from the Cooperative Computing Tools fam 🫶 this is the little script that turns your Work Queue stats logs into actual pretty pictures. let's get into it ✨

✨ NAME ✨

work_queue_graph_log — plots Work Queue statistics logs 📈💅

🌸 SYNOPSIS 🌸

work_queue_graph_log [options] work-queue-log

🦋 DESCRIPTION 🦋

so work_queue_graph_log is a script that plots some of the statistics from a Work Queue log, okay? and like, the log has to be 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 also assumes you've got gnuplot available, no cap — that's literally the whole vibe. 🌈

work_queue_graph_log generates four plots, and every single one of them has timestamp as the independent variable 👑

  • time — timestamp, total_send_time, total_receive_time, total_transfer_time, and total_manager_time. (heads up: the last two are generated by the script, not in the log 👀)
  • time-log — the 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 — the log-scale version of tasks, plus total_complete_tasks.

periodt. four plots. obsessed. 🎀

💅 OPTIONS 💅

  • -o <prefix-output> — generate prefix-output.{time,time-log,tasks,tasks-log}.<output-format>. default is <work-queue-log>. 🍓
  • -c <gnuplot-path> — tell it where the gnuplot executable lives. default is gnuplot.
  • -r <range> — the range of time to plot, in time units (peep -u for those) measured from the start of execution. it's giving: min:max, min:, or :max. ✨
  • -T <output-format> — set the output format. default is png. but if you say "text", then the gnuplot scripts get written instead of the images. lowkey useful ngl.
  • -u <time-unit> — the time scale to output. one of s, m, h or d, for seconds, minutes (default), hours or days. 💜
  • -h — show help text. bestie behavior fr fr.

🌈 EXAMPLES 🌈

general use, the classic:

% 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 instead of images:

% 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 the gnuplot path:

% work_queue_graph_log -c/some/dir/bin/gnuplot mylog

💀 BUGS 💀

not me exposing the flaws but okay, here's the tea:
  • some formats need a special setup for their gnuplot output terminal. -T blindly passes the output format. so like… it does not check. it just sends it. 😭🙈

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.

and that's the whole page bestie, you ate that 💖 this was CCTools 8.0.0 DEVELOPMENT energy, and yes, the manual page really is called work_queue_graph_log(1) — go plot something iconic ✨🌸🦋

📦 where this page comes from