Gitiles
Code Review Sign In
gerrit-public.fairphone.software / platform / external / trappy / a74ef6f6ee5416e6366bf83a1ddde71bd0b6c7f5
commita74ef6f6ee5416e6366bf83a1ddde71bd0b6c7f5[log] [tgz]
authorKevin DuBois <kevindubois@google.com>Mon Oct 23 11:07:15 2017 -0700
committerKevin DuBois <kevindubois@google.com>Mon Oct 23 11:09:11 2017 -0700
tree9c43e07e16ecb77fcdeea6704391533ce7cfe37b
parenta10ee682fdf16d6ff801e726e731d7196a75a809 [diff]
parse traces from ext4 events

Adds trace parsing for ext4_da_write_begin, ext4_da_write_end,
ext4_sync_file_enter, and ext4_sync_file_exit events

Test: run the 4 new unit tests (nosetests tests/test_filesystem.py)

Change-Id: I9b7049d5e9879cc3dedb5fd9d3d1433fa8304618
4 files changed
tree: 9c43e07e16ecb77fcdeea6704391533ce7cfe37b
  1. doc/
  2. hooks/
  3. scripts/
  4. tests/
  5. trappy/
  6. .dir-locals.el
  7. .gitignore
  8. .travis.yml
  9. LICENSE
  10. README.md
  11. setup.cfg
  12. setup.py
README.md

TRAPpy Build Status Version

TRAPpy (Trace Analysis and Plotting in Python) is a visualization tool to help analyze data generated on a device. It parses ftrace-like logs and creates in-memory data structures to be used for plotting and data analysis.

Installation

The following instructions are for Ubuntu 14.04 LTS but they should also work with Debian jessie. Older versions of Ubuntu or Debian (e.g. Ubuntu 12.04 or Debian wheezy) will likely require to install more packages from pip as the ones present in Ubuntu 12.04 or Debian wheezy will probably be too old.

Required dependencies

Install additional tools required for some tests and functionalities
$ sudo apt install trace-cmd kernelshark
Install the Python package manager
$ sudo apt install python-pip python-dev
Install required python packages
$ sudo apt install libfreetype6-dev libpng12-dev python-nose
$ sudo pip install numpy matplotlib pandas ipython[all]
Install TRAPpy
$ sudo pip install --upgrade trappy

Quickstart

Now launch the ipython notebook server:

$ ipython notebook

This should pop up a browser. If it doesn't, open a web browser and go to http://localhost:8888/tree/

In the doc/ folder there's a 00 - Quick start which describes how to run TRAPpy. Other notebooks in that directory describe other functions of TRAPpy.

Documentation

API reference can be found in https://pythonhosted.org/TRAPpy/

For developers

Clone the repository

The code of the TRAPpy toolkit with all the supported tests and Notebooks can be cloned from the official GitHub repository with this command:

$ git clone https://github.com/ARM-software/trappy.git

Testing your installation

An easy way to test your installation is to use the nosetests command from TRAPpy's home directory:

$ nosetests

If the installation is correct all tests will succeed.