Class: Puma::CommonLogger

Inherits:
Object
  • Object
show all
Defined in:
lib/puma/commonlogger.rb

Overview

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)

Constant Summary collapse

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} %
%{%s - %s [%s] "%s %s%s %s" %d %s %0.4f\n}
HIJACK_FORMAT =
%{%s - %s [%s] "%s %s%s %s" HIJACKED -1 %0.4f\n}
CONTENT_LENGTH =
'Content-Length'.freeze
PATH_INFO =
'PATH_INFO'.freeze
QUERY_STRING =
'QUERY_STRING'.freeze
REQUEST_METHOD =
'REQUEST_METHOD'.freeze

Instance Method Summary collapse

Constructor Details

#initialize(app, logger = nil) ⇒ CommonLogger

Returns a new instance of CommonLogger.


33
34
35
36
# File 'lib/puma/commonlogger.rb', line 33

def initialize(app, logger=nil)
  @app = app
  @logger = logger
end

Instance Method Details

#call(env) ⇒ Object


38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
# File 'lib/puma/commonlogger.rb', line 38

def call(env)
  began_at = Time.now
  status, header, body = @app.call(env)
  header = Util::HeaderHash.new(header)

  # If we've been hijacked, then output a special line
  if env['rack.hijack_io']
    log_hijacking(env, 'HIJACK', header, began_at)
  else
    ary = env['rack.after_reply']
    ary << lambda { log(env, status, header, began_at) }
  end

  [status, header, body]
end