Rack Fluentd Logger

Install

Gemfile:

gem 'rack-fluentd-logger'

Shell:

gem install rack-fluentd-logger

Usage

config.ru

require 'rack-fluentd-logger'

Rack::FluentdLogger.configure(
  name: 'your-app-log-name',
  host: 'your-fluentd-host',
  port: 24224
)

use Rack::FluentdLogger

run YourApplication

Configuration Options

name	default	description
name	ENV['FLUENTD_NAME']	application name to use for fluentd logs
host	ENV['FLUENTD_HOST']	fluentd server hostname/ip
port	ENV['FLUENTD_PORT'] || 24_224	fluentd server port
json_parser	->(str) { JSON.parse(str) }	used to parse response bodies if they are application/json
preprocessor	->(s) { s }	callback for any additional processing/scrubbing of data before sending it off

Event Data

Events sent to fluentd have the following structure

{
  env: {
    # everything from the rack env that's an array/hash/string/number
  },
  timestamp: Time.now, # current time when the log event is recorded
  response_time: 0.012, # length of time in seconds for response from rack
  code: 200, # http response code from rack app
  body: [], # body from rack app (when the content_type is json, it's parsed)
  headers: {} # http headers from the rack app
}