Monitoring Server
Monitoring server is a microservice which monitors all the applications within the environment. It's a passive system used for observation and actions are taken separately based on monitoring events.
The monitoring service subscribes to various events, aggregates and summarises.
Who monitors the monitoring service? The monitoring service
Getting started
Install Consul
Consul is the default registry/discovery for go-micro apps. It's however pluggable. https://www.consul.io/intro/getting-started/install.html
Run Consul
$ consul agent -server -bootstrap-expect 1 -data-dir /tmp/consulDownload and start the service
go get github.com/micro/monitor-srv monitor-srv
OR as a docker container
docker run microhq/monitor-srv --registry_address=YOUR_REGISTRY_ADDRESS
The API
Monitoring server implements the following RPC Methods
Monitor.HealthChecks
micro query go.micro.srv.monitor Monitor.HealthChecks '{"id": "go.micro.healthcheck.ping"}'
{
"healthChecks": [
{
"description": "This is a ping healthcheck that succeeds",
"id": "go.micro.healthcheck.ping",
"results": {
"foo": "bar",
"label": "cruft",
"metric": "1",
"msg": "a successful check",
"stats": "123.0"
},
"service": {
"id": "go-server-672d50a7-ab77-11e5-ad84-68a86d0d36b6",
"name": "go-server",
"version": "1.0.0"
},
"status": 1,
"timestamp": 1.451096504e+09
}
]
}
micro query go.micro.srv.monitor Monitor.HealthChecks '{"id": "go.micro.healthcheck.pong"}'
{
"healthChecks": [
{
"description": "This is a pong healthcheck that fails",
"error": "Unknown exception",
"id": "go.micro.healthcheck.pong",
"results": {
"foo": "ugh",
"label": "",
"metric": "-0.0001",
"msg": "a catastrophic failure occurred",
"stats": "NaN"
},
"service": {
"id": "go-server-672d50a7-ab77-11e5-ad84-68a86d0d36b6",
"name": "go-server",
"version": "1.0.0"
},
"status": 2,
"timestamp": 1.451096508e+09
}
]
}Sending HealthChecks
Healthchecks are sent using go-platform/monitor. Example usage can be found in go-platform/examples/monitor.