README
¶
taskstats 
Package taskstats provides access to Linux's taskstats interface, for sending
per-task, per-process, and cgroup statistics from the kernel to userspace.
For more information on taskstats, please see:
- https://www.kernel.org/doc/Documentation/accounting/cgroupstats.txt
- https://www.kernel.org/doc/Documentation/accounting/taskstats.txt
- https://www.kernel.org/doc/Documentation/accounting/taskstats-struct.txt
- https://andrestc.com/post/linux-delay-accounting/
Notes
-
When instrumenting Go programs, use either the
taskstats.Self()ortaskstats.TGID()method. Using thePID()method on multithreaded programs, including Go programs, will produce inaccurate results. -
Access to taskstats requires that the application have at least
CAP_NET_RAWcapability (see capabilities(7)). Otherwise, the application must be run as root. -
If running the application in a container (e.g. via Docker), it cannot be run in a network namespace -- usually this means that host networking must be used.
MIT Licensed.
Documentation
¶
Overview ¶
Package taskstats provides access to Linux's taskstats interface, for sending per-task, per-process, and cgroup statistics from the kernel to userspace.
For more information on taskstats, please see:
Index ¶
Constants ¶
This section is empty.
Variables ¶
This section is empty.
Functions ¶
This section is empty.
Types ¶
type CGroupStats ¶
type CGroupStats struct {
Sleeping uint64
Running uint64
Stopped uint64
Uninterruptible uint64
IOWait uint64
}
CGroupStats contains statistics for tasks of an individual cgroup.
type Client ¶
type Client struct {
// contains filtered or unexported fields
}
A Client provides access to Linux taskstats information.
Some Client operations require elevated privileges.
func (*Client) CGroupStats ¶
func (c *Client) CGroupStats(path string) (*CGroupStats, error)
CGroupStats retrieves cgroup statistics for the cgroup specified by path. Path should be a CPU cgroup path found in sysfs, such as:
- /sys/fs/cgroup/cpu
- /sys/fs/cgroup/cpu/docker
- /sys/fs/cgroup/cpu/docker/(hexadecimal identifier)
type Stats ¶
type Stats struct {
BeginTime time.Time
ElapsedTime time.Duration
UserCPUTime time.Duration
SystemCPUTime time.Duration
MinorPageFaults uint64
MajorPageFaults uint64
CPUDelayCount uint64
CPUDelay time.Duration
BlockIODelayCount uint64
BlockIODelay time.Duration
SwapInDelayCount uint64
SwapInDelay time.Duration
FreePagesDelayCount uint64
FreePagesDelay time.Duration
}
Stats contains statistics for an individual task.
Source Files