GrayLogger
Overview
GrayLogger is a small logging tool that allows you to simply log anything you want to graylog2 from within your Rack application.
Installation
-
Add GrayLogger to your Gemfile
# in Gemfile gem "gray_logger"
-
configure GrayLogger in config/gray_logger.yml
development: host: 127.0.0.1 port: 12201 facility: "myapp" automatic_logging: true # flushes all collected fields to graylog after request level: 1 # GELF::INFO
-
if you are using Rails 2.3 please add the following code to an initializer:
begin
gray_logger_config = YAML.load(File.read(Rails.root.join("config/gray_logger.yml")))[Rails.env]
host = ENV['YOUR_GRAYLOG_HOST'] || gray_logger_config["host"]
port = ENV['YOUR_GRAYLOG_PORT'] || gray_logger_config["port"]
size = ENV['YOUR_GRAYLOG_MAX_SIZE'] || "WAN"
::GrayLogger.configure(gray_logger_config)
::GrayLogger.proxy.initialize_gray_logger!
ActionController::Base.send(:include, ::GrayLogger::HelperMethods)
Rails.configuration.middleware.insert_after Rack::Lock, "Rack::GrayLogger::Middleware"
rescue => e
Rails.logger.warn("GrayLogger not configured.")
end
- To install the gray_logger proxy set the logger in your environment file:
require 'gray_logger'
::GrayLogger.proxy.proxied_logger = Logger.new(Rails.root.join("log", Rails.env + ".log"), 3, 50*1024*1024)
config.logger = ::GrayLogger.proxy
Usage
In Rails you can use the "gray_logger" method to add new fields to be logged to Graylog2.
Buckets
You can use buckets to collect fields and send them in one request to GrayLog2:
gray_logger.bucket(:financial_data).account_nr = 123
gray_logger.bucket(:financial_data).iban = 98767
gray_logger.flush_bucket(:financial_data) # sends the collected fields as one log message to GrayLog2 and clears the bucket
When the request is finished all remaining buckets are send to GrayLog2 so you don't have to care if you only want to collect your data.
After Request Log
There is a special bucket that is used for logging possible exceptions and request information. When you are using the Rack::GrayLogger::Proxy the proxy will use this bucket to collect the loglines from the proxied logger. Feel free to add your own fields using:
gray_logger.after_request_log.user_login = current_user.login
Automatic Logging
Automatic Logging is enabled by default. That means after the request is done GrayLogger will automatically log to GrayLog2. If you don't want this automatic logging disable it by setting automatic_logging to false.
development:
host: ...
port: ...
facility: ...
automatic_logging: false