A web application to monitor and analyze the performance of your code.
You will need Python 2.6+ and Django 1.1+.
In Ubuntu, they can be installed with sudo apt-get install python-django If you need SVN integration, pysvn is also requiered: sudo apt-get install python-svn
- Download a release and unpack it
For simplicity, you can use the default sqlite configuration, which will save the data to a database named
Create the DB by changing to the
speedcenter/directory and typing
python manage.py syncdb.
Create an admin user in the process.
For testing purposes, you can now start the development server
python manage.py runserver 8000.
The codespeed installation can now be accessed by navigating to
Note: for production, you should configure a real server like Apache, lighttpd, etc... (refer to the Django docs:
http://docs.djangoproject.com/en/dev/howto/deployment/). You should also modify
speedcenter/settings.py and set
DEBUG = False.
Before you can start saving (and displaying) data, you need to first create an environment and define a default project.
- Go to
http://localhost:8000/admin/codespeed/environment/and create an environment.
- Go to
http://localhost:8000/admin/codespeed/project/and create a project. Check the field "Track changes" and, in case you want version control integration, configure the relevant fields.
Note: Only executables associated to projects with a checked "track changes" field will be shown in the Overview and Timeline views.
Data is saved POSTing to
You can use the script
tools/save_single_result.py as a guide.
When trying to save data and the given executable, benchmark, project, or revision do not yet exist, they will be automatically created, together with the actual result entry. The only model which won't be created automatically is the environment. It must always exist or the data won't be saved (that is the reason it is described as a necessary step in the previous "Codespeed configuration" section).
The logo and title can be changed for every speedcenter.
templates/base.html, subtitute "My Speed Center" by your prefered name.
- The logo is defined in
<img src="/media/images/logo.png" height="48" alt="logo"/>.
Either substitute the file `speedcenter/media/images/logo.png" by your own logo, of change the tag to whatever you see fit.
The layout will stay exactly the same for any image with a height of 48px (any width will do).
- Home page: In
templates/home.html, modify the line
<p><a href="about/">This site</a> monitors <a href="#">MyProject</a>'s performance</p>.
- About page: modify
speedcenter/codespeed/settings.py can contain customizations of several parameters (the file includes comments with full examples).
- defaultexecutable: in the overview, a random executable is chosen as default. It that doesn't suite you, you can specify here which one should be selected. You need to specify its id (since the name alone is not unique).
- baselinelist: This option specifies which results (combination of an executable and a revision/tag) will be available as an option for comparing in the overview and as a baseline for the timeline view.
If nothing is specified, all revisions (together with their corresponding executables) that contain a tag will be included.
- defaultbaseline: Defines which baseline option will be chosen as default in the overview, and which one will be available as a basline in the timeline vies.