63 lines
1.9 KiB
Markdown

Tracing Openstack with Tomograph
================================
1. Install Openstack using your preferred method.
2. Git clone tomograph
git clone git@github.com:timjr/tomograph.git
cd tomograph
sudo python setup.py develop
3. Apply tomograph patches to Openstack:
cd nova; patch -p1 < tomograph/doc/openstack-patches/nova-stable-folsom.patch
cd keystone; patch -p1 < tomograph/doc/openstack-patches/keystone-stable-folsom.patch
cd glance; patch -p1 < tomograph/doc/openstack-patches/glance-stable-folsom.patch
cd glance-client; patch -p1 < tomograph/doc/openstack-patches/glance-client-stable-folsom.patch
4. Restart Openstack and boot a VM. You should see log messages from the tomograph logging backend:
2013-04-18 02:02:08,797 INFO tomograph.backends.log Span(trace_id=5731049070570866, parent_id=None, ...
Viewing Traces in Zipkin
------------------------
1. Set up cassandra, (something like the following):
wget http://mirror.metrocast.net/apache/cassandra/1.2.3/apache-cassandra-1.2.3-bin.tar.gz
tar xvzf apache-cassandra-1.2.3-bin.tar.gz
sudo mkdir /var/lib/cassandra
sudo chmod a+rw /var/lib/cassandra
sudo mkdir /var/log/cassandra
sudo chmod a+rw /var/log/cassandra
apache-cassandra-1.2.3/bin/cassandra &> cassandra-out
2. Get zipkin and set up its schema:
git clone git://github.com/twitter/zipkin.git
apache-cassandra-1.2.3/bin/cassandra-cli -host localhost -port 9160 -f zipkin/zipkin-cassandra/src/schema/cassandra-schema.txt
3. Start the zipkin components:
cd zipkin
setsid bin/collector &> collector-out
setsid bin/query &> query-out
setsid bin/web &> web-out
3. Restart Openstack
4. Boot a VM
5. View the trace:
visit http://localhost:8080
select rpcrun_instance from the service menu
make sure the time is set to now or later than now
"find traces"
click on the rpcrun_instance trace