Metadata-Version: 1.1
Name: perfwhiz
Version: 0.1.0
Summary: Tools for Linux perf
Home-page: https://github.com/cisco-oss-eng/perfwhiz
Author: Alec Hothan
Author-email: ahothan@cisco.com
License: UNKNOWN
Description: ========
        Overview
        ========
        
        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
        generate from the perf traces a visualization of Linux scheduler context switches and KVM events:
        
        - context switch heat maps (temporal distribution of context switch events)
        - KVM exit heat maps (temporal distribution of kvm entry and exit events)
        - KVM exit types distribution stacked bar charts (exit type distribution per task)
        - task scheduler core assignment heat maps (run time % on each core per task - including IDLE time)
        - task per core context switch count heat maps (how many context switches per core per task)
        - core locality heat maps (on which core does task run over time)
        
        
        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:
         `<http://perfwhiz.readthedocs.org/en/latest/>`_
        
        Heatmap Gallery
        ---------------
        
        (to add sample html files with embedded Java Script - try it out for now if you're curious)
        
        perfwhiz Workflow
        ------------------
        
        .. image:: images/perfwhiz.png
        
        Licensing
        ---------
        
        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.
        
        Links
        -----
        
        * Documentation: http://perfwhiz.readthedocs.org/en/latest/
        * Source: https://github.com/cisco-oss-eng/perfwhiz
        * Supports/Bugs: https://github.com/cisco-oss-eng/perfwhiz
        * Gitter Room: https://gitter.im/cisco-oss-eng/perfwhiz
        
        .. image:: https://badges.gitter.im/Join%20Chat.svg
           :alt: Join the chat at https://gitter.im/cisco-oss-eng/perfwhiz
           :target: https://gitter.im/cisco-oss-eng/perfwhiz?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge
        
        
Keywords: Linux perf tools
Platform: UNKNOWN
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: Information Technology
Classifier: Intended Audience :: System Administrators
Classifier: License :: OSI Approved :: Apache Software License
Classifier: Operating System :: POSIX :: Linux
Classifier: Operating System :: MacOS
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 2
Classifier: Programming Language :: Python :: 2.7
