NAME

       resource_monitor_histograms - create HTML pages and graphs of resource monitor data

SYNOPSIS

       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 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
        -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.

        -f <str>
              Select  which  fields for the histograms. Default is "cores,memory,disk". Available
              fields are:

               bandwidth
               bytes_read
               bytes_received
               bytes_send
               bytes_written
               cores
               cpu_time
               disk
               max_concurrent_processes
               memory
               swap_memory
               total_files
               total_processes
               virtual_memory
               wall_time

   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:

               % find my_summary_files_directory -name "*.summary" > summary_list
               % resource_monitor_histograms -L summary_list my_histograms my_workflow_name
               % # open my_histograms/index.html

       Splitting on categories, generating only resident memory related histograms:

               % resource_monitor_histograms -f memory -L summary_list 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.