.TH "makeflow_monitor" 1 "" "CCTools 8.0.0 DEVELOPMENT" "Cooperative Computing Tools"

.SH NAME
.LP
\fBmakeflow_monitor\fP - Makeflow log monitor

.SH SYNOPSIS
.LP
\FC\fBmakeflow_monitor [options] <makeflowlog>\fP\FT

.SH DESCRIPTION
.LP
\FCmakeflow_monitor\FT is simple \fBMakeflow\fP log monitor that displays the
progress and statistics of a workflow based on the provided <makeflowlog>.
Once started, it will continually monitor the specified <makeflowlogs> for
new events and update the progress display.

.SH OPTIONS
.LP
.LP
.TP
.B \ -h
.
Show this help message and exit.
.TP
.BI \ -f \ <format>
.
Output format to emit.
.TP
.BI \ -t \ <seconds>
.
Timeout for reading the logs.
.TP
.BI \ -m \ <minimum>
.
Mininum number of tasks.
.TP
.B \ -S
.
Sort logs by progress.
.TP
.B \ -P
.
Parse dag for node information.
.TP
.B \ -H
.
Hide finished makeflows.

.PP
Currently, the only supported <format> is "text", which means
\FCmakeflow_monitor\FT will display the progress of the workflows directly to
the console.
.PP
Additionally, the \FC-P\FT parameter current does not do anything.

.SH EXIT STATUS
.LP
On success, returns zero.  On failure, returns non-zero.

.SH EXAMPLES
.LP
Monitor a \fBMakeflow\fP log:
.fam C
.nf
.nh
.IP "" 8
makeflow_monitor Makeflow.makeflowlog
.fi
.hy
.fam
.P
Monitor multiple \fBMakeflow\fP logs and hide finished workflows:
.fam C
.nf
.nh
.IP "" 8
makeflow_monitor -H */*.makeflowlog
.fi
.hy
.fam
.P
Monitor multiple \fBMakeflow\fP logs under current directory and only display
currently running workflows with a minimum of 4 tasks:
.fam C
.nf
.nh
.IP "" 8
find . -name '*.makeflowlog' | xargs makeflow_monitor -m 4 -H
.fi
.hy
.fam
.P
The example above is useful for hierarchical workflows.

.SH COPYRIGHT
.LP
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.

.SH SEE ALSO
.LP

.IP \(bu 4
\fBCooperative Computing Tools Documentation\fP
.IP \(bu 4
\fBMakeflow User Manual\fP
.IP \(bu 4
\fBmakeflow(1)\fP \fBmakeflow_monitor(1)\fP \fBmakeflow_analyze(1)\fP \fBmakeflow_viz(1)\fP \fBmakeflow_graph_log(1)\fP \fBstarch(1)\fP \fBmakeflow_ec2_setup(1)\fP \fBmakeflow_ec2_cleanup(1)\fP \fBmakeflow_ec2_estimate(1)\fP