Trifle::Logger / Usage


Trifle::Logger comes with a couple module level methods that are shorthands for operations.


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 = 'my_trace', meta: {count: 1})

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


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


The easiest way to use tracer is to replace all your puts or 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 #{} 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}")'', params)


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 }


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)


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| do |line|
      puts line

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

Then using examples from above you can get combined out

{: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