Class: LLM::Tracer::Null

Inherits:

Tracer

• Object
• Tracer
• LLM::Tracer::Null

Defined in:

lib/llm/tracer/null.rb

Overview

A no-op tracer that ignores all tracing callbacks.

Direct Known Subclasses

Eval::Tracer::Console, Eval::Tracer::JSON

Instance Method Summary

• #set_finish_metadata_proc(_proc = nil) ⇒ self
• #on_request_finish ⇒ nil
• #on_request_error ⇒ nil
• #on_tool_start ⇒ nil
• #on_tool_interrupt ⇒ nil
• #on_tool_finish ⇒ nil
• #on_tool_error ⇒ nil
• #on_interrupt ⇒ nil
• #on_exit ⇒ nil
• #on_request_start ⇒ nil

Instance Method Details

#set_finish_metadata_proc(_proc = nil) ⇒ self

Parameters:

• proc (Proc, nil) —

  (res) -> Hash or nil

Returns:

• (self)

# File 'lib/llm/tracer/null.rb', line 72

def set_finish_metadata_proc(_proc = nil)
  Thread.current[LLM::Tracer::FINISH_METADATA_PROC_KEY] = nil
  self
end

#on_request_finish ⇒ nil

Parameters:

• operation (String)
• res (LLM::Response)
• span (Object, nil)
• model (String)
• outputs (Hash, nil) —

  Optional span attributes (e.g. gen_ai.output.messages) from llm.rb or caller.

• metadata (Hash, nil) —

  Optional metadata from llm.rb or caller.

• request_id (String) —

  The id of the request that can be matched back to #on_request_start

Returns:

• (nil)

# File 'lib/llm/tracer/null.rb', line 17

def on_request_finish(**)
  nil
end

#on_request_error ⇒ nil

Parameters:

• ex (LLM::Error)
• span (Object, nil)
• request_id (String) —

  The id of the request, as passed to #on_request_start

Returns:

• (nil)

# File 'lib/llm/tracer/null.rb', line 24

def on_request_error(**)
  nil
end

#on_tool_start ⇒ nil

Parameters:

• id (String) —

  The tool call ID assigned by the model/provider

• name (String) —

  The tool (function) name.

• arguments (Hash) —

  The parsed tool arguments.

• model (String) —

  The model name

Returns:

• (nil)

# File 'lib/llm/tracer/null.rb', line 31

def on_tool_start(**)
  nil
end

#on_tool_interrupt ⇒ nil

Parameters:

• ex (LLM::Interrupt) —

  An instance of LLM::Interrupt

• span (Object, nil) —

  The span/context object returned by #on_tool_start

• started_at (Float) —

  When the call opened

• finished_at (Float) —

  When the call ended

Returns:

• (nil)

# File 'lib/llm/tracer/null.rb', line 38

def on_tool_interrupt(**)
  nil
end

#on_tool_finish ⇒ nil

Parameters:

• result (LLM::Function::Return) —

  An Function::Return

• span (Object) —

  The span/context object returned by #on_tool_start

• started_at (Float) —

  When the call opened

• finished_at (Float) —

  When the call ended

Returns:

• (nil)

# File 'lib/llm/tracer/null.rb', line 45

def on_tool_finish(**)
  nil
end

#on_tool_error ⇒ nil

Parameters:

• ex (LLM::Function::Return) —

  An Function::Return that holds the error

• span (Object, nil) —

  The span/context object returned by #on_tool_start.

• started_at (Float) —

  When the call opened

• finished_at (Float) —

  When the call ended

Returns:

• (nil)

# File 'lib/llm/tracer/null.rb', line 52

def on_tool_error(**)
  nil
end

#on_interrupt ⇒ nil

Parameters:

• scope (Symbol) —

  :request, :agent, or :tool

• span (Object, nil) —

  The span that #on_request_start returned

• request_id (String, nil) —

  The id, as passed to #on_request_start

Returns:

• (nil)

# File 'lib/llm/tracer/null.rb', line 59

def on_interrupt(**)
  nil
end

#on_exit ⇒ nil

Returns:

• (nil)

# File 'lib/llm/tracer/null.rb', line 65

def on_exit
  nil
end

#on_request_start ⇒ nil

Parameters:

• operation (String)
• model (String)
• inputs (Hash, nil) —

  Optional span attributes (e.g. gen_ai.input.messages) from llm.rb or caller.

• request_id (String) —

  The id of the request. It is a UUIDv7, and it is shared by #on_request_start, #on_request_finish, and #on_request_error for the same request.

Returns:

• (nil)

# File 'lib/llm/tracer/null.rb', line 10

def on_request_start(**)
  nil
end