Skip to content

npalaska/pbench

 
 

Repository files navigation

Pbench

A Benchmarking and Performance Analysis Framework

The code base includes three sub-systems. The first is the collection agent, pbench-agent, responsible for providing commands for running benchmarks across one or more systems, while properly collecting the configuration data for those systems, and specified telemetry or data from various tools (sar, vmstat, perf, etc.).

The second sub-system is the pbench-server, which is responsible for archiving result tar balls, indexing them, and unpacking them for display.

The third sub-system is the web-server JS and CSS files, used to display various graphs and results, and any other content generated by the pbench-agent during benchmark and tool post-processing steps.

The pbench Dashboard code lives in its own repository.

How is it installed?

Instructions on installing pbench-agent, can be found in the Pbench agent installation guide.

For Fedora, CentOS, and RHEL users, we have made available COPR builds for the pbench-agent, configtools, pbench-server, pbench-web-server and some benchmark and tool packages.

This assumes that somebody has already installed the server bits. The procedure to do that is described in the Pbench Server Installation guide.

You can install the web-server sub-system on the machine from where you want to run the pbench-agent. That allows you to view the graphs before sending the results to the server, or even if there is no server to which to send the results. See the Pbench web server installation guide.

You might want to browse through the rest of the documentation.

How do I use pbench?

Refer to the Pbench User Guide.

TL;DR? See TL;DR - How to set up pbench and run a benchmark of the Pbench User Guide for a super quick set of introductory steps.

Where is the source kept?

The latest source code is at https://github.com/distributed-system-analysis/pbench.

The pbench dashboard code is at https://github.com/distributed-system-analysis/pbench-dashboard.

Is there a mailing list for discussions?

Yes, we use Google Groups

Is there a place to track current and future work items?

Yes, we are using GitHub Projects. Please find projects covering the Agent, Server, and a project that is named the same as the current milestone.

About

A benchmarking and performance analysis framework

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages

  • Shell 29.4%
  • Python 26.9%
  • Perl 23.8%
  • HTML 11.6%
  • JavaScript 7.4%
  • Makefile 0.4%
  • Other 0.5%