---
name: "work_queue_graph_log"
section: "1"
platform: "linux"
package: "coop-computing-tools"
version: "1:7.14.5-1+b2"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/work_queue_graph_log"
---

# work\_queue\_graph\_log(1)

plots Work Queue statistics logs.

## NAME

**work\_queue\_graph\_log** - plots Work Queue statistics logs.

## SYNOPSIS

FCwork\_queue\_graph\_log \[options\] work-queue-logFT

## DESCRIPTION

**work\_queue\_graph\_log** is a script to plot some of the statistics from a Work Queue log, as generated by FCwork\_queue\_specify\_logFT from the C and Perl Work Queue APIs, or by FCq.specify\_logFT from the Python Work Queue API. It assumes the availability of FCgnuplotFT.

**work\_queue\_graph\_log** generates four plots, all with FCtimestampFT as the independent variable:

FCtimeFT:\
     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.)

FCtime-logFT:\
     log-scale version of FCtimesFT, plus total\_execute\_time.

FCtasksFT:\
     total\_tasks\_waiting, total\_tasks\_running, total\_workers\_connected, total\_workers\_busy, and total\_cores

FCtasks-logFT:\
     log-scale version of FCtasksFT, plus total\_complete\_tasks.

## 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\>*.

- **-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) 2022 The University of Notre Dame.  This software is distributed under the GNU General Public License.  See the file COPYING for details.