Marcopolo
Marcopolo is a Rack middleware for use in Rails applications (currently) to aid in debugging HTTP requests and responses by logging them raw (including headers and body).
Installation
Add this line to your application's Gemfile:
gem 'marcopolo'
And then execute:
$ bundle
Usage
By simply including the gem in your Gemfile, your Rails app will automatically start logging raw incoming HTTP requests and your app's responses to your Rails log. That being said, you can choose a different log location if you wish.
Configure the logger settings in a Rails initializer like so:
Marcopolo.[:logger] = Logger.new(File.join(Rails.root, 'log', "#{Rails.env}-http-raw.log"))
Marcopolo.[:severity] = Logger::Severity::DEBUG
Consider adding logrotate rules to your application server to prevent these extremely verbose logs from blowing up your storage.
Also, be mindful of cleaning up these logs appropriately, as sensative information like authorization headers and cookies will not be filtered out automatically (hence "raw").
Filtering out noise
You may want to filter out noisy requests, such as health checks. Create a proc that takes a Rack::Request object and returns true
if the request is desirable and false
if the request should be excluded from the log.
Marcopolo.[:filter] = Proc.new do |request|
# exclude all options requests
request.request_method != 'OPTIONS'
end
TODO
- Support for Sinatra?
- Ability to disable for certain endpoints, etc
- IP-based log segmenting?
- Tests?
Contributing
- Fork it ( http://github.com/
/marcopolo/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 new Pull Request