Tools for Linux perf
This repository contains a set of python scripts for helping tune any Linux system for performance and scale by leveraging the Linux perf tool and generating from the perf traces 2 HTML dashboards that represent Linux scheduler context switches and KVM events.
The basic dashboard illustrates general scheduler and KVM events for all tasks selected at capture time:
The detailed dashboard illustrates detailed scheduler and KVM events at the task level:
The task annotation feature further allows the generation of cross-run charts (diffs) that can help detect more easily differences of behavior across multiple captures/runs.
The capture script wraps around the Linux perf tool to capture events of interest (such as context switches and kvm events) and generates a much more compact binary file to be used for analysis offline.
Complete documentation including installation and usage instructions:
The following diagram illustrates the 2 phases for getting the dashboards: capture phase (perfcap.py) and dashboard generation phase (perfmap.py).
Capture is performed on the system under test, by invoking the perfcap.py script and specify which tasks to capture events from and for how long. The result of each capture is a binary file (with the cdict extension, cdict stands for compressed dictionary).
The binary files can then later be provided to the dashboard generation tool (perfmap.py) to generate the corresponding dashboards. This dashboard generation phase is typically done offline on a workstation where perfmap is installed (laptop, macbook…). The generated dashboards are HTML files that can be viewed using any browser.
Dependencies are automatically installed when perfwhiz is being installed (refer to the Installation section).
The capture tool perfcap.py depends on:
The dashboard generation tool perfmap.py depends on:
perfwhiz is licensed under the Apache License, Version 2.0 (the “License”). You may not use this tool except in compliance with the License. You may obtain a copy of the License at http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an “AS IS” BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.
Perfwhiz includes a copy of umsgpack.py (MIT License) in its distribution (https://github.com/vsergeev/u-msgpack-python, many thanks to vsergeev)
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
|File Name & Checksum SHA256 Checksum Help||Version||File Type||Upload Date|
|perfwhiz-0.3.1-py2.py3-none-any.whl (51.9 kB) Copy SHA256 Checksum SHA256||py2.py3||Wheel||Sep 10, 2016|
|perfwhiz-0.3.1.tar.gz (444.0 kB) Copy SHA256 Checksum SHA256||–||Source||Sep 10, 2016|