salt.modules.ps

A salt interface to psutil, a system and process library. See http://code.google.com/p/psutil.

depends:

• psutil Python module

salt.modules.ps.boot_time()

Return the boot time in number of seconds since the epoch began.

CLI Example:

salt '*' ps.boot_time

salt.modules.ps.cached_physical_memory()

Return the amount cached memory.

CLI Example:

salt '*' ps.cached_physical_memory

salt.modules.ps.cpu_percent(interval=0.1, per_cpu=False)

Return the percent of time the CPU is busy.

interval

the number of seconds to sample CPU usage over

per_cpu

if True return an array of CPU percent busy for each CPU, otherwise aggregate all percents into one number

CLI Example:

salt '*' ps.cpu_percent

salt.modules.ps.cpu_times(per_cpu=False)

Return the percent of time the CPU spends in each state, e.g. user, system, idle, nice, iowait, irq, softirq.

per_cpu

if True return an array of percents for each CPU, otherwise aggregate all percents into one number

CLI Example:

salt '*' ps.cpu_times

salt.modules.ps.disk_io_counters()

Return disk I/O statisitics.

CLI Example:

salt '*' ps.disk_io_counters

salt.modules.ps.disk_partition_usage(all=False)

Return a list of disk partitions plus the mount point, filesystem and usage statistics.

CLI Example:

salt '*' ps.disk_partition_usage

salt.modules.ps.disk_partitions(all=False)

Return a list of disk partitions and their device, mount point, and filesystem type.

all

if set to False, only return local, physical partitions (hard disk, USB, CD/DVD partitions). If True, return all filesystems.

CLI Example:

salt '*' ps.disk_partitions

salt.modules.ps.disk_usage(path)

Given a path, return a dict listing the total available space as well as the free space, and used space.

CLI Example:

salt '*' ps.disk_usage /home

salt.modules.ps.get_pid_list()

Return a list of process ids (PIDs) for all running processes.

CLI Example:

salt '*' ps.get_pid_list

salt.modules.ps.network_io_counters()

Return network I/O statisitics.

CLI Example:

salt '*' ps.network_io_counters

salt.modules.ps.num_cpus()

Return the number of CPUs.

CLI Example:

salt '*' ps.num_cpus

salt.modules.ps.physical_memory_buffers()

Return the amount of physical memory buffers.

CLI Example:

salt '*' ps.physical_memory_buffers

salt.modules.ps.physical_memory_usage()

Return a dict that describes free and available physical memory.

CLI Examples:

salt '*' ps.physical_memory_usage

salt.modules.ps.top(num_processes=5, interval=3)

Return a list of top CPU consuming processes during the interval. num_processes = return the top N CPU consuming processes interval = the number of seconds to sample CPU usage over

CLI Examples:

salt '*' ps.top

salt '*' ps.top 5 10

salt.modules.ps.total_physical_memory()

Return the total number of bytes of physical memory.

CLI Example:

salt '*' ps.total_physical_memory

salt.modules.ps.virtual_memory_usage()

Return a dict that describes free and available memory, both physical and virtual.

CLI Example:

salt '*' ps.virtual_memory_usage