The Perl Toolchain Summit needs more sponsors. If your company depends on Perl, please support this very important event.
 / 
Cisco-UCS-0.33
River stage zero No dependents
1 ++
/ Cisco::UCS::Chassis::Stats

NAME

Cisco::UCS::Chassis::Stats - Class for operations with Cisco UCS chassis power statistics.

SYNOPSIS

        # Print all blades in all chassis along with the chassis current output power
        # and each blades current input power both in watts and as a percentage of
        # the chassis input power level.

        map { 
                my $c_power = $_->stats->output_power;
                printf( "Chassis: %d - Output power: %.3f\n", $_->id, $c_power );
                map {
                        printf( "\tBlade: %d - Input power: %.3f (%.2f%%)\n",
                        $_->id, $_->power_budget->current_power, 
                        ( $c_power == 0 ? '-' : ( $_->power_budget->current_power / $c_power * 100 ) ) ) 
                }   
                sort { $a->id <=> $b->id } $_->get_blades 
        } 
        sort { 
                $a->id <=> $b->id 
        } $ucs->get_chassiss;

        # E.g.
        #
        # Chassis: 1 - Output power: 704.000
        #       Blade: 1 - Input power: 119.000 (16.90%)
        #       Blade: 2 - Input power: 134.000 (19.03%)
        #       Blade: 3 - Input power: 135.000 (19.18%)
        #       Blade: 4 - Input power: 0.000 (0.00%)
        #       Blade: 5 - Input power: 0.000 (0.00%)
        #       Blade: 6 - Input power: 0.000 (0.00%)
        #       Blade: 7 - Input power: 0.000 (0.00%)
        #       Blade: 8 - Input power: 136.000 (19.32%)
        # Chassis: 2 - Output power: 1188.000
        #       Blade: 1 - Input power: 127.000 (10.69%)
        #       Blade: 2 - Input power: 0.000 (0.00%)
        #       Blade: 3 - Input power: 120.000 (10.10%)
        #       Blade: 4 - Input power: 0.000 (0.00%)
        #       Blade: 5 - Input power: 127.000 (10.69%)
        #       Blade: 6 - Input power: 121.000 (10.19%)
        #       Blade: 7 - Input power: 172.000 (14.48%)
        #       Blade: 8 - Input power: 136.000 (11.45%)
        # etc.

DECRIPTION

Cisco::UCS::Chassis::Stats is a class providing operations with a Cisco UCS chassis power statistics.

Note that you are not supposed to call the constructor yourself, rather a Cisco::UCS::Chassis::Stats object is created automatically by method calls on a Cisco::UCS::Chassis object.

METHODS

input_power

Returns the current input power for the chassis.

input_power_avg

Returns the average input power value for the chassis.

input_power_min

Returns the minimum power input value for the chassis.

input_power_max

Returns the maximum power input value for the chassis.

output_power

Returns the current output power value for the chassis.

output_power_avg

Returns the average output power value for the chassis.

output_power_min

Returns the minimum output power value for the chassis.

output_power_max

Returns the maximum output power value for the blade.

thresholded

Returns the input power thresholded state for the blade.

suspect

Returns the input power suspect state for the blade.

time_collected

Returns the timestamp at which time the power statsitics were collected.

AUTHOR

Luke Poskitt, <ltp at cpan.org>

BUGS

Please report any bugs or feature requests to bug-cisco-ucs-chassis-stats at rt.cpan.org, or through the web interface at http://rt.cpan.org/NoAuth/ReportBug.html?Queue=Cisco-UCS-Chassis-Stats. 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 Cisco::UCS::Chassis::Stats

You can also look for information at:

ACKNOWLEDGEMENTS

LICENSE AND COPYRIGHT

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