resource_monitor_histograms(1)

resource_monitor_histograms - create HTML pages and graphs of resource monitor data

Section 1 coop-computing-tools bookworm source

Description

resource_monitor_histograms

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 to be sent to stdout (":stdout") instead.

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