vine_graph_log(1)

📦
version 7.15.9 · 2 versions
, in ubuntu resolute, ubuntu stonking

🌸 vine_graph_log — bestie edition 💅

ok so you found vine_graph_log, a lil script in the Cooperative Computing Tools that plots your TaskVine performance logs. iykyk. it's in section 1 of the manual, and honestly? it ate. 🎀

✨ NAME ✨

vine_graph_log — plots TaskVine performance logs. that's it, that's the whole job, and it does it gorgeously. 🦋

✨ SYNOPSIS ✨

vine_graph_log [options] vine-perf-log

✨ DESCRIPTION ✨

so vine_graph_log is a script that plots some of the statistics from a TaskVine log — the kind you get from vine_enable_perf_log in the C API, or from q.enable_perf_log in the Python API. it assumes you have gnuplot available, so like… make sure your girl is installed first fr fr. 🙈

vine_graph_log generates four plots, and every single one of them uses timestamp as the independent variable:

  • time: — timestamp, total_send_time, total_receive_time, total_transfer_time, and total_manager_time. (the last two are generated by the script, not in the log — the script is doing extra credit work, we love that for her 👑)
  • 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.

four plots, zero drama. periodt. ✨

✨ 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>.
okay bestie yes it's listed twice in the original, i'm not the one who did that, i'm just the messenger 💀 copy it faithfully and move on.
  • -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, the classic, the icon:

% 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 (cinderella core 🕛):

% vine_graph_log -u h -r :11 mylog

generate script text instead of pics:

% 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 that gnuplot path, bc sometimes she's not where you expect:

% vine_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. like, no thoughts, head empty, just passing it along. 🫶 so yeah, heads up.

the Cooperative Computing Tools are Copyright (C) 2022 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 vibe check, bestie 💖 this page is from CCTools 7.15.9 FINAL — go plot something iconic with vine_graph_log. slay, bye 🎀✨🦋

📦 where this page comes from