Link Search Menu Expand Document

Usage

Trifle::Logger comes with tracer and trace module methods.

Tracer

To start tracking you must initialize Tracer first. There are two tracers included, Hash and Null. They store data in structure as their name says so. Duh.

Trifle::Logger.tracer = Trifle::Logger::Tracer::Hash.new(key: 'my_trace', meta: {count: 1})

Tracer is stored on Thread.current. Be aware when multithreading.

Trace

Once you initialize Tracer, manually or through middleware, you can start tracing your code.

Simple

The easiest way to use tracer is to replace all your puts or Rails.logger.info outputs with Trifle::Logger.trace method. This will do what you would expect, store the text with a timestamp.

Trifle::Logger.trace('This is sample log message')
Trifle::Logger.trace("This is interpolated time #{Time.now} message")

Sometimes you need to mark a line of a new section in your log. Use head: true attribute to mark the line.

Trifle::Logger.trace('Initializing connection', head: true)
params = { a: 1 }
Trifle::Logger.trace("Passing params: #{params}")
Rest::Client.post('https://example.com', params)
Trifle::Logger.trace('Done')

Block

You can see how the above example of using params looks, well, bad. For this you can use Trifle::Logger.trace with block and assing result of a block to a variable. Logger will automatically include result of a block in your logs. Result is evaluated through Object.inspect method.

params = Trifle::Logger.trace('Passing params') do
  { a: 1 }
end

Error

Other times you may wanna point out that something caused an error. Pass state: :error argument to trace method.

Trifle::Logger.trace('Connection failed', state: :error)

Example

Here is an example of manual tracing in your ruby code. Callback just prints the lines.

Trifle::Logger.configure do |config|
  config.on(:wrapup) do |tracer|
    tracer.data.each do |line|
      puts line
    end
  end
end

You can read more about persisting and callbacks in, well, Callbacks doc.

Then using examples from above you can get combined out

Trifle::Logger.tracer.wrapup
{:at=>1612686322, :message=>"Trifle::Trace has been initialized for sample", :state=>:success, :head=>false, :meta=>false}
{:at=>1612686343, :message=>"This is sample log message", :state=>:success, :head=>false, :meta=>false}
{:at=>1612686347, :message=>"This is interpolated time 2021-02-07 09:25:47 +0100 message", :state=>:success, :head=>false, :meta=>false}
{:at=>1612686351, :message=>"Initializing connection", :state=>:success, :head=>true, :meta=>false}
{:at=>1612686359, :message=>"Passing params", :state=>:success, :head=>false, :meta=>false}
{:at=>1612686359, :message=>"=> {:a=>1}", :state=>:success, :head=>false, :meta=>true}
{:at=>1612686363, :message=>"Done", :state=>:success, :head=>false, :meta=>false}
{:at=>1612686441, :message=>"Connection failed", :state=>:error, :head=>false, :meta=>false}
=> nil