class Sepia::MemoryLimiter

• Sepia::MemoryLimiter
• Reference
• Object

Overview

Memory pressure detection and management system.

Monitors system memory usage and provides signals for when caches should be purged or memory-saving measures should be taken. Works across different platforms (Linux, macOS, Windows).

Example

limiter = MemoryLimiter.new(
  warning_threshold: "70%",
  critical_threshold: "85%",
  check_interval: 30.seconds
)

limiter.on_warning { puts "Memory usage is high" }
limiter.on_critical { cache.clear }

limiter.start_monitoring

Defined in:

Constructors

• .new(warning_threshold : Float64 = 0.7, critical_threshold : Float64 = 0.85, emergency_threshold : Float64 = 0.95, check_interval : Time::Span = 30.seconds)

  Creates a new memory limiter.

Instance Method Summary

• #check_interval : Time::Span

  Monitoring interval

• #check_now : PressureLevel

  Forces an immediate memory check.

• #critical? : Bool

  Checks if memory pressure is at critical level or higher.

• #critical_threshold : Float64
• #current_pressure : PressureLevel

  Gets the current memory pressure level.

• #current_stats : MemoryStats

  Current memory statistics

• #emergency? : Bool

  Checks if memory pressure is at emergency level.

• #emergency_threshold : Float64
• #monitoring : Bool

  Monitoring state

• #on_critical : Proc(Nil) | Nil
• #on_critical=(on_critical : Proc(Nil) | Nil)
• #on_emergency : Proc(Nil) | Nil
• #on_emergency=(on_emergency : Proc(Nil) | Nil)
• #on_normal : Proc(Nil) | Nil
• #on_normal=(on_normal : Proc(Nil) | Nil)
• #on_warning : Proc(Nil) | Nil

  Event callbacks

• #on_warning=(on_warning : Proc(Nil) | Nil)

  Event callbacks

• #start_monitoring : Void

  Starts monitoring memory usage in the background.

• #status_description : String

  Gets a human-readable description of current memory state.

• #stop_monitoring : Void

  Stops monitoring memory usage.

• #suggest_cache_size(max_size : Int32) : Int32

  Suggests cache size based on current memory pressure.

• #warning? : Bool

  Checks if memory pressure is at warning level or higher.

• #warning_threshold : Float64

  Memory usage thresholds

Constructor Detail

limiter = MemoryLimiter.new(
  warning_threshold: 0.75,
  critical_threshold: 0.90,
  check_interval: 60.seconds
)

Instance Method Detail

pressure = limiter.check_now
puts "Current pressure: #{pressure}"

if limiter.critical?
  cache.clear
  GC.collect
end

pressure = limiter.current_pressure
case pressure
when .warning?
  puts "Memory usage is high"
when .critical?
  puts "Memory usage is critical"
end

if limiter.emergency?
  raise "Out of memory!"
end

limiter.start_monitoring

puts limiter.status_description
# => "Memory usage: 2.3 GB of 8.0 GB (28.8%) - Normal"

limiter.stop_monitoring

recommended = limiter.suggest_cache_size(1000)
cache.resize(recommended)

if limiter.warning?
  cache.cleanup
end