catalog_history_plot(1)

NAME

catalog_history_plot - command line tool that returns easily plottable data from the output of catalog_history_select or catalog_history_filter.

SYNOPSIS

catalog_history_plot [granularity] [summaries]

DESCRIPTION

catalog_history_plot is a tool that returns the status (or checkpoint) for a specified start time, and all following log data until a specified end time...

ARGUMENTS

granularity The number of seconds between each summarized value in the output.
summaries Any number of arguments specifying what status information should be summarized and how to do so. These arguments start with an interseries aggregation operator, followed by an intraseries aggregation operator, followed by the field to evaluate. For example SUM.AVG@memory_avail, says to look at the values for the memory_avail field, average all values for a series that occured within the specified 'grain', and sum the series averages to obtain a single value for that 'grain' of time. Available intraseries operators are: MAX,MIN,AVG,FIRST,LAST,COUNT,INC,LIST. Available interseries operators are: SUM. .

EXAMPLES

To show the distribution for task_running values within 1 hour time periods:
% catalog_history_plot 3600 SUM.MIN@task_running SUM.AVG@task_running SUM.MAX@task_running
To show the distribution of daily values describing memory:
% catalog_history_plot 86400 SUM.MAX@memory_total SUM.AVG@memory_avail SUM.MIN@minfree
To see full results using all catalog history tools:
% catalog_history_select /data/catalog.history/ 2013-04-15-01-01-01 w1 | catalog_history_filter type=wq_master | catalog_history_plot 3600 SUM.MIN@task_running SUM.AVG@task_running SUM.MAX@task_running

COPYRIGHT

The Cooperative Computing Tools are Copyright (C) 2003-2004 Douglas Thain and Copyright (C) 2005-2011 The University of Notre Dame. This software is distributed under the GNU General Public License. See the file COPYING for details.

SEE ALSO

  • The Cooperative Computing Tools
  • Catalog History User's Manual
  • catalog_history_select(1)
  • catalog_history_filter(1)

  • CCTools 4.2.0rc1 released on 05/28/2014