tamarack 0.0.5

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. With Python 3.4 this should be easy easy, since Virtualenv now is bundled with the Python installation. However, this clashes with some Linux distributions’ package management and might require some manual setup:

## Skip this if you have pyvenv-3.4 available:

# Install virtualenv globally
pip3 install virtualenv

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

If you have pyvenv-3.4 available, you can simply use it instead:

## Skip this if you installed virtualenv above:

# Create a Tamarack environment in /var/lib
pyvenv-3.4 /var/lib/tamarack

Common for both setups is how you use them to install Tamarack:

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

# Install Tamarack
pip install tamarack

# 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.