Is a middleware that verifies if your app and all resources that it needs are available.
Add this line to your application's Gemfile:
gem 'rack-healthcheck'
And then execute:
$ bundle
Or install it yourself as:
$ gem install rack-healthcheck
# config/application.rb
config.middleware.use Rack::Healthcheck::Middleware
This may, depending on setup need a position specified. If you see Rack errors in your tests, or elsewhere, try this.
# config/application.rb
config.middleware.insert_before 0, Rack::Healthcheck::Middleware
If it still doesn't work, some users are positionally specifying that the middleware come before another by class name.
# config/application.rb
config.middleware.insert_before ActiveRecord::Migration::CheckPending, Rack::Healthcheck::Middleware
This name may change depending on the framework & version you use this with, and may not be available which is why absolute position is provided above.
# config.ru
use Rack::Healthcheck::Middleware
Create an initializer file, where you'll setup all services that you use.
Rack::Healthcheck.configure do |config|
config.app_name = "Your Application"
config.app_version = 1.0
config.checks = [
Rack::Healthcheck::Checks::ActiveRecord.new("Database"),
Rack::Healthcheck::Checks::RabbitMQ.new(name, config = {
hosts: [localhost],
port: 5672,
user: guest,
pass: guest
}),
Rack::Healthcheck::Checks::Redis.new(name, config = {
url: "redis://localhost:6379",
password: "pass"
})
Rack::Healthcheck::Checks::HTTPRequest.new(name, config = {
url: localhost,
headers: {"Host" => "something"},
service_type: "INTERNAL_SERVICE",
expected_result: "LIVE"
})
]
end
- Rack::Healthcheck::Checks::ActiveRecord.new(name, config = {})
- Rack::Healthcheck::Checks::MongoDB.new(name, config = {})
- Rack::Healthcheck::Checks::RabbitMQ.new(name, config = {})
- Rack::Healthcheck::Checks::Redis.new(name, config = {})
- Rack::Healthcheck::Checks::HTTPRequest.new(name, config = {})
You can inform if one of your checks is optional, so this check will be disregarded in final result.
To do that you just need to pass a hash with :optional
key.
Rack::Healthcheck::Checks::ActiveRecord.new("Test", {optional: true})
If you want to display the service url in final result, you need to pass it in hash config too.
Rack::Healthcheck::Checks::ActiveRecord.new("Test", {optional: true, url: "http://myservice.com/healthcheck"})
By default this gem creates two routes /healthcheck
and /healthcheck/complete
.
The /healthcheck
route doesn't verify the services used by application. This is the fastest way to tell to load balancer if it should or not keep the machine in the pool.
These are the available HTTP methods for this route:
- GET -> Returns the current status (LIVE|DEAD)
- POST -> Changes the current status to LIVE
- DELETE -> Changes the current status to DEAD
The /healthcheck/complete
performs all configured checks and returns a JSON with a lot of information (elapsed time, status for each service, global status considering only required services).
Example:
{
"name": "My application",
"status": true,
"version": 1.0,
"checks": [
{
"name": "Oracle database",
"type": "DATABASE",
"status": true,
"optional": false,
"time": 0.036443
}
]
}
If you want to change the default route, you just need to pass the new route to the middleware
# For rails
# config/application.rb
config.middleware.use Rack::Healthcheck::Middleware, "/myroute"
# or
# For sinatra
# config.ru
use Rack::Healthcheck::Middleware, "/myroute"
- Fork it ( https://github.com/downgba/rack-healthcheck/fork )
- Create your feature branch (
git checkout -b my-new-feature
) - Commit your changes (
git commit -am 'Add some feature'
) - Push to the branch (
git push origin my-new-feature
) - Create a new Pull Request
The gem is available as open source under the terms of the MIT License.