tomograph/doc/openstack-patches/README.md

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

4. Restart Openstack

5. Boot a VM

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