Unix::Statgrab

Unix::Statgrab - System Monitoring
Jens Rehsack
2013
Jens Rehsack () Unix::Statgrab - System Monitoring 2013 1 / 28

Overview
Part I
Introduction
1 Introduction

Introduction
Audience
Audience
Developer who wants to create or improve monitoring software
Developer who wants to evaluate system stats for content sensitive code
paths
Developer who wants to to learn the diﬀerence to earlier libstatgrab /
Unix::Statgrab API
Developers or Operators (Admins) who wants to learn about measurement of
statistic values of the machine

Introduction
Audience
Audience
Developer who wants to create or improve monitoring software
Developer who wants to evaluate system stats for content sensitive code
paths
Developer who wants to to learn the diﬀerence to earlier libstatgrab /
Unix::Statgrab API
Developers or Operators (Admins) who wants to learn about measurement of
statistic values of the machine
Prerequisites of the Audience
Following knowledge is expected:
advanced skills in at least one object oriented and procedural programming
language
more than one year practical experience in object oriented development
Experience with Unix or compatible operating systems
slightly above basic Perl experience

Introduction
Motivation
XS / C
use of native API to get OS stats
performance advantage
interoperability (most VM’s have a * native interface)
portability - widest calling convention support in C

Introduction
Platforms I
Tested and conﬁrmed running
DragonFly BSD 3.4
FreeBSD 7,8 (i386, amd64), FreeBSD 9 (i386, amd64, sparc64, ia64),
FreeBSD 10-CURRENT (i386, amd64, sparc64, ia64)
HP-UX 11.11 (parisc) HP-UX 11.23 (parisc, ia64), HP-UX 11.31 (ia64)
Linux 2.6 (Ubuntu 10.04, SLES 9-11, Redhat 6, CentOS 6, µCLinux/arm7),
Linux 3.X (Ubuntu 12.04)
MacOS X 10.6, 10.8 (amd64)
NetBSD 5.1-6.1 (amd64), NetBSD-CURRENT (amd64)
OpenBSD 4.9, 5.3 (amd64)
Solaris 8,9 (sparc), Solaris 10 (sparc, x86 & amd64), Solaris 11 (amd64)
AIX 5.2, 5.3, 6.1 (ppc64)

Introduction
Platforms II
in progress . . .
Windows (using Interix, maybe mSys)
kFreeBSD
Hurd

Introduction
Platforms II
in progress . . .
Windows (using Interix, maybe mSys)
kFreeBSD
Hurd
Wishlist
Digital Unix / Tru64 / OSF1
Haiku
VMS
zOS

Overview
Part II
libstatgrab
2 Host Information
3 CPU statistics
4 Memory statistics
5 Disk / Storage statistics
6 User statistics
7 Process statistics
8 Network statistics
9 Error management

Host Information
Host Info
sg host info
typedef struct {
char *os_name;
char * os_release ;
char * os_version ;
char *platform;
char *hostname;
unsigned bitwidth ;
sg_host_state host_state ;
unsigned ncpus;
unsigned maxcpus;
time_t uptime;
time_t systime;
} sg_host_info ;

Host Information
Host Info
sg host info
typedef struct {
char *os_name;
char * os_release ;
char * os_version ;
char *platform;
char *hostname;
unsigned bitwidth ;
unsigned ncpus;
unsigned maxcpus;
time_t uptime;
time_t systime;
} sg_host_info ;
bundles some operating system information as
name (Linux, FreeBSD, AIX),

Host Information
Host Info
sg host info
typedef struct {
char *os_name;
char * os_release ;
char * os_version ;
char *platform;
char *hostname;
unsigned bitwidth ;
unsigned ncpus;
unsigned maxcpus;
time_t uptime;
time_t systime;
} sg_host_info ;
release (eg. kernel version),

Host Information
Host Info
sg host info
typedef struct {
char *os_name;
char * os_release ;
char * os_version ;
char *platform;
char *hostname;
unsigned bitwidth ;
unsigned ncpus;
unsigned maxcpus;
time_t uptime;
time_t systime;
} sg_host_info ;
entire OS version string (eg. Darwin Kernel
Version 12.4.0: Wed May 1 17:57:12 PDT 2013;
root:xnu-2050.24.15 1/RELEASE X86 64),

Host Information
Host Info
sg host info
typedef struct {
char *os_name;
char * os_release ;
char * os_version ;
char *platform;
char *hostname;
unsigned bitwidth ;
unsigned ncpus;
unsigned maxcpus;
time_t uptime;
time_t systime;
} sg_host_info ;
platform, what ﬁnally means CPU information
from OS perspective,

Host Information
Host Info
sg host info
typedef struct {
char *os_name;
char * os_release ;
char * os_version ;
char *platform;
char *hostname;
unsigned bitwidth ;
unsigned ncpus;
unsigned maxcpus;
time_t uptime;
time_t systime;
} sg_host_info ;
hostname name of the host.

Host Information
Host Info
sg host info
typedef struct {
char *os_name;
char * os_release ;
char * os_version ;
char *platform;
char *hostname;
unsigned bitwidth ;
unsigned ncpus;
unsigned maxcpus;
time_t uptime;
time_t systime;
} sg_host_info ;
bitwidth (usually 32 or 64),

Host Information
Host Info
sg host info
typedef struct {
char *os_name;
char * os_release ;
char * os_version ;
char *platform;
char *hostname;
unsigned bitwidth ;
unsigned ncpus;
unsigned maxcpus;
time_t uptime;
time_t systime;
} sg_host_info ;
host state - one of sg physical host,
sg virtual machine, sg paravirtual machine,
sg hardware virtualized or
sg unknown configuration),

Host Information
Host Info
sg host info
typedef struct {
char *os_name;
char * os_release ;
char * os_version ;
char *platform;
char *hostname;
unsigned bitwidth ;
unsigned ncpus;
unsigned maxcpus;
time_t uptime;
time_t systime;
} sg_host_info ;
current number of CPU’s,

Host Information
Host Info
sg host info
typedef struct {
char *os_name;
char * os_release ;
char * os_version ;
char *platform;
char *hostname;
unsigned bitwidth ;
unsigned ncpus;
unsigned maxcpus;
time_t uptime;
time_t systime;
} sg_host_info ;
maximum number of CPU’s.

Host Information
Host Info
sg host info
typedef struct {
char *os_name;
char * os_release ;
char * os_version ;
char *platform;
char *hostname;
unsigned bitwidth ;
unsigned ncpus;
unsigned maxcpus;
time_t uptime;
time_t systime;
} sg_host_info ;
maximum number of CPU’s.
timestamp when collected this stats.

CPU statistics
CPU stats
sg cpu stats
typedef struct {
unsigned long long user , kernel , idle , iowait , swap , nice , total;
unsigned long long context_switches , voluntary_context_switches , involuntary_context_switches ,
syscalls , interrupts , soft_interrupts ,
time_t systime ;
} sg_cpu_stats ;

CPU statistics
CPU stats
sg cpu stats
typedef struct {
time_t systime ;
} sg_cpu_stats ;
absolute ticks of measurable CPU states,

CPU statistics
CPU stats
sg cpu stats
typedef struct {
time_t systime ;
} sg_cpu_stats ;
context switches over all CPU’s, also separated by voluntary and involuntary,

CPU statistics
CPU stats
sg cpu stats
typedef struct {
time_t systime ;
} sg_cpu_stats ;
syscalls made, interrupts and soft-interrupts occured,

CPU statistics
CPU percents
sg cpu percents
typedef struct {
double user;
double kernel;
double idle;
double iowait;
double swap;
double nice;
time_t time_taken ;
} sg_cpu_percents ;

CPU statistics
CPU percents
sg cpu percents
typedef struct {
double user;
double kernel;
double idle;
double iowait;
double swap;
double nice;
time_t time_taken ;
} sg_cpu_percents ;
relative ticks of measurable CPU states:

CPU statistics
CPU percents
sg cpu percents
typedef struct {
double user;
double kernel;
double idle;
double iowait;
double swap;
double nice;
time_t time_taken ;
} sg_cpu_percents ;
relative ticks of measurable CPU states: ticks in user mode,

CPU statistics
CPU percents
sg cpu percents
typedef struct {
double user;
double kernel;
double idle;
double iowait;
double swap;
double nice;
time_t time_taken ;
} sg_cpu_percents ;
relative ticks of measurable CPU states: ticks in user mode, kernel mode,

CPU statistics
CPU percents
sg cpu percents
typedef struct {
double user;
double kernel;
double idle;
double iowait;
double swap;
double nice;
time_t time_taken ;
} sg_cpu_percents ;
relative ticks of measurable CPU states: ticks in user mode, kernel mode, idle time,

CPU statistics
CPU percents
sg cpu percents
typedef struct {
double user;
double kernel;
double idle;
double iowait;
double swap;
double nice;
time_t time_taken ;
} sg_cpu_percents ;
relative ticks of measurable CPU states: ticks in user mode, kernel mode, idle time, waiting for i/o,

CPU statistics
CPU percents
sg cpu percents
typedef struct {
double user;
double kernel;
double idle;
double iowait;
double swap;
double nice;
time_t time_taken ;
} sg_cpu_percents ;
during page swap,

CPU statistics
CPU percents
sg cpu percents
typedef struct {
double user;
double kernel;
double idle;
double iowait;
double swap;
double nice;
time_t time_taken ;
} sg_cpu_percents ;
during page swap, nice rescheduled

CPU statistics
Load percents
sg load stats
typedef struct {
double min1;
double min5;
double min15;
time_t systime;
} sg_load_stats;

CPU statistics
Load percents
sg load stats
typedef struct {
double min1;
double min5;
double min15;
time_t systime;
} sg_load_stats;
percentage of cpu usage per

CPU statistics
Load percents
sg load stats
typedef struct {
double min1;
double min5;
double min15;
time_t systime;
} sg_load_stats;
percentage of cpu usage per 1 minute,

CPU statistics
Load percents
sg load stats
typedef struct {
double min1;
double min5;
double min15;
time_t systime;
} sg_load_stats;
percentage of cpu usage per 1 minute, 5 minutes and

CPU statistics
Load percents
sg load stats
typedef struct {
double min1;
double min5;
double min15;
time_t systime;
} sg_load_stats;
percentage of cpu usage per 1 minute, 5 minutes and 15 minutes.

Memory statistics
Memory stats
sg mem stats
typedef struct {
unsigned long long total;
unsigned long long free;
unsigned long long used;
unsigned long long cache;
time_t systime;
} sg_mem_stats ;

Memory statistics
Memory stats
sg mem stats
typedef struct {
time_t systime;
} sg_mem_stats ;
information about main memory of the system:

Memory statistics
Memory stats
sg mem stats
typedef struct {
time_t systime;
} sg_mem_stats ;
information about main memory of the system: total,

Memory statistics
Memory stats
sg mem stats
typedef struct {
time_t systime;
} sg_mem_stats ;
information about main memory of the system: total, free,

Memory statistics
Memory stats
sg mem stats
typedef struct {
time_t systime;
} sg_mem_stats ;
information about main memory of the system: total, free, used,

Memory statistics
Memory stats
sg mem stats
typedef struct {
time_t systime;
} sg_mem_stats ;
information about main memory of the system: total, free, used, cache,

Memory statistics
Swap stats
sg swap stats
typedef struct {
time_t systime;
} sg_swap_stats;

Memory statistics
Swap stats
sg swap stats
typedef struct {
time_t systime;
} sg_swap_stats;
information about swap memory of the system:

Memory statistics
Swap stats
sg swap stats
typedef struct {
time_t systime;
} sg_swap_stats;
information about swap memory of the system: total,

Memory statistics
Swap stats
sg swap stats
typedef struct {
time_t systime;
} sg_swap_stats;
information about swap memory of the system: total, free,

Memory statistics
Swap stats
sg swap stats
typedef struct {
time_t systime;
} sg_swap_stats;
information about swap memory of the system: total, free, used,

Disk / Storage statistics
Disk I/O stats
sg disk io stats
typedef struct {
char *disk_name;
unsigned long long read_bytes ;
unsigned long long write_bytes;
time_t systime;
} sg_disk_io_stats ;

Disk I/O stats
sg disk io stats
typedef struct {
char *disk_name;
time_t systime;
for each block device known to the system
name of the block device,

Disk I/O stats
sg disk io stats
typedef struct {
char *disk_name;
time_t systime;
amount of bytes read

Disk I/O stats
sg disk io stats
typedef struct {
char *disk_name;
time_t systime;
amount of bytes written

Paging stats
sg page stats
typedef struct {
unsigned long long pages_pagein ;
unsigned long long pages_pageout;
time_t systime;
} sg_page_stats;

Paging stats
sg page stats
typedef struct {
time_t systime;
} sg_page_stats;
for entire system
amount of bytes paged in,

Paging stats
sg page stats
typedef struct {
time_t systime;
} sg_page_stats;
for entire system
amount of bytes paged out

Filesystem stats
sg fs stats
typedef struct {
char * device_name;
char *fs_type;
char *mnt_point;
sg_fs_device_type device_type;
unsigned long long size;
unsigned long long avail;
unsigned long long total_inodes ;
unsigned long long used_inodes;
unsigned long long free_inodes;
unsigned long long avail_inodes ;
unsigned long long io_size ;
unsigned long long block_size ;
unsigned long long total_blocks ;
unsigned long long free_blocks;
unsigned long long used_blocks;
unsigned long long avail_blocks ;
time_t systime;
} sg_fs_stats;

Filesystem stats
sg fs stats
typedef struct {
char * device_name;
char *fs_type;
char *mnt_point;
time_t systime;
} sg_fs_stats;
for each mounted (and not ﬁltered) ﬁle system
name of the mounted block device,

Filesystem stats
sg fs stats
typedef struct {
char * device_name;
char *fs_type;
char *mnt_point;
time_t systime;
} sg_fs_stats;
name of the ﬁle system type (eg. ext3, ﬀs, zfs)

Filesystem stats
sg fs stats
typedef struct {
char * device_name;
char *fs_type;
char *mnt_point;
time_t systime;
} sg_fs_stats;
full qualiﬁed path name of the mount point

Filesystem stats
sg fs stats
typedef struct {
char * device_name;
char *fs_type;
char *mnt_point;
time_t systime;
} sg_fs_stats;
device type: one of sg fs unknown,
sg fs regular, sg fs special,
sg fs loopback, sg fs remote or any
combination
Anything but unknown is covered by
sg fs alltypes, any local type by sg fs local

Filesystem stats
sg fs stats
typedef struct {
char * device_name;
char *fs_type;
char *mnt_point;
time_t systime;
} sg_fs_stats;
combination
size of the ﬁle system in bytes

Filesystem stats
sg fs stats
typedef struct {
char * device_name;
char *fs_type;
char *mnt_point;
time_t systime;
} sg_fs_stats;
combination
also separated into used, free and avail

Filesystem stats
sg fs stats
typedef struct {
char * device_name;
char *fs_type;
char *mnt_point;
time_t systime;
} sg_fs_stats;
combination
inodes of the ﬁle system

Filesystem stats
sg fs stats
typedef struct {
char * device_name;
char *fs_type;
char *mnt_point;
time_t systime;
} sg_fs_stats;
combination

Filesystem stats
sg fs stats
typedef struct {
char * device_name;
char *fs_type;
char *mnt_point;
time_t systime;
} sg_fs_stats;
combination
optimal size of the I/O blocks when accessing
the ﬁle system in bytes

Filesystem stats
sg fs stats
typedef struct {
char * device_name;
char *fs_type;
char *mnt_point;
time_t systime;
} sg_fs_stats;
combination
block size (minimum allocation size) of the ﬁle
system in bytes

Filesystem stats
sg fs stats
typedef struct {
char * device_name;
char *fs_type;
char *mnt_point;
time_t systime;
} sg_fs_stats;
combination
system in bytes
amount of blocks of the ﬁle system

Filesystem stats
sg fs stats
typedef struct {
char * device_name;
char *fs_type;
char *mnt_point;
time_t systime;
} sg_fs_stats;
combination
system in bytes

User statistics
User stats
sg user stats
typedef struct {
char * login_name ;
char *record_id;
size_t record_id_size;
char *device;
char *hostname;
pid_t pid;
time_t login_time ;
time_t systime;
} sg_user_stats;

User statistics
User stats
sg user stats
typedef struct {
char * login_name ;
char *record_id;
char *device;
char *hostname;
pid_t pid;
time_t login_time ;
time_t systime;
} sg_user_stats;
statistics about logged in users, as
login name,

User statistics
User stats
sg user stats
typedef struct {
char * login_name ;
char *record_id;
char *device;
char *hostname;
pid_t pid;
time_t login_time ;
time_t systime;
} sg_user_stats;
login name,
record id and size of that ﬁeld (not ’0’ terminated),

User statistics
User stats
sg user stats
typedef struct {
char * login_name ;
char *record_id;
char *device;
char *hostname;
pid_t pid;
time_t login_time ;
time_t systime;
} sg_user_stats;
login name,
device where user logged in,

User statistics
User stats
sg user stats
typedef struct {
char * login_name ;
char *record_id;
char *device;
char *hostname;
pid_t pid;
time_t login_time ;
time_t systime;
} sg_user_stats;
login name,
hostname when remote login

User statistics
User stats
sg user stats
typedef struct {
char * login_name ;
char *record_id;
char *device;
char *hostname;
pid_t pid;
time_t login_time ;
time_t systime;
} sg_user_stats;
login name,
process id of the session’s ”root” process

User statistics
User stats
sg user stats
typedef struct {
char * login_name ;
char *record_id;
char *device;
char *hostname;
pid_t pid;
time_t login_time ;
time_t systime;
} sg_user_stats;
login name,
login time of that session

Process statistics
Process stats
sg process stats
typedef struct {
char * process_name ;
char *proctitle;
pid_t pid;
pid_t parent;
pid_t pgid;
pid_t sessid;
uid_t uid;
uid_t euid;
gid_t gid;
gid_t egid;
unsigned long long context_switches ;
unsigned long long voluntary_context_switches;
unsigned long long involuntary_context_switches;
unsigned long long proc_size;
unsigned long long proc_resident;
time_t start_time ;
time_t time_spent ;
double cpu_percent;
int nice;
sg_process_state state;
time_t systime;
} sg_process_stats ;

Process statistics
Process stats
sg process stats
typedef struct {
char *proctitle;
pid_t pid;
pid_t parent;
pid_t pgid;
pid_t sessid;
uid_t uid;
uid_t euid;
gid_t gid;
gid_t egid;
time_t start_time ;
time_t time_spent ;
double cpu_percent;
int nice;
time_t systime;
for each existing process
name of the process image,

Process statistics
Process stats
sg process stats
typedef struct {
char *proctitle;
pid_t pid;
pid_t parent;
pid_t pgid;
pid_t sessid;
uid_t uid;
uid_t euid;
gid_t gid;
gid_t egid;
time_t start_time ;
time_t time_spent ;
double cpu_percent;
int nice;
time_t systime;
title of the process (usually FQPN + args)

Process statistics
Process stats
sg process stats
typedef struct {
char *proctitle;
pid_t pid;
pid_t parent;
pid_t pgid;
pid_t sessid;
uid_t uid;
uid_t euid;
gid_t gid;
gid_t egid;
time_t start_time ;
time_t time_spent ;
double cpu_percent;
int nice;
time_t systime;
process id of the process,

Process statistics
Process stats
sg process stats
typedef struct {
char *proctitle;
pid_t pid;
pid_t parent;
pid_t pgid;
pid_t sessid;
uid_t uid;
uid_t euid;
gid_t gid;
gid_t egid;
time_t start_time ;
time_t time_spent ;
double cpu_percent;
int nice;
time_t systime;
process id of the process, the parent process,

Process statistics
Process stats
sg process stats
typedef struct {
char *proctitle;
pid_t pid;
pid_t parent;
pid_t pgid;
pid_t sessid;
uid_t uid;
uid_t euid;
gid_t gid;
gid_t egid;
time_t start_time ;
time_t time_spent ;
double cpu_percent;
int nice;
time_t systime;
process id of the process, the parent process, the
process group leader and

Process statistics
Process stats
sg process stats
typedef struct {
char *proctitle;
pid_t pid;
pid_t parent;
pid_t pgid;
pid_t sessid;
uid_t uid;
uid_t euid;
gid_t gid;
gid_t egid;
time_t start_time ;
time_t time_spent ;
double cpu_percent;
int nice;
time_t systime;
process group leader and the session id of the
session the process belongs to

Process statistics
Process stats
sg process stats
typedef struct {
char *proctitle;
pid_t pid;
pid_t parent;
pid_t pgid;
pid_t sessid;
uid_t uid;
uid_t euid;
gid_t gid;
gid_t egid;
time_t start_time ;
time_t time_spent ;
double cpu_percent;
int nice;
time_t systime;
process’ user id,

Process statistics
Process stats
sg process stats
typedef struct {
char *proctitle;
pid_t pid;
pid_t parent;
pid_t pgid;
pid_t sessid;
uid_t uid;
uid_t euid;
gid_t gid;
gid_t egid;
time_t start_time ;
time_t time_spent ;
double cpu_percent;
int nice;
time_t systime;
process’ user id, group id,

Process statistics
Process stats
sg process stats
typedef struct {
char *proctitle;
pid_t pid;
pid_t parent;
pid_t pgid;
pid_t sessid;
uid_t uid;
uid_t euid;
gid_t gid;
gid_t egid;
time_t start_time ;
time_t time_spent ;
double cpu_percent;
int nice;
time_t systime;
process’ user id, group id, eﬀective user id and

Process statistics
Process stats
sg process stats
typedef struct {
char *proctitle;
pid_t pid;
pid_t parent;
pid_t pgid;
pid_t sessid;
uid_t uid;
uid_t euid;
gid_t gid;
gid_t egid;
time_t start_time ;
time_t time_spent ;
double cpu_percent;
int nice;
time_t systime;
eﬀective group id

Process statistics
Process stats
sg process stats
typedef struct {
char *proctitle;
pid_t pid;
pid_t parent;
pid_t pgid;
pid_t sessid;
uid_t uid;
uid_t euid;
gid_t gid;
gid_t egid;
time_t start_time ;
time_t time_spent ;
double cpu_percent;
int nice;
time_t systime;
eﬀective group id
context switches done by the process, also
separated by voluntary and involuntary

Process statistics
Process stats
sg process stats
typedef struct {
char *proctitle;
pid_t pid;
pid_t parent;
pid_t pgid;
pid_t sessid;
uid_t uid;
uid_t euid;
gid_t gid;
gid_t egid;
time_t start_time ;
time_t time_spent ;
double cpu_percent;
int nice;
time_t systime;
eﬀective group id
virtual memory size of the process, thereof
resident

Process statistics
Process stats
sg process stats
typedef struct {
char *proctitle;
pid_t pid;
pid_t parent;
pid_t pgid;
pid_t sessid;
uid_t uid;
uid_t euid;
gid_t gid;
gid_t egid;
time_t start_time ;
time_t time_spent ;
double cpu_percent;
int nice;
time_t systime;
eﬀective group id
resident
start time of the process, time spent on CPU
during lifetime, relative to system usage

Process statistics
Process stats
sg process stats
typedef struct {
char *proctitle;
pid_t pid;
pid_t parent;
pid_t pgid;
pid_t sessid;
uid_t uid;
uid_t euid;
gid_t gid;
gid_t egid;
time_t start_time ;
time_t time_spent ;
double cpu_percent;
int nice;
time_t systime;
eﬀective group id
resident
nice value of the process (process scheduling
increment)

Process statistics
Process stats
sg process stats
typedef struct {
char *proctitle;
pid_t pid;
pid_t parent;
pid_t pgid;
pid_t sessid;
uid_t uid;
uid_t euid;
gid_t gid;
gid_t egid;
time_t start_time ;
time_t time_spent ;
double cpu_percent;
int nice;
time_t systime;
eﬀective group id
resident
increment)
device type: one of SG PROCESS STATE RUNNING,
SG PROCESS STATE SLEEPING,
SG PROCESS STATE STOPPED,
SG PROCESS STATE ZOMBIE or
SG PROCESS STATE UNKNOWN

Network statistics
Network I/O stats
sg network io stats
typedef struct {
char * interface_name;
unsigned long long tx;
unsigned long long rx;
unsigned long long ipackets ;
unsigned long long opackets;
unsigned long long ierrors ;
unsigned long long oerrors ;
unsigned long long collisions ;
time_t systime;
} sg_network_io_stats ;

Network statistics
Network I/O stats
sg network io stats
typedef struct {
time_t systime;
for each network interface
interface name (eg. ”em0”, ”fxp0”, ”en0”, ”eth0” . . . ),

Network statistics
Network I/O stats
sg network io stats
typedef struct {
time_t systime;
bytes transmitted and received

Network statistics
Network I/O stats
sg network io stats
typedef struct {
time_t systime;
packets transmitted and received

Network statistics
Network I/O stats
sg network io stats
typedef struct {
time_t systime;
errors transmitting and receiving packets

Network statistics
Network I/O stats
sg network io stats
typedef struct {
time_t systime;
detected collisions

Network statistics
Network Interface stats
sg network iface stats
typedef struct {
unsigned long long speed;
unsigned long long factor;
sg_iface_duplex duplex;
sg_iface_updown up;
time_t systime;
} sg_network_iface_stats ;

Network statistics
typedef struct {
sg_iface_updown up;
time_t systime;

Network statistics
typedef struct {
sg_iface_updown up;
time_t systime;
capable to transfer times of sized units per second

Network statistics
typedef struct {
sg_iface_updown up;
time_t systime;
capable to transmit and receive simultanously (SG IFACE DUPLEX FULL, SG IFACE DUPLEX HALF or
SG IFACE DUPLEX UNKNOWN)

Network statistics
typedef struct {
sg_iface_updown up;
time_t systime;
NIC is SG IFACE UP or SG IFACE DOWN

Error management
Error information
sg error details
typedef struct sg_error_details {
sg_error error;
int errno_value;
const char *error_arg;
} sg_error_details ;

Error management
Error information
sg error details
sg_error error;
int errno_value;
when an error occured (no stats are resulted upon querying):
libstatgrab error code (eg. SG ERROR INVALID ARGUMENT)

Error management
Error information
sg error details
sg_error error;
int errno_value;
system (errno.h) error code (eg. EBUSY

Error management
Error information
sg error details
sg_error error;
int errno_value;
system (errno.h) error code (eg. EBUSY
optional error explanation message (eg. ﬁle name, process id, . . . )

Overview
Part III
Unix::Statgrab
10 Entry Functions
11 SYNOPSIS

Entry Functions
Entry Functions
get_error (); # return details about last error
get_host_info (); # returns sg_host_info
get_cpu_stats (); # returns sg_cpu_stats
get_disk_io_stats (); # returns sg_disk_io_stats
get_fs_stats (); # returns sg_fs_stats
get_load_stats (); # returns sg_load_stats
get_mem_stats (); # returns sg_mem_stats
get_swap_stats (); # returns sg_swap_stats
get_network_io_stats (); # returns sg_network_io_stats
get_network_iface_stats (); # returns sg_network_iface_stats
get_page_stats (); # returns sg_page_stats
get_user_stats (); # returns sg_user_stats
get_process_stats (); # returns sg_process_stats

SYNOPSIS
Common . . .
Common . . .
use Unix :: Statgrab ;
my $host_info = get_host_info () or croak( get_error ()-> strperror () );
printf( "%dn", $host_info ->entries () );
my $cpu_stats = get_cpu_stats () or croak( get_error ()-> strperror () );
printf( "%dn", $cpu_stats ->entries () );
my $disk_io_stats = get_disk_io_stats () or croak( get_error ()-> strperror () );
printf( "%dn", $disk_io_stats ->entries () );
my $fs_stats = get_fs_stats () or croak( get_error ()-> strperror () );
printf( "%dn", $fs_stats ->entries () );
my $load_stats = get_load_stats () or croak( get_error ()-> strperror () );
printf( "%dn", $load_stats ->entries () );
my $mem_stats = get_mem_stats () or croak( get_error ()-> strperror () );
printf( "%dn", $mem_stats ->entries () );
my $swap_stats = get_swap_stats () or croak( get_error ()-> strperror () );
printf( "%dn", $swap_stats ->entries () );
my $net_io_stats = get_network_io_stats () or croak( get_error ()-> strperror () );
printf( "%dn", $net_io_stats ->entries () );
my $net_iface_stats = get_network_iface_stats () or croak( get_error ()-> strperror () );
printf( "%dn", $net_iface_stats ->entries () );
my $paging_stats = get_page_stats () or croak( get_error ()-> strperror () );
printf( "%dn", $paging ->entries () );
my $user_stats = get_user_stats () or croak( get_error ()-> strperror () );
printf( "%dn", $user_stats ->entries () );
my $proc_stats = get_process_stats () or croak( get_error ()-> strperror () );
printf( "%dn", $proc_stats ->entries () );

SYNOPSIS
SYNOPSIS
SYNOPSIS
my $host_stats = get_host_info ();
print $host_stats ->hostname . " is a " . $host_stats ->bitwidth . " " . $host_stats ->os_name . "n";
my $filesystems = get_fs_stats ();
my @mount_points = map { $filesystems ->mnt_point($_) } (0 .. $filesystems ->entries () - 1);
print $host_stats ->hostname . " has " . join( ", ", @mount_points ) . " mounted n";
my $proc_list = get_process_stats ();
my @proc_by_type;
foreach my $proc_entry (0 .. $proc_list ->entries () - 1) {
$proc_by_type[$proc_list ->state( $proc_entry )]++;
}
my $total_procs = 0;
$total_procs += $_ for grep { defined $_ } @proc_by_type;
foreach my $state (qw( SG_PROCESS_STATE_RUNNING SG_PROCESS_STATE_SLEEPING
SG_PROCESS_STATE_STOPPED SG_PROCESS_STATE_ZOMBIE
SG_PROCESS_STATE_UNKNOWN )) {
defined $proc_by_type[Unix :: Statgrab ->$state] or next;
print $proc_by_type[Unix :: Statgrab ->$state ] . " of " . $total_procs . " procs in $staten";
}

SYNOPSIS
SYNOPSIS II
SYNOPSIS diﬀ / percent
my $last_cpu_stats = get_cpu_stats () or croak( get_error ()-> strperror () );
do_sth_way_longer ();
my $cpu_diff = get_cpu_stats ()-> get_cpu_stats_diff( $last_cpu_stats );
my $last_cpu_percent = $last_cpu_percent -> get_cpu_percents ();
my $diff_cpu_percent = $cpu_diff -> get_cpu_percents ();
my $now_cpu_percent = get_cpu_stats ()-> get_cpu_percents ();
my $last_disk_io_stats = get_disk_io_stats () or croak( get_error ()-> strperror () );
my $disk_io_diff = get_disk_io_stats()-> get_disk_io_stats_diff ( $last_disk_io_stats );
my $last_fs_stats = get_fs_stats () or croak( get_error ()-> strperror () );
my $fs_diff = get_fs_stats ()-> get_fs_stats_diff( $last_fs_stats );
my $last_net_io_stats = get_network_io_stats () or croak( get_error ()-> strperror () );
my $net_io_diff = get_network_io_stats ()-> get_network_io_stats_diff( $last_net_io_stats );
my $last_paging_stats = get_page_stats () or croak( get_error ()-> strperror () );
my $paging_diff = get_page_stats ()-> get_page_stats_diff ( $last_paging_stats );

SYNOPSIS
Resources
Software
http://www.i-scream.org/libstatgrab/
http://search.cpan.org/dist/Unix-Statgrab/
https://metacpan.org/module/Unix::Statgrab

SYNOPSIS
Resources
Software
Mailing List
https://lists.i-scream.org/pipermail/users/
users@i-scream.org

SYNOPSIS
Resources
Software
Mailing List
https://lists.i-scream.org/pipermail/users/
users@i-scream.org
IRC
irc://irc.freenode.net/#libstatgrab

SYNOPSIS
Thank You
Thank you

SYNOPSIS
Thank You
Thank you
Tim Bishop for caring for high quality release

SYNOPSIS
Thank You
Thank you
H. Merijn Brand for doing additional tests on more exotic platforms

SYNOPSIS
Thank You
Thank you
Reini Urban for proving on commodity hardware for being sane

SYNOPSIS
Thank You
Thank you
Reini Urban for proving on commodity hardware for being sane
Questions?
Jens Rehsack <rehsack@cpan.org>

Unix::Statgrab

More Related Content

What's hot (20)

Similar to Unix::Statgrab (20)

More from Jens Rehsack (7)

Recently uploaded (20)

Unix::Statgrab