https://github.com/penberg/ustat
ustat - an unified system stats collector tool
https://github.com/penberg/ustat
go linux stats stats-collector
Last synced: about 1 year ago
JSON representation
ustat - an unified system stats collector tool
- Host: GitHub
- URL: https://github.com/penberg/ustat
- Owner: penberg
- License: mit
- Created: 2017-06-07T14:30:24.000Z (about 9 years ago)
- Default Branch: master
- Last Pushed: 2018-02-05T08:55:39.000Z (over 8 years ago)
- Last Synced: 2025-03-25T07:51:13.294Z (over 1 year ago)
- Topics: go, linux, stats, stats-collector
- Language: Go
- Homepage:
- Size: 28.3 KB
- Stars: 23
- Watchers: 3
- Forks: 0
- Open Issues: 5
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE
Awesome Lists containing this project
README
# ustat
[](http://travis-ci.org/penberg/ustat)
`ustat` is an unified system stats collector for Linux, which combines capabilities of tools like `vmstat`, `mpstat`, `iostat`, and `ifstat`.
The tool is designed for low collection overhead to make it suitable for stats collection when evaluating system performance under load.
The main objective of `ustat` is to collect detailed stats rather than aggregate stats so that it is possible to drill down to details during analysis.
The `ustat` tool reports collected stats in a self-describing, [delimiter-separated values](https://en.wikipedia.org/wiki/Delimiter-separated_values) (DSV) format file that is easy to post process using tools like [ggplot2](http://ggplot2.org/) for R and [gnuplot](http://www.gnuplot.info/).
## Install
```sh
go get -u github.com/penberg/ustat/cmd/ustat
```
## Usage
To collect stats, run:
```sh
ustat record 1
```
In the above example, `ustat` collects all stats it supports and samples them every one second.
Please use the `ustat --help` command for more information on supported stats collectors and other command line options.
## Related Tools
* [dstat](http://dag.wiee.rs/home-made/dstat/) - Versatile resource statistics tool. The tool provides similar capabilities as `ustat` but is written in [Python](https://www.python.org/), which has higher collection overhead, and does not provide detailed stats for everything (e.g. interrupts).
## Authors
* [Pekka Enberg](https://penberg.github.io/)
See also the list of [contributors](https://github.com/penberg/ustat/contributors) who participated in this project.
## License
`ustat` is licensed under the MIT License. See the [LICENSE](LICENSE) file for details.