Changes between Version 5 and Version 6 of HealthMonitoring

Timestamp:

03/25/12 23:10:34 (13 years ago)

Author:

jesseeichar

Comment:

--

HealthMonitoring

@@ -34 +34 @@
 The Metrics library (http://metrics.codahale.com/) by Yammer has excellent support for monitoring the performance and health of a system.  It provides a consistent API for developers to register some vital statistics of an application.  For example in Geonetwork we might want to have a monitor system (like nagios or collectd) check the health of the system which would include checking the database connection, ability to open files, check the index, etc...  In addition we might want to attach a Metrics appended to the logging to track the number of errors being logged and the monitor system would be able to warn of a potentially unstable system based on the number of errors being logged.
 
-Metrics has 2 Apis, one for configuring the health checks and another for performing the configured health checks.  The 'out' Apis include JMX, JSON as well as HTML pages that could be integrated into the admin user interface.
+Metrics has 2 Apis, one for configuring the health checks and another for performing the configured health checks.  The 'out' Apis include JMX and JSON.  For this proposal 4 new servlet mappings will be defined for accessing the monitor information:
+  - /ping - returns pong if server is still working
+  - /metrics?pretty=(true|false) - returns a json response with all of the registered metrics
+  - /threads - returns a text representation of the stack dump at the moment of the call
+  - /healthcheck - returns 200 if all checks pass or 500 Internal Service Error if one fails (and human readable response of the failures)
+
+A link will be made from the Admin/config.info page will be made to these servlets so a administrator can easily access this data.  In a future implementation we can possible add a more attractive UI for viewing the information.
 
 It is important to realize that metrics is not exactly the same as statistics in my use case.  While it could be used in some capacity for statistics, in this proposal metrics will be used as a standard API and utilities for creating a monitoring subsystem that is flexible, extensible and can interoperate with many existing monitoring systems.
@@ -48 +54 @@
 === Backwards Compatibility Issues ===
 
-A new dependency and update to web.xml optionally
+A new dependency and new ma
 
 == Risks ==