+ heartBeat
Python 67.3% - Java 23.5% - JavaScript 7.1% - Shell 1.9% - HTML 0.1%
Last update : 03/06/2018 - 10:42
An implementation of heartbeat monitoring.
Definitions
- The
server is in charge of monitoring services
- When a
service is considered dead, the server then alerts its owner
- A
service is a pulsing agent
- A
pulse is a sign of aliveness
- When a
service pulse the server, it tells him when he will pulse again in the worst case
- If the
service has not pulsed again in time, the server considers the service dead and alerts its owner
- When a
service is no longer required, it must inform the server to avoid a false dead alerts
- An
Alert can be a mail, a pushover message, etc.
Implementation
- HTTP client / server architecture
- All queries protected by password set in HTTP headers under "password"
- Protocol :
- Pulse :
POST /{"service":"SERVICE_NAME","alertType":"ALERT_TYPE","alertTarget":"TARGET_NAME","nextIn":EXPECTED_NEXT_HEARTBEAT_IN_SECS}
- Cancel :
DELETE /{"service":"SERVICE_NAME"}
- List :
GET /
Server
./server- python3
- Dependencies :
pip install -r requirements.txt
- Config :
config/config.json : main config (cp config/sample.json config/config.json)config/server.crt, config/server.key : SSL certificate, used only if SSL activated
- Datas :
data
- Deploy :
- Install dependencies
- Setup config
- Generate ssl certificates (optional)
- Hook in with upstart (optional,
./server/config/sample.upstart.conf, http://upstart.ubuntu.com/getting-started.html)
- Run :
python server.py
- Docker :
./docker- Config : place server config files in
./docker/config
- Interactive :
cd docker && tools/dockerBuild && tools/dockerRun
- Detached :
cd docker && tools/dockerBuild && tools/dockerRunDetached
Java Client
./clientJava- Java 7+
- No dependencies
- Run test :
Python Client
./clientPython- python3
- Dependencies :
requests (pip install requests)
- Run test :
python test.py
Javascript client
./clientJavascriptclient.js is a node module- Dependencies :
packages.json -> devDependencies (npm install)
- Run test :
node test.js
- Run test in browser :
browserify test.js -o bundle.js and open test.html in browser
Certificates
- Self signed :
openssl req -x509 -sha256 -nodes -days 365 -newkey rsa:2048 -keyout server.key -out server.crt
- Letsencrypt : TODO
TODO
- Put data writing in a queue
- Put alert sending in a queue
server is in charge of monitoring servicesservice is considered dead, the server then alerts its ownerservice is a pulsing agentpulse is a sign of alivenessservice pulse the server, it tells him when he will pulse again in the worst caseservice has not pulsed again in time, the server considers the service dead and alerts its ownerservice is no longer required, it must inform the server to avoid a false dead alertsAlert can be a mail, a pushover message, etc.- HTTP client / server architecture
- All queries protected by password set in HTTP headers under "password"
- Protocol :
- Pulse :
POST /{"service":"SERVICE_NAME","alertType":"ALERT_TYPE","alertTarget":"TARGET_NAME","nextIn":EXPECTED_NEXT_HEARTBEAT_IN_SECS}
- Cancel :
DELETE /{"service":"SERVICE_NAME"}
- List :
GET /
- Pulse :
Server
./server- python3
- Dependencies :
pip install -r requirements.txt
- Config :
config/config.json : main config (cp config/sample.json config/config.json)config/server.crt, config/server.key : SSL certificate, used only if SSL activated
- Datas :
data
- Deploy :
- Install dependencies
- Setup config
- Generate ssl certificates (optional)
- Hook in with upstart (optional,
./server/config/sample.upstart.conf, http://upstart.ubuntu.com/getting-started.html)
- Run :
python server.py
- Docker :
./docker- Config : place server config files in
./docker/config
- Interactive :
cd docker && tools/dockerBuild && tools/dockerRun
- Detached :
cd docker && tools/dockerBuild && tools/dockerRunDetached
Java Client
./clientJava- Java 7+
- No dependencies
- Run test :
Python Client
./clientPython- python3
- Dependencies :
requests (pip install requests)
- Run test :
python test.py
Javascript client
./clientJavascriptclient.js is a node module- Dependencies :
packages.json -> devDependencies (npm install)
- Run test :
node test.js
- Run test in browser :
browserify test.js -o bundle.js and open test.html in browser
Certificates
- Self signed :
openssl req -x509 -sha256 -nodes -days 365 -newkey rsa:2048 -keyout server.key -out server.crt
- Letsencrypt : TODO
TODO
- Put data writing in a queue
- Put alert sending in a queue
./serverpip install -r requirements.txtconfig/config.json: main config (cp config/sample.json config/config.json)config/server.crt,config/server.key: SSL certificate, used only if SSL activated
data- Install dependencies
- Setup config
- Generate ssl certificates (optional)
- Hook in with upstart (optional,
./server/config/sample.upstart.conf, http://upstart.ubuntu.com/getting-started.html)
python server.py./docker- Config : place server config files in
./docker/config - Interactive :
cd docker && tools/dockerBuild && tools/dockerRun - Detached :
cd docker && tools/dockerBuild && tools/dockerRunDetached
./clientJava- Java 7+
- No dependencies
- Run test :
Python Client
./clientPython- python3
- Dependencies :
requests (pip install requests)
- Run test :
python test.py
Javascript client
./clientJavascriptclient.js is a node module- Dependencies :
packages.json -> devDependencies (npm install)
- Run test :
node test.js
- Run test in browser :
browserify test.js -o bundle.js and open test.html in browser
Certificates
- Self signed :
openssl req -x509 -sha256 -nodes -days 365 -newkey rsa:2048 -keyout server.key -out server.crt
- Letsencrypt : TODO
TODO
- Put data writing in a queue
- Put alert sending in a queue
./clientPythonrequests (pip install requests)python test.py./clientJavascriptclient.jsis a node module- Dependencies :
packages.json->devDependencies(npm install) - Run test :
node test.js - Run test in browser :
browserify test.js -o bundle.jsand opentest.htmlin browser
Certificates
- Self signed :
openssl req -x509 -sha256 -nodes -days 365 -newkey rsa:2048 -keyout server.key -out server.crt
- Letsencrypt : TODO
TODO
- Put data writing in a queue
- Put alert sending in a queue
openssl req -x509 -sha256 -nodes -days 365 -newkey rsa:2048 -keyout server.key -out server.crt- Put data writing in a queue
- Put alert sending in a queue
