diff options
author | Jenkins <jenkins@review.openstack.org> | 2012-06-28 14:08:10 +0000 |
---|---|---|
committer | Gerrit Code Review <review@openstack.org> | 2012-06-28 14:08:10 +0000 |
commit | 43ee35ad58deb479f36374f2132da60a8d3649df (patch) | |
tree | 75d66f70eb70ff21d5b3adf6a463836dd5d66eeb /doc | |
parent | 4f99a9dcba856623f5fe92f422563649d5cdcf73 (diff) | |
parent | ef58425b8e5be5818884108c92bfb208cdb3d741 (diff) | |
download | keystone-43ee35ad58deb479f36374f2132da60a8d3649df.tar.gz keystone-43ee35ad58deb479f36374f2132da60a8d3649df.tar.xz keystone-43ee35ad58deb479f36374f2132da60a8d3649df.zip |
Merge "Basic request stats monitoring & reporting"
Diffstat (limited to 'doc')
-rw-r--r-- | doc/source/configuration.rst | 33 |
1 files changed, 33 insertions, 0 deletions
diff --git a/doc/source/configuration.rst b/doc/source/configuration.rst index d7ddfe89..415ee539 100644 --- a/doc/source/configuration.rst +++ b/doc/source/configuration.rst @@ -151,6 +151,39 @@ choosing the output levels and formats. .. _Paste: http://pythonpaste.org/ .. _`python logging module`: http://docs.python.org/library/logging.html +Monitoring +---------- + +Keystone provides some basic request/response monitoring statistics out of the +box. + +Enable data collection by defining a ``stats_monitoring`` filter and including +it at the beginning of any desired WSGI pipelines:: + + [filter:stats_monitoring] + paste.filter_factory = keystone.contrib.stats:StatsMiddleware.factory + + [pipeline:public_api] + pipeline = stats_monitoring [...] public_service + +Enable the reporting of collected data by defining a ``stats_reporting`` filter +and including it near the end of your ``admin_api`` WSGI pipeline (After +``*_body`` middleware and before ``*_extension`` filters is recommended):: + + [filter:stats_reporting] + paste.filter_factory = keystone.contrib.stats:StatsExtension.factory + + [pipeline:admin_api] + pipeline = [...] json_body stats_reporting ec2_extension [...] admin_service + +Query the admin API for statistics using:: + + $ curl -H 'X-Auth-Token: ADMIN' http://localhost:35357/v2.0/OS-STATS/stats + +Reset collected data using:: + + $ curl -H 'X-Auth-Token: ADMIN' -X DELETE http://localhost:35357/v2.0/OS-STATS/stats + SSL --- |