resource_monitor_histograms(1)
NAME
resource_monitor_histograms - create pages and graphs of resource monitor data
SYNOPSIS
resource_monitor_histograms [options] -D monitor_data_directory output_directory [workflow_name]
resource_monitor_histograms [options] -L monitor_data_file_list output_directory [workflow_name]
resource_monitor_histograms [options] output_directory < monitor_data_file_list [workflow_name]
DESCRIPTION
resource_monitor_histograms is a tool to visualize resource usage as
reported by resource_monitor. resource_monitor_histograms expects
its input to be a directory with resource summary files (with the -D option),
or a file listing the paths of summary files (-L option or from standard
input). Results are written to output_directory in the form of several
webpages showing histograms and statistics per resource.
ARGUMENTS
Input Options
-D <monitor_data_directory> |
| Directory with resource summaries. All files with a .summary extension are read. Subdirectories are read recursevely.
|
-L <monitor_data_file_list> |
| File with one summary file path per line.
|
Output Options
output_directory <> |
| The path in which to store the visualizations. See index.html for the root of the visualization.
|
workflow_name | Optional name to include to describe the workflow being visualized.
|
s | Generate histograms per task categories. Requires the summary files to have the field category
|
-f <str> |
| Select which fields for the histograms. Each field is represented by a single character. Default is: tcvmsrwhz. The available fields are:
|
t: wall time
c: cpu time
v: virtual memory
m: resident memory
s: swap memory
r: read bytes
w: written bytes
n: num files
z: footprint
Debugging Options
-d,--debug <subsystem> |
| Enable debugging for this subsystem.
|
-o,--debug-file <file> |
| Write debugging output to this file. By default, debugging is sent to stderr (":stderr"). You may specify logs be sent to stdout (":stdout"), to the system syslog (":syslog"), or to the systemd journal (":journal").
|
--verbose | Display runtime progress on stdout.
|
EXAMPLES
Most common usage:
% resource_monitor_histograms -D my_summary_files_directory my_histograms my_workflow_name
% # open my_histograms/index.html
Splitting on categories, generating only memory related histograms:
% resource_monitor_histograms -s -fvms -D my_summary_files_directory my_histograms my_workflow_name
% # open my_histograms/index.html
COPYRIGHT
The Cooperative Computing Tools are Copyright (C) 2003-2004 Douglas Thain and Copyright (C) 2005-2015 The University of Notre Dame. This software is distributed under the GNU General Public License. See the file COPYING for details.
CCTools 5.4.4 [FINAL:1c6900ba] released on