gopsutil: psutil for golang

https://drone.io/github.com/shirou/gopsutil/status.png

https://coveralls.io/repos/shirou/gopsutil/badge.png?branch=master

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

Available archtectures

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 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)}

Document

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

More info

To becomes more useful, I have some methods which produces more information.

Hostinfo() (linux)
- OS
- Platform (ex: ubuntu, arch)
- Platform family (ex: debian)
- Platform Version (ex: Ubuntu 13.10)
- VirtualizationSystem (ex: LXC)
- VirtualizationRole (ex: guest/host)
CPUInfoStat() (linux, freebsd)
- Processer
- Vendor ID
- Model name
- cores
- Mhz
- etc...
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

done
- cpu_times (linux, freebsd)
- cpu_count (linux, freebsd, windows)
- virtual_memory (linux, freebsd, windows)
- swap_memory (linux, freebsd)
- disk_partitions (linux, freebsd, windows)
- disk_io_counters (linux)
- disk_usage (linux, freebsd, windows)
- net_io_counters (linux, freebsd, windows)
- boot_time (linux, freebsd, windows(but little broken))
- users (linux, freebsd)
- pids (linux, freebsd)
- pid_exists (linux, freebsd)
- Process class
  - pid (linux, freebsd, windows)
  - ppid (linux, freebsd, windows)
  - name (linux)
  - cmdline (linux)
  - create_time (linux)
  - status (linux)
  - cwd (linux)
  - exe (linux, freebsd, windows)
  - uids (linux, freebsd)
  - gids (linux, freebsd)
  - terminal (linux, freebsd)
  - io_counters (linux)
  - nice (linux)
  - num_fds (linux)
  - num_ctx_switches (linux)
  - num_threads (linux, freebsd, windows)
  - cpu_times (linux)
  - memory_info (linux, freebsd)
  - memory_info_ex (linux)
  - memory_maps() (linux)
  - open_files (linux)
  - send_signal (linux, freebsd)
  - suspend (linux, freebsd)
  - resume (linux, freebsd)
  - terminate (linux, freebsd)
  - kill (linux, freebsd)
not yet
- cpu_percent
- cpu_times_percent
- net_connections
- Process class
  - username
  - ionice
  - rlimit
  - num_handlers
  - threads
  - cpu_percent
  - cpu_affinity
  - memory_percent
  - children
  - connections
  - is_running
future work
- process_iter
- wait_procs
- Process class
  - parent (use ppid instead)
  - as_dict
  - wait

License

New BSD License (same as psutil)

Related 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/

I have influenced from these great works.

How to Contributing

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

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

tracymacding/gopsutil