Class: Boxcars::MultiBackend

Inherits:
Object
  • Object
show all
Includes:
ObservabilityBackend
Defined in:
lib/boxcars/observability_backends/multi_backend.rb

Overview

An observability backend that delegates tracking calls to multiple other backends. This allows sending observability data to several destinations simultaneously.

Instance Method Summary collapse

Constructor Details

#initialize(backends) ⇒ MultiBackend

Initializes a new MultiBackend.

Parameters:

Raises:



16
17
18
19
20
21
 
# File 'lib/boxcars/observability_backends/multi_backend.rb', line 16

def initialize(backends)
  @backends = Array(backends).compact # Ensure it's an array and remove nils
  return if @backends.all? { |b| b.respond_to?(:track) }

  raise ArgumentError, "All backends must implement the `track` method (i.e., include Boxcars::ObservabilityBackend)."
end

Instance Method Details

#track(event:, properties:) ⇒ Object

Tracks an event by calling track on each configured backend. It passes a duplicated properties hash to each backend to prevent unintended modifications if one backend alters the hash. Errors from individual backends are silently ignored to ensure other backends still receive the event.

Parameters:

  • event (String, Symbol) —

    The name of the event to track.

  • properties (Hash) —

    A hash of properties associated with the event.



31
32
33
34
35
36
37
38
39
40
 
# File 'lib/boxcars/observability_backends/multi_backend.rb', line 31

def track(event:, properties:)
  @backends.each do |backend_instance|
    # Pass a duplicated properties hash to prevent mutation issues across backends
    backend_instance.track(event:, properties: properties.dup)
  rescue StandardError
    # Silently ignore errors from individual backends.
    # Optionally, log:
    # Boxcars.logger.warn "Boxcars::MultiBackend: Error in backend #{backend_instance.class.name}: #{e.message}"
  end
end