MagnetoDB/specs/monitoring-health-check
Contents
- 1 Monitoring - healthcheck http request
- 1.1 Specification status
- 1.2 Problem Description
- 1.3 Proposed Change
- 1.3.1 Use Cases
- 1.3.2 Request Syntax
- 1.3.3 Headers
- 1.3.4 Response Code
- 1.3.5 Response Body
- 1.3.6 Intristic implementation
- 1.3.7 Alternatives
- 1.3.8 Security Impact
- 1.3.9 Notifications Impact
- 1.3.10 Other End User Impact
- 1.3.11 Performance Impact
- 1.3.12 Other Deployer Impact
- 1.3.13 Developer Impact
- 1.3.14 Implementation
- 1.3.15 Documentation Impact
- 1.3.16 References
Monitoring - healthcheck http request
Launchpad: [1]
Request for check MagnetoDB health status.
Specification status
Approved isviridov
Problem Description
Service administrators should have an ability for lightweigt checking of MagnetoDB health status.
Proposed Change
It should be http request without credentials, that will allow to understand that: 1. magnetodb-api service is running 2. Keystone is available to magnetodb-api 3. Backend is available to magnetodb-api and working properly
Use Cases
1. Checking magnetodb-api server availability without subsystems 2. Checking magnetodb-api server availability and checking its connectivity to Keystone and Cassandra
Request Syntax
HTTP /healthcheck HTTP /healthcheck?fullcheck=true
Headers
* User-Agent * Accept: text/plain
Response Code
200 or 503
Response Body
"OK|Cassanra: ERROR|Keystone: ERROR|Keystone: ERROR, Cassandra: ERROR"
Intristic implementation
Keystone availability will be checked by sending request:
GET /
This request should return available versions of Keystone API with 200 code.
Cassandra availability will be checked with quering "magnetodb.table_info" table:
SELECT * FROM magnetodb.table_info LIMIT 1;
Method
bool health_check()
will be added to storage API.
Alternatives
none
Security Impact
We consider that this request will not need any credentials and an ability to send it to MagnetoDB should be under external control
Notifications Impact
none
Other End User Impact
none
Performance Impact
none
Other Deployer Impact
none
Developer Impact
none
Implementation
Same health check request needs to be implemented for magnetodb-streaming-api
Assignee(s)
Primary assignee:
aostapenko
Other contributors:
none
Work Items
none
Dependencies
none
Documentation Impact
Feature needs to be described in doc sources
References
none