class Rack::CommonLogger
Rack::CommonLogger forwards every request
to the given app
, and logs a line in the Apache common log
format to the logger
.
If logger
is nil, CommonLogger
will fall back rack.errors
, which is an instance of Rack::NullLogger.
logger
can be any class, including the standard library Logger, and is expected to have either
write
or +<<+ method, which accepts the
CommonLogger::FORMAT. According to the SPEC, the error stream must also
respond to puts
(which takes a single argument that responds
to to_s
), and flush
(which is called without
arguments in order to make the error appear for sure)
Constants
- FORMAT
Common Log Format: httpd.apache.org/docs/1.3/logs.html#common
lilith.local - - [07/Aug/2006 23:58:02 -0400] "GET / HTTP/1.1" 500 - %{%s - %s [%s] "%s %s%s %s" %d %s\n} %
Public Class Methods
new(app, logger=nil)
click to toggle source
# File lib/rack/common_logger.rb, line 26 def initialize(app, logger=nil) @app = app @logger = logger end
Public Instance Methods
call(env)
click to toggle source
# File lib/rack/common_logger.rb, line 31 def call(env) began_at = Time.now status, header, body = @app.call(env) header = Utils::HeaderHash.new(header) body = BodyProxy.new(body) { log(env, status, header, began_at) } [status, header, body] end
Private Instance Methods
extract_content_length(headers)
click to toggle source
# File lib/rack/common_logger.rb, line 67 def extract_content_length(headers) value = headers[CONTENT_LENGTH] or return '-' value.to_s == '0' ? '-' : value end
log(env, status, header, began_at)
click to toggle source
# File lib/rack/common_logger.rb, line 41 def log(env, status, header, began_at) now = Time.now length = extract_content_length(header) msg = FORMAT % [ env['HTTP_X_FORWARDED_FOR'] || env["REMOTE_ADDR"] || "-", env["REMOTE_USER"] || "-", now.strftime("%d/%b/%Y:%H:%M:%S %z"), env[REQUEST_METHOD], env[PATH_INFO], env[QUERY_STRING].empty? ? "" : "?#{env[QUERY_STRING]}", env[HTTP_VERSION], status.to_s[0..3], length, now - began_at ] logger = @logger || env[RACK_ERRORS] # Standard library logger doesn't support write but it supports << which actually # calls to write on the log device without formatting if logger.respond_to?(:write) logger.write(msg) else logger << msg end end