Updated doc with debug instructions

This commits adds some info about how you can use debugger in
ceilometer.
Currently testr cannot break into debugger, you have to use
alternative test runner to use it.

Change-Id: Ica68da3da5d8162765a79686d29ffd8d8d9cc85f
Merge "Updated doc with debug instructions"