tamarack 0.0.1

Setting It Up

Your system will need some basic packages before getting Tamarack up and running:

• Python 3.4, with development libraries (python3.4, python3.4-dev)

• Python package installer (python3-pip)

• PostgreSQL 9.3 or later, with extension modules (postgresql-9.3, postgresql-contrib-9.3)

Once those packages have been installed, you can begin setting up Tamarack. The first thing you will need is a virtual environment where all Python packages will be installed:

# Install virtualenv globally if you don't have it installed already
pip3 install virtualenv

# Create a Tamarack environment in /var/lib
virtualenv -p `which python3.4` /var/lib/tamarack

# Step into this virtual environment
source /var/lib/tamarack/bin/activate

# Install Tamarack from GitHub
pip install https://github.com/mhallin/tamarack/archive/develop.zip

# Create a configuration file
tamarack init /etc/tamarack.py

This will generate a configuration file at /etc/tamarack.py, which you will need to edit with the settings for your system. When you’re done, you’re ready to start Tamarack:

tamarack --config=/etc/tamarack.py server

This will start an HTTP server on port 3000, which you can visit in a web browser.

Where to Go From Here?

If you followed the instructions above and visited the page, you probably noticed that the list of applications is empty. Now you will need to integrate the Tamarack Collector in your application in order to start receiving profiling data.