Login or Register to Ask a Question and Join Our Community

Linux and UNIX Man Pages

Linux & Unix Commands - Search Man Pages

sys::statistics::linux::procstats(3pm) [debian man page]

Sys::Statistics::Linux::ProcStats(3pm)			User Contributed Perl Documentation		    Sys::Statistics::Linux::ProcStats(3pm)

NAME

       Sys::Statistics::Linux::ProcStats - Collect linux process statistics.

SYNOPSIS

	   use Sys::Statistics::Linux::ProcStats;

	   my $lxs = Sys::Statistics::Linux::ProcStats->new;
	   $lxs->init;
	   sleep 1;
	   my $stat = $lxs->get;

       Or

	   my $lxs = Sys::Statistics::Linux::ProcStats->new(initfile => $file);
	   $lxs->init;
	   my $stat = $lxs->get;

DESCRIPTION

       Sys::Statistics::Linux::ProcStats gathers process statistics from the virtual /proc filesystem (procfs).

       For more information read the documentation of the front-end module Sys::Statistics::Linux.

IMPORTANT

       I renamed key "procs_blocked" to "blocked"!

LOAD AVERAGE STATISTICS

       Generated by /proc/stat and /proc/loadavg.

	   new	     -	Number of new processes that were produced per second.
	   runqueue  -	The number of currently executing kernel scheduling entities (processes, threads).
	   count     -	The number of kernel scheduling entities that currently exist on the system (processes, threads).
	   blocked   -	Number of processes blocked waiting for I/O to complete (Linux 2.5.45 onwards).
	   running   -	Number of processes in runnable state (Linux 2.5.45 onwards).

METHODS

   new()
       Call "new()" to create a new object.

	   my $lxs = Sys::Statistics::Linux::ProcStats->new;

       Maybe you want to store/load the initial statistics to/from a file:

	   my $lxs = Sys::Statistics::Linux::ProcStats->new(initfile => '/tmp/procstats.yml');

       If you set "initfile" it's not necessary to call sleep before "get()".

       It's also possible to set the path to the proc filesystem.

	    Sys::Statistics::Linux::ProcStats->new(
	       files => {
		   # This is the default
		   path    => '/proc',
		   loadavg => 'loadavg',
		   stat    => 'stat',
	       }
	   );

   init()
       Call "init()" to initialize the statistics.

	   $lxs->init;

   get()
       Call "get()" to get the statistics. "get()" returns the statistics as a hash reference.

	   my $stat = $lxs->get;

   raw()
       Get raw values.

EXPORTS

       No exports.

SEE ALSO

       proc(5)

REPORTING BUGS

       Please report all bugs to <jschulz.cpan(at)bloonix.de>.

AUTHOR

       Jonny Schulz <jschulz.cpan(at)bloonix.de>.

COPYRIGHT

       Copyright (c) 2006, 2007 by Jonny Schulz. All rights reserved.

       This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself.

perl v5.14.2							    2012-03-09				    Sys::Statistics::Linux::ProcStats(3pm)

Check Out this Related Man Page

Sys::Statistics::Linux::SysInfo(3pm)			User Contributed Perl Documentation		      Sys::Statistics::Linux::SysInfo(3pm)

NAME

       Sys::Statistics::Linux::SysInfo - Collect linux system information.

SYNOPSIS

	   use Sys::Statistics::Linux::SysInfo;

	   my $lxs  = Sys::Statistics::Linux::SysInfo->new;
	   my $info = $lxs->get;

DESCRIPTION

       Sys::Statistics::Linux::SysInfo gathers system information from the virtual /proc filesystem (procfs).

       For more information read the documentation of the front-end module Sys::Statistics::Linux.

SYSTEM INFOMATIONS

       Generated by /proc/sys/kernel/{hostname,domainname,ostype,osrelease,version} and /proc/cpuinfo, /proc/meminfo, /proc/uptime, /proc/net/dev.

	   hostname   -  The host name.
	   domain     -  The host domain name.
	   kernel     -  The kernel name.
	   release    -  The kernel release.
	   version    -  The kernel version.
	   memtotal   -  The total size of memory.
	   swaptotal  -  The total size of swap space.
	   uptime     -  The uptime of the system.
	   idletime   -  The idle time of the system.
	   pcpucount  -  The total number of physical CPUs.
	   tcpucount  -  The total number of CPUs (cores, hyper threading).
	   interfaces -  The interfaces of the system.
	   arch       -  The machine hardware name (uname -m).

	   # countcpus is the same like tcpucount
	   countcpus  -  The total (maybe logical) number of CPUs.

       "pcpucount" and "tcpucount" are really easy to understand. Both values are collected from "/proc/cpuinfo". "pcpucount" is the number of
       physical CPUs, counted by "physical id". "tcpucount" is just the total number counted by "processor".

       If you want to get "uptime" and "idletime" as raw value you can set

	   $Sys::Statistics::Linux::SysInfo::RAWTIME = 1;
	   # or with
	   Sys::Statistics::Linux::SysInfo->new(rawtime => 1)

METHODS

   new()
       Call "new()" to create a new object.

	   my $lxs = Sys::Statistics::Linux::SysInfo->new;

   get()
       Call "get()" to get the statistics. "get()" returns the statistics as a hash reference.

	   my $info = $lxs->get;

EXPORTS

       No exports.

SEE ALSO

       proc(5)

REPORTING BUGS

       Please report all bugs to <jschulz.cpan(at)bloonix.de>.

AUTHOR

       Jonny Schulz <jschulz.cpan(at)bloonix.de>.

COPYRIGHT

       Copyright (c) 2006, 2007 by Jonny Schulz. All rights reserved.

       This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself.

perl v5.14.2							    2012-03-09				      Sys::Statistics::Linux::SysInfo(3pm)
Man Page