Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/m-lab/nodeinfo
A system for periodically saving all hardware, software, and config info for M-Lab nodes.
https://github.com/m-lab/nodeinfo
Last synced: about 1 month ago
JSON representation
A system for periodically saving all hardware, software, and config info for M-Lab nodes.
- Host: GitHub
- URL: https://github.com/m-lab/nodeinfo
- Owner: m-lab
- License: apache-2.0
- Created: 2018-12-20T17:59:42.000Z (about 6 years ago)
- Default Branch: main
- Last Pushed: 2024-06-08T22:49:48.000Z (7 months ago)
- Last Synced: 2024-10-29T14:41:12.389Z (about 2 months ago)
- Language: Go
- Size: 81.1 KB
- Stars: 2
- Watchers: 13
- Forks: 0
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# nodeinfo
[](https://godoc.org/github.com/m-lab/nodeinfo) [](https://travis-ci.org/m-lab/nodeinfo) [](https://coveralls.io/github/m-lab/nodeinfo?branch=master) [](https://goreportcard.com/report/github.com/m-lab/nodeinfo)
This collects data about the hardware, software, and configs on nodes on the
[M-Lab](https://www.measurementlab.net) platform. Every hour (in expectation,
with some randomization) the output of `lspci`, `lshw`, `ifconfig`, and others
is written to disk. This allows us to track the configuration of fleet nodes
over time.
Available as a container in
[measurementlab/nodeinfo](https://hub.docker.com/r/measurementlab/nodeinfo/) on
Docker Hub.
## design
As simple as possible. This system is called `nodeinfo`. Every command produces its own type of data, and so is it own datatype. These two facts, together with [M-Lab's unified naming scheme for data](http://example.com), and the best practices for [Pusher](http://github.com/m-lab/pusher) mean that the directory structure for output is fully determined.
This program calls a series of other programs, and directs the output of each call to the appropriate output file. The set of programs to call is currently hard-coded in the binary. If any of the commands run unsuccessfully, this crashes. Every command is rerun every hour on average, with some randomness. The inter-run times are drawn from the exponential distribution to try and make sure the resulting series of measurements has the [PASTA property](https://en.wikipedia.org/wiki/Arrival_theorem).
## example config file
```json
[
{
"Datatype": "lshw",
"Filename": "lshw.json",
"Cmd": ["lshw", "-json"]
},
{
"Datatype": "lspci",
"Filename": "lspci.txt",
"Cmd": ["lspci", "-mm", "-vv", "-k", "-nn"]
},
{
"Datatype": "lsusb",
"Filename": "lsusb.txt",
"Cmd": ["lsusb", "-v"]
},
{
"Datatype": "ip-address",
"Filename": "ip-address.txt",
"Cmd": ["ip", "address", "show"]
},
{
"Datatype": "ip-route-4",
"Filename": "ip-route-4.txt",
"Cmd": ["ip", "-4", "route", "show"]
},
{
"Datatype": "ip-route-6",
"Filename": "ip-route-6.txt",
"Cmd": ["ip", "-6", "route", "show"]
},
{
"Datatype": "uname",
"Filename": "uname.txt",
"Cmd": ["uname", "-a"]
},
{
"Datatype": "os-release",
"Filename": "os-release.txt",
"Cmd": ["cat", "/etc/os-release"]
},
{
"Datatype": "bios_version",
"Filename": "bios_version.txt",
"Cmd": ["cat", "/sys/class/dmi/id/bios_version"]
},
{
"Datatype": "chassis_serial",
"Filename": "chassis_serial.txt",
"Cmd": ["cat", "/sys/class/dmi/id/chassis_serial"]
}
]
```