This project will no longer be maintained by Intel.
Intel has ceased development and contributions including, but not limited to, maintenance, bug fixes, new releases, or updates, to this project.
Intel no longer accepts patches to this project.
If you have an ongoing need to use this project, are interested in independently developing it, or would like to maintain patches for the open source software community, please create your own fork of this project.
Contact: [email protected]
Important
Intel® System Health Inspector functionality and future development has been moved to Intel® PerfSpect. For the latest updates and continued development, please visit the PerfSpect project at https://github.com/intel/PerfSpect.
System Health Inspector aka "svr-info" is a Linux command line tool used to assess the health of Intel® Xeon® processor-based servers.
wget -qO- https://github.com/intel/svr-info/releases/latest/download/svr-info.tgz | tar xvz
cd svr-info
./svr-info
Data can be collected from a single remote target by providing the login credentials of the target on the svr-info command line.
./svr-info -ip 10.100.222.123 -user fred -key ~/.ssh/id_rsa
Data can be collected from multiple remote targets by placing login credentials of the targets in a 'targets' file and then referencing that targets file on the svr-info command line. See the included targets.example file for the required file format.
./svr-info -targets <targets file>
Micro-benchmarks can be executed by svr-info to assess the health of the target system(s). See the help (-h) for the complete list of available benchmarks. To run all benchmarks:
./svr-info -benchmark all
Notes:
- Benchmarks should not be run on live/production systems. Production workload performance may be impacted.
- Running all benchmarks, i.e.,
--benchmark all, will take 4+ minutes to run. The frequency benchmark execution time increases with core count (approx. (# of cores + 10)s). If not all benchmarks are required, use the--helpoption to see how to choose specific benchmarks, e.g.,--benchmark cpu,disk.
Subsystems on live/production system(s) can be profiled by svr-info. See the help (-h) for the complete list of subsystems. To profile all subsystems:
./svr-info -profile all
Workloads on live/production system(s) can be analyzed by svr-info. One or more perf flamegraphs will be produced. See the help (-h) for options. To analyze system and Java apps:
./svr-info -analyze all
By default svr-info produces HTML, JSON, and Microsoft Excel formatted reports. There is an optional txt report that includes the commands that were executed on the target to collect data and their output. See the help (-h) for report format options. To generate only HTML reports:
./svr-info -format html
Additional data collection tools can be used by svr-info by placing them in a directory named "extras". For example, Intel® Memory Latency Checker can be downloaded from here: MLC. Once downloaded, extract the Linux executable and place in the svr-info/extras directory.
We welcome bug reports, questions and feature requests. Please submit via Github Issues.
Due to the large number of build dependencies required, a Docker container-based build environment is provided. Assuming your system has Docker installed (instructions not provided here), the following steps are required to build svr-info:
builder/buildcreates the necessary docker images and runs make in the container After a successful build, you will find the build output in thedistfolder.
After a complete build using the build container, you can perform incremental builds directly on your host assuming dependencies are installed there. This can make the code/build/test cycle much quicker than rebuilding everything using the Docker container.
If you are working on a single go-based app. You can run go build to build it.
Additional data collection tools can be built into the svr-info distribution by placing binaries in the bin directory before starting the build.