---

Class Relations

• class: ::nx::EnsembleObject

::nx::EnsembleObject create ::ns::stats::Sampler::slot::__storage

Methods (to be applied on the object)

• stalls (scripted)

  # Return retained observations, oldest first, without collecting or SQL.
  # Queue context is an endpoint gauge; it does not prove causation.
  if {$limit<1 || $limit>10000} {error "storage stalls limit must be 1..10000"}
  if {$server ne "" && $server ni [ns_info servers]} {error "unknown server: $server"}
  set limits [:storageLimits]
  set cutoff [expr {[clock microseconds]-[dict get $limits retentionSeconds]*1000000}]
  set records {}
  if {[nsv_exists ns_stats storageStalls]} {
      foreach record [nsv_get ns_stats storageStalls] {
          if {[dict get $record timestamp]<$cutoff} {continue}
          if {$server ne ""} {
              set selected {}
              if {[dict exists $record requestQueues $server]} {
                  dict set selected $server [dict get $record requestQueues $server]
              }
              dict set record requestQueues $selected
          }
          lappend records $record
      }
  }
  set omitted [expr {max(0,[llength $records]-$limit)}]
  return [dict create records [lrange $records $omitted end]  omittedRecords $omitted retentionSeconds [dict get $limits retentionSeconds]  maxRecords [dict get $limits maxRecords] source background-sampler]

---