NAME

Unix::Statgrab::sg_cpu_stats - container for libstatgrab CPU statistics

DESCRIPTION

Unix::Statgrab::sg_cpu_stats is a Perl package name providing accessors to bundled libstatgrab sg_cpu_stats data collection.

METHODS

nentries

Returns the number of entries in the container.

systime

Returns the seconds since Epoch (0:00:00 on January, 1st 1970) of the time measure the CPU statistics.

as_list

Deprecated alias of "fetchall_hash"

fetchall_hash

Returns all records from sg_cpu_stats container as list of hash containing each datum name as key and the datum as value.

fetchall_array

Returns all records from sg_cpu_stats container as list of arrays containing the values in following order:

(user kernel idle iowait swap nice total
 context_switches voluntary_context_switches involuntary_context_switches
 syscalls interrupts soft_interrupts
 systime)

in that order without leading headline.

fetchall_table

Returns all records from sg_cpu_stats container as list of arrays containing the values in following order:

(user kernel idle iowait swap nice total
 context_switches voluntary_context_switches involuntary_context_switches
 syscalls interrupts soft_interrupts
 systime)

in that order including leading headline.

fetchrow_arrayref($row = 0)

Returns one row as array containing values as above.

fetchall_arrayref

Returns all records from sg_cpu_stats container as array of arrays without header.

fetchrow_hashref($row = 0)

Returns one row as hash containing { user => $self.user($row), kernel => ... }.

fetchall_hashref

Returns all records from sg_cpu_stats container as array of hashes.

colnames

Returns list of column names: (user kernel idle iowait swap nice total context_switches voluntary_context_switches involuntary_context_switches syscalls interrupts soft_interrupts systime)

user

Clock ticks in user mode

kernel

Clock ticks in kernel mode

idle

Clock ticks while idle

iowait

Clock ticks while waiting for outstanding I/O

swap

Clock ticks while waiting for swap

nice

Clock ticks in user mode with nice priority

total

Overall clock ticks

context_switches

Overall Context switches

voluntary_context_switches

Voluntary context switches (See sched_yield(2))

involuntary_context_switches

Involuntary context switches

syscalls

Number of syscalls

interrupts

Amount of interrupts happened

soft_interrupts

Amount of software triggered interrupts

get_cpu_stats_diff

Provides the difference between the last measurement and the recent one.

$recent->get_cpu_stats_diff($last);

get_cpu_percents

Provides a percentage representation of the single cpu ticks measured.

AUTHOR

Jens Rehsack, <rehsack AT cpan.org>

COPYRIGHT AND LICENSE

Copyright (C) 2012-2015 by Jens Rehsack

This library is free software; you can redistribute it and/or modify it under the terms of the GNU Lesser General Public License as published by the Free Software Foundation; either version 2.1 of the License, or (at your option) any later version.