Adopt Oslo Guru Meditation Reports

This spec adopts Oslo Guru Meditation Reports in Heat. The feature will enhance debugging capabilities of all Heat services, by providing an easy and convenient way to collect debug data about current threads and configuration, among other things, to developers, operators, and tech support in production deployments.

Problem description

Currently,Heat doesn’t provide a way to collect state data from active service processes. The only information that is available to deployers, developers, and tech support is what was actually logged by the service. Additional data could be usefully used to debug and solve problems that occur during Heat operation. We could be interested in stack traces of green and real threads, pid/ppid info, package version, configuration as seen by the service, etc.

Oslo Guru Meditation Reports provide an easy way to add support for collecting the live state info from any service. Report generation is triggered by sending a special(USR1) signal to a service. Reports are generated on stderr, and can be piped into system log based on need.

Nova has supported Oslo Guru Meditation Reports.

Proposed change

First, the oslo-incubator module (reports.*) should be synchronized into heat tree. Then, each service process needs to initialize the error report system prior to the service start().





Primary assignee:



Target Milestone for completion:


Work Items

  • sync reports.* module from oslo-incubator

  • adopt it in all heat services under heat/bin/

  • add some developer docs on how to use this feature


[1] oslo-incubator module: [2] nova guru meditation reports: [3] blog about nova guru reports: [4] oslo.reports repo: