gopsutil: psutil for golang

This is a port of psutil (http://pythonhosted.org/psutil/). The challenge is porting all psutil functions on some architectures...

Package Structure Changed!

Package (a.k.a. directory) structure has been changed!! see `#24 <https://github.com/shirou/gopsutil/issues/24`_

Available Architectures

• FreeBSD/amd64
• Linux/amd64
• Linux/arm (raspberry pi)
• Windows/amd64

(I do not have a darwin machine)

All works are implemented without cgo by porting c struct to golang struct.

Usage

import (
     "fmt"

     "github.com/shirou/gopsutil"
)

func main() {
     v, _ := gopsutil.VirtualMemory()

     // almost every return value is a struct
     fmt.Printf("Total: %v, Free:%v, UsedPercent:%f%%\n", v.Total, v.Free, v.UsedPercent)

     // convert to JSON. String() is also implemented
     fmt.Println(v)
}

The output is below.

Total: 3179569152, Free:284233728, UsedPercent:84.508194%
{"total":3179569152,"available":492572672,"used":2895335424,"usedPercent":84.50819439828305, (snip)}

Documentation

see http://godoc.org/github.com/shirou/gopsutil

More Info

Several methods have been added which are not present in psutil, but which provide useful information.

• HostInfo() (linux)
  • Hostname
  • Uptime
  • Procs
  • OS (ex: "linux")
  • Platform (ex: "ubuntu", "arch")
  • PlatformFamily (ex: "debian")
  • PlatformVersion (ex: "Ubuntu 13.10")
  • VirtualizationSystem (ex: "LXC")
  • VirtualizationRole (ex: "guest"/"host")
• CPUInfo() (linux, freebsd)
  • CPU (ex: 0, 1, ...)
  • VendorID (ex: "GenuineIntel")
  • Family
  • Model
  • Stepping
  • PhysicalID
  • CoreID
  • Cores (ex: 2)
  • ModelName (ex: "Intel(R) Core(TM) i7-2640M CPU @ 2.80GHz")
  • Mhz
  • CacheSize
  • Flags (ex: "fpu vme de pse tsc msr pae mce cx8 ...")
• LoadAvg() (linux, freebsd)
  • Load1
  • Load5
  • Load15
• GetDockerIDList() (linux)
  • container id list ([]string)
• CgroupCPU() (linux)
  • user
  • system
• CgroupMem() (linux)
  • various status

Some codes are ported from Ohai. many thanks.

Current Status

• x: work
• b: almost work but something broken

name	Linux 686	Linux ARM	FreeBSD 686	MacOSX	Windows
cpu_times	x	x	x	x
cpu_count	x	x	x	x	x
cpu_percent	x	x	x	x	x
cpu_times_percent	x	x	x	x	x
virtual_memory	x	x	x	x	x
swap_memory	x	x	x	x
disk_partitions	x	x	x		x
disk_io_counters	x	x
disk_usage	x	x	x		x
net_io_counters	x	x	x	x	x
boot_time	x	x	x	x	b
users	x	x	x	x	x
pids	x	x	x	x	x
pid_exists	x	x	x	x	x
net_connections

Process class

name	Linux 686	Linux ARM	FreeBSD 686	MacOSX	Windows
pid	x	x	x	x	x
ppid	x	x	x	x	x
name	x	x	x	x
cmdline	x	x
create_time	x	x
status	x	x	x	x
cwd	x	x
exe	x	x	x		x
uids	x	x	x	x
gids	x	x	x	x
terminal	x	x	x	x
io_counters	x	x
nice	x	x
num_fds	x	x
num_ctx_switches	x	x
num_threads	x	x	x	x
cpu_times	x	x
memory_info	x	x	x	x
memory_info_ex	x	x
memory_maps	x	x
open_files	x	x
send_signal	x	x	x	x
suspend	x	x	x	x
resume	x	x	x	x
terminate	x	x	x	x
kill	x	x	x	x
username	x	x	x	x
ionice
rlimit
num_handlres
threads
cpu_percent
cpu_affinity
memory_percent
children
connections
is_running

Original Metrics

item	Linux 686	Linux ARM	FreeBSD 686	MacOSX	Windows
HostInfo
hostname	x	x	x
uptime	x	x	x
proces	x	x	x
os	x	x	x	x	x
platform	x	x	x
platformfamiliy	x	x	x
virtualization	x	x
CPU
VendorID	x	x
Family	x	x
Model	x	x
Stepping	x	x
PhysicalID	x	x
CoreID	x	x
Cores	x	x
ModelName	x	x
LoadAvg
Load1	x	x	x
Load5	x	x	x
Load15	x	x	x
GetDockerID
container id	x	x
CgroupsCPU
user	x	x
system	x	x
CgroupsMem
various	x	x

• future work
  • process_iter
  • wait_procs
  • Process class
    • parent (use ppid instead)
    • as_dict
    • wait

License

New BSD License (same as psutil)

Related Works

I have been influenced by the following great works:

• psutil: http://pythonhosted.org/psutil/
• dstat: https://github.com/dagwieers/dstat
• gosiger: https://github.com/cloudfoundry/gosigar/
• goprocinfo: https://github.com/c9s/goprocinfo
• go-ps: https://github.com/mitchellh/go-ps
• ohai: https://github.com/opscode/ohai/

How to Contribute

1. Fork it
2. Create your feature branch (git checkout -b my-new-feature)
3. Commit your changes (git commit -am 'Add some feature')
4. Push to the branch (git push origin my-new-feature)
5. Create new Pull Request

My English is terrible, so documentation or correcting comments are also welcome.