Class: Langfuse::Types::TraceAttributes

Inherits:
Object
  • Object
show all
Defined in:
lib/langfuse/types.rb

Overview

Attributes for Langfuse traces

Traces are the top-level containers that group related observations together. They represent a complete workflow, request, or user interaction.

Examples:

attrs = TraceAttributes.new(
  name: "user-request",
  user_id: "user-123",
  session_id: "session-456",
  input: { query: "What is Ruby?" },
  output: { answer: "Ruby is a programming language" },
  tags: ["api", "v1"],
  public: false
)

Instance Attribute Summary collapse

Instance Method Summary collapse

Constructor Details

#initialize(name: nil, user_id: nil, session_id: nil, version: nil, release: nil, input: nil, output: nil, metadata: nil, tags: nil, public: nil, environment: nil) ⇒ TraceAttributes

Initialize a new TraceAttributes instance

rubocop:disable Metrics/ParameterLists

Parameters:

  • name (String, nil) (defaults to: nil) —

    Human-readable name for the trace

  • user_id (String, nil) (defaults to: nil) —

    User identifier

  • session_id (String, nil) (defaults to: nil) —

    Session identifier

  • version (String, nil) (defaults to: nil) —

    Version identifier

  • release (String, nil) (defaults to: nil) —

    Release identifier

  • input (Object, nil) (defaults to: nil) —

    Input data

  • output (Object, nil) (defaults to: nil) —

    Output data

  • metadata (Hash, nil) (defaults to: nil) —

    Additional metadata

  • tags (Array<String>, nil) (defaults to: nil) —

    Tags array (each tag must be ≤200 characters; oversized tags are dropped)

  • public (Boolean, nil) (defaults to: nil) —

    Public visibility flag

  • environment (String, nil) (defaults to: nil) —

    Environment identifier



308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
 
# File 'lib/langfuse/types.rb', line 308

def initialize(name: nil, user_id: nil, session_id: nil, version: nil, release: nil, input: nil, output: nil,
               metadata: nil, tags: nil, public: nil, environment: nil)
  # rubocop:enable Metrics/ParameterLists
  @name = name
  @user_id = user_id
  @session_id = session_id
  @version = version
  @release = release
  @input = input
  @output = output
  @metadata = metadata
  @tags = tags
  @public = public
  @environment = environment
end

Instance Attribute Details

#environment ⇒ String?

Returns Environment where the trace was captured.

Returns:

  • (String, nil) —

    Environment where the trace was captured



292
293
294
 
# File 'lib/langfuse/types.rb', line 292

def environment
  @environment
end

#input ⇒ Object?

Returns Input data that initiated the trace.

Returns:

  • (Object, nil) —

    Input data that initiated the trace



277
278
279
 
# File 'lib/langfuse/types.rb', line 277

def input
  @input
end

#metadata ⇒ Hash?

Returns Additional metadata for the trace.

Returns:

  • (Hash, nil) —

    Additional metadata for the trace



283
284
285
 
# File 'lib/langfuse/types.rb', line 283

def metadata
  @metadata
end

#name ⇒ String?

Returns Human-readable name for the trace.

Returns:

  • (String, nil) —

    Human-readable name for the trace



262
263
264
 
# File 'lib/langfuse/types.rb', line 262

def name
  @name
end

#output ⇒ Object?

Returns Final output data from the trace.

Returns:

  • (Object, nil) —

    Final output data from the trace



280
281
282
 
# File 'lib/langfuse/types.rb', line 280

def output
  @output
end

#public ⇒ Boolean?

Returns Whether this trace should be publicly visible.

Returns:

  • (Boolean, nil) —

    Whether this trace should be publicly visible



289
290
291
 
# File 'lib/langfuse/types.rb', line 289

def public
  @public
end

#release ⇒ String?

Returns Release identifier for deployment tracking.

Returns:

  • (String, nil) —

    Release identifier for deployment tracking



274
275
276
 
# File 'lib/langfuse/types.rb', line 274

def release
  @release
end

#session_id ⇒ String?

Returns Session identifier for grouping related traces.

Returns:

  • (String, nil) —

    Session identifier for grouping related traces



268
269
270
 
# File 'lib/langfuse/types.rb', line 268

def session_id
  @session_id
end

#tags ⇒ Array<String>?

Returns Tags for categorizing and filtering traces.

Returns:

  • (Array<String>, nil) —

    Tags for categorizing and filtering traces



286
287
288
 
# File 'lib/langfuse/types.rb', line 286

def tags
  @tags
end

#user_id ⇒ String?

Returns Identifier for the user associated with this trace.

Returns:

  • (String, nil) —

    Identifier for the user associated with this trace



265
266
267
 
# File 'lib/langfuse/types.rb', line 265

def user_id
  @user_id
end

#version ⇒ String?

Returns Version identifier for the code/application.

Returns:

  • (String, nil) —

    Version identifier for the code/application



271
272
273
 
# File 'lib/langfuse/types.rb', line 271

def version
  @version
end

Instance Method Details

#to_h ⇒ Hash

Convert attributes to a hash representation

Returns a hash with all non-nil attributes. Nil values are excluded.

Returns:

  • (Hash) —

    Hash representation of attributes



329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
 
# File 'lib/langfuse/types.rb', line 329

def to_h
  {
    name: @name,
    user_id: @user_id,
    session_id: @session_id,
    version: @version,
    release: @release,
    input: @input,
    output: @output,
    metadata: @metadata,
    tags: @tags,
    public: @public,
    environment: @environment
  }.compact
end