makeflow_monitor(1)

πŸ“¦
version 9.9 Β· 3 versions
, in debian bookworm, ubuntu jammy, ubuntu noble

πŸ’– makeflow_monitor(1) β€” the Makeflow log monitor, bestie edition πŸ’–

okay so picture this: you're running a whole workflow and you just want to watch it happen, live, like it's a reality show. that's this page. it lives in section 1 of the manual for the Cooperative Computing Tools, and it's about to become your new hyperfixation. ✨


🌸 NAME 🌸

makeflow_monitor β€” the Makeflow log monitor. she watches, she reports, she slays. πŸ’…


πŸ¦‹ SYNOPSIS πŸ¦‹

makeflow_monitor [options] <makeflowlog>

✨ DESCRIPTION ✨

so makeflow_monitor is a simple Makeflow log monitor β€” not complicated, not doing too much, just giving you the progress and the statistics of a workflow based on the <makeflowlog> you hand her. 🫢

and once she's started? she does not stop. she will continually monitor the <makeflowlog>s you gave her for new events and keep updating that progress display. it's giving loyal. it's giving devoted. it's giving main character energy. πŸ‘‘


πŸ’… OPTIONS πŸ’…

  • -h β€” show the help message and dip. that's it. that's the whole thing. exit stage left. πŸŽ€
  • -f <format> β€” the output format to emit.
  • -t <seconds> β€” timeout for reading the logs. give her a time limit, she respects it.
  • -m <minimum> β€” minimum number of tasks. (the original spells it "Mininum", but we're not gonna be weird about it β€” the number is what matters. πŸ™ˆ)
  • -S β€” sort logs by progress. organized queen. ⭐
  • -P β€” parse dag for node information. (more on her below, and bestie… it's a whole thing. 😭)
  • -H β€” hide finished makeflows. out of sight, out of mind, no notes. 🌈

right now, the only <format> that's supported is "text", which means makeflow_monitor will just display the progress of the workflows straight to your console. simple. clean. iconic.

and also β€” and I need you to hear this β€” the -P parameter currently does not do anything. like, it's there, it's parsed, it's just… vibing. no cap. πŸ’€


πŸ”₯ EXIT STATUS πŸ”₯

  • success? returns zero. we love a happy ending. πŸ₯³
  • failure? returns non-zero. she's telling you something went wrong, okay, listen to her. 😭

🧚 EXAMPLES 🧚

monitor one single Makeflow log, just the two of you:

makeflow_monitor Makeflow.makeflowlog

monitor multiple Makeflow logs and hide the finished workflows:

makeflow_monitor -H */*.makeflowlog

monitor multiple Makeflow logs under the current directory and only show the ones that are currently running with a minimum of 4 tasks:

find . -name '*.makeflowlog' | xargs makeflow_monitor -m 4 -H
the example right above this? absolute banger for hierarchical workflows. iykyk. πŸ“

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.

(legal text, but make it respectful β€” shoutout Notre Dame, shoutout the GPL, shoutout COPYING. πŸ’œ)


πŸŽ€ SEE ALSO πŸŽ€


and that's the whole page, bestie!! πŸ¦‹ this was CCTools 8.0.0 DEVELOPMENT β€” go monitor something and text me when it finishes, mwah πŸ’‹βœ¨

πŸ“¦ where this page comes from