shirou/gopsutil là dự án phía máy chủ trên GitHub với 11.9k sao, viết chủ yếu bằng Go. psutil for golang
Tóm tắt dựng từ metadata GitHub của chính dự án — chưa có bài review TopGit. Trang sẽ tự động cập nhật khi bài review đầy đủ được xuất bản.
VÌ SAO CHƯA CÓ REVIEW
TopGit viết bài đầy đủ cho repo có nhiều sao nhất và được yêu cầu nhiều nhất. Trang này là snapshot trong thời gian chờ — xem README gốc ở tab READ ME.
This is a port of psutil (https://github.com/giampaolo/psutil). The
challenge is porting all psutil functions on some architectures.
migration
v4 migration
There are some breaking changes. Please see v4 release note.
Tag semantics
gopsutil tag policy is almost same as Semantic Versioning, but
automatically increases like Ubuntu versioning.
For example, v4.24.04 means
v4: major version
24: release year, 2024
04: release month
gopsutil aims to keep backwards compatibility until major version change.
Tagged at every end of month, but if there are only a few commits, it
can be skipped.
Available Architectures
FreeBSD i386/amd64/arm
Linux i386/amd64/arm(raspberry pi)
Windows i386/amd64/arm/arm64
Darwin amd64/arm64
OpenBSD i386/amd64/armv7/arm64/riscv64 (Thank you @mpfz0r!)
Solaris amd64 (developed and tested on SmartOS/Illumos, Thank you @jen20!)
These have partial support:
CPU on DragonFly BSD (#893, Thank you @gballet!)
host on Linux RISC-V (#896, Thank you @tklauser!)
All works are implemented without cgo by porting C structs to Go structs.
Usage
package main
import (
"fmt"
"github.com/shirou/gopsutil/v4/mem"
)
func main() {
v, _ := mem.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)
}
You can set alternative locations for various system directories by using the following environment variables:
/proc: HOST_PROC
/sys: HOST_SYS
/etc: HOST_ETC
/var: HOST_VAR
/run: HOST_RUN
/dev: HOST_DEV
/: HOST_ROOT
/proc/N/mountinfo: HOST_PROC_MOUNTINFO
Adding settings using context (from v3.23.6)
As of v3.23.6, it is now possible to pass a path location using context: import "github.com/shirou/gopsutil/v3/common" and pass a context with common.EnvMap set to common.EnvKey, and the location will be used within each function.
First priority is given to the value set in context, then the value from the environment variable, and finally the default location.
Caching
As of v3.24.1, it is now possible to cached some values. These values default to false, not cached.
Be very careful that enabling the cache may cause inconsistencies. For example, if you enable caching of boottime on Linux, be aware that unintended values may be returned if the boottime is changed by NTP after booted.
host
EnableBootTimeCache
process
EnableBootTimeCache
Ex struct (from v4.24.5)
gopsutil is designed to work across multiple platforms. However, there are differences in the information available on different platforms, such as memory information that exists on Linux but not on Windows.
As of v4.24.5, to access this platform-specific information, gopsutil provides functions named Ex within the package. Currently, these functions are available in the cpu, mem, and sensors packages.
The Ex structs are specific to each platform. For example, on Linux, there is an ExLinux struct, which can be obtained using the mem.NewExLinux() function. On Windows, it's mem.ExWindows(). These Ex structs provide platform-specific information.
gopsutil aims to minimize platform differences by offering common functions. However, there are many requests to obtain unique information for each platform. The Ex structs are designed to meet those requests. Additional functionalities might be added in the future. The use of these structures makes it clear that the information they provide is specific to each platform, which is why they have been designed in this way.
On Linux, cpu.NewExLinux().Times(percpu) returns []cpu.ExTimesStat with the raw uint64 counters from /proc/stat, in USER_HZ ticks instead of the float64 seconds of cpu.Times. This allows integer deltas to be computed before unit conversion. A counter can decrease, in particular iowait, so check that the new value is not smaller than the old one before you subtract. See the kernel's /proc/stat documentation for the meaning of each counter.
Documentation
See https://pkg.go.dev/github.com/shirou/gopsutil/v4 or https://godocs.io/github.com/shirou/gopsutil/v4
Requirements
go1.18 or above is required.
More Info
Several methods have been added which are not present in psutil, but
will provide useful information.
host/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")
IOCounters
Label (linux only) The registered device mapper
name
cpu/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 ...")
shirou/gopsutil thuộc nhóm Backend trên TopGit, cùng 3 topic GitHub. Trang Trending và Topics liệt kê các repo cùng số sao và cùng ngôn ngữ để so sánh.
Đọc thêm về shirou/gopsutil ở đâu?
Trang TopGit này là một snapshot — tab "Readme" hiển thị nguyên văn README của repo (đã bỏ link, giữ ảnh). Repo GitHub ở github.com/shirou/gopsutil là nguồn chính thức.
shirou/gopsutil có phải mã nguồn mở không?
TopGit chưa ghi nhận license cho shirou/gopsutil. Phần lớn repo public trên GitHub là mã nguồn mở, nhưng điều khoản khác nhau từng repo — mở file LICENSE để xác nhận.
shirou/gopsutil là gì?
shirou/gopsutil (shirou/gopsutil) là dự án Go trên GitHub. Theo mô tả gốc: psutil for golang
shirou/gopsutil so với các dự án Backend khác thế nào?
shirou/gopsutil được TopGit xếp vào nhóm Backend, với 11.9k sao GitHub và viết bằng Go. Xem trang chủ đề Backend trên TopGit để so sánh với các dự án tương tự theo số sao và mức độ hoạt động.
Vì sao shirou/gopsutil được xếp vào nhóm Backend?
TopGit xếp shirou/gopsutil vào nhóm Backend dựa trên GitHub topics và mô tả của repo (gắn thẻ: "go", "golang", "system-information"). Việc phân loại dựa trên metadata thật của repo, không phải đoán theo cảm tính biên tập.
Đọc đầy đủ README ở tab phía trên.
gopsutil có đáng để bạn bỏ thời gian?
ChatGPT, Claude và Perplexity đều đọc được trang này. Hỏi thử xem họ nghĩ gì về gopsutil.