Cloned from launchpad blueprint https://blueprints.launchpad.net/oslo/+spec/middleware-request-id.

Description:

According to the thread of request-id [1],
there seems a need for a wsgi middleware which generates request-id
for each REST request and ensures it in a corresponding response.
The middlware is located outer-most of a wsgi pipeline,
catches all kind of exceptions and ensures request-id in a response.
It is the concept swift already has as catch_error middleware.

The feature of the proposed middleware is simple:
  * Catch all exceptions in wsgi pipeline
  * Generate request-id for each REST request
  * Set the generated request-id to request environment
  * Add X-OpenStack-Request-Id header to API response to return request-id
  * Expected to place outer-most (i.e., first) in wsgi pipeline

The initial implemetation proposed to neutron is available at
https://review.openstack.org/#/c/58270/
(The name of middleware is not good....)

[1] http://lists.openstack.org/pipermail/openstack-dev/2013-November/thread.html#20683
[2] http://lists.openstack.org/pipermail/openstack-dev/2013-December/021422.html


Specification URL (additional information):

None