/ 
IBM-StorageSystem-0.043
River stage one • 3 direct dependents • 3 total dependents
/ IBM::StorageSystem::Statistic::Node::DiskRead

NAME

IBM::StorageSystem::Statistic::Node::DiskRead - Utility class for IBM::StorageSystem node disk read statistics

SYNOPSIS

IBM::StorageSystem::Statistic::Node::DiskRead is a utility class for IBM::StorageSystem node DiskRead statistics.

An IBM::StorageSystem::Statistic::Node::DiskRead object represents a collection of statistical measurements for disk read operations for the specified node during a single interval period.

The interval period is defined by the interval parameter passed on invocation to the specific parent class.

METHODS

start_time

The start time of the interval over which the data was collected in the format 'YYYY-MM-DD HH:MM:SS UTC+HH'.

end_time

The end time of the interval over which the data was collected in the format 'YYYY-MM-DD HH:MM:SS UTC+HH'.

DATA METHODS

device_n

Returns the read operations for the specified device.

Note that the method name device_n used above is a variable method name that is dynamically created dependent on the system type and architecture.

The device name will be the same as the system device name to which GPFS disks are mapped - for example; for SONAS IBM storage system architectures, GPFS disks are mapped to multipath devices (/dev/dm-*) and so for each multipath devicemapper device, a new method will be created using the device name.

# For example; to retrieve a list of the device names (and hence, the methods available),
# invoke the 'values' method on the IBM::StorageSystem::StatisticsSet object retrieved
# from a 'disk_reads' invocation;

my $read_stats = $ibm->node('mgmt001st001')->disk_reads;
print "Methods available:\n", join "\n", sort $read_stats->values;

# Prints:
# Methods available:
# dm_0
# dm_1
# dm_10
# dm_11
# dm_12
# dm_13
# ...

Note that any hyphens in the device name will be replaced by an underscore.

AUTHOR

Luke Poskitt, <ltp at cpan.org>

BUGS

Please report any bugs or feature requests to bug-ibm-v7000-statistic-node-diskread at rt.cpan.org, or through the web interface at http://rt.cpan.org/NoAuth/ReportBug.html?Queue=IBM-StorageSystem-Statistic::Node::DiskRead. I will be notified, and then you'll automatically be notified of progress on your bug as I make changes.

SUPPORT

You can find documentation for this module with the perldoc command.

perldoc IBM::StorageSystem::Statistic::Node::DiskRead

You can also look for information at:

LICENSE AND COPYRIGHT

Copyright 2012 Luke Poskitt.

This program is free software; you can redistribute it and/or modify it under the terms of either: the GNU General Public License as published by the Free Software Foundation; or the Artistic License.

See http://dev.perl.org/licenses/ for more information.