A read-only debugging snapshot of the entire pool region, one level deeper
than mizu_pool_info(). It shows per-slot registry detail and every occupied
result slot. State is distributed across processes and execution is
non-deterministic, so start here when a pool hangs. The scan takes no locks
and can race with in-flight transitions: each field is a single consistent
read, but the rows need not be consistent with each other.
Arguments
- pool
a pool handle from
mizu_pool()ormizu_pool_attach(); inside a task, the evaluating worker's own handle frommizu_current_pool().
Value
A list with elements token and name (as in
mizu_pool_info()), shutdown, workers (data frame:
slot, status, pid, park_state, parked, deque top and bottom, and
the in-flight result slot), submitters (data frame: slot, status,
pid, result-slot subrange, queued injection entries, ready and
full-waiter mask bits), tasks (data frame of occupied result slots:
slot, status, sequence, executing worker, parked waiter), help, and
local. help is the help-wanted doorbell: TRUE while injection
entries are queued with every worker busy, awaiting pickup by a map
runner at its next batch transition or a worker helping out of a
nested mizu_collect() (the rehome event of mizu_pool_trace()).
local is the process-private state of this handle: the
occupancy of the producer free list (fl_entries, fl_bytes), its
reuse count (fl_hits), the open_hits and open_misses of the
consumer mapping cache, collect_parks (how often a collect on
this handle parked waiting for a result), and ledger_entries
(lent-out regions still pinned by consumer views).
Examples
p <- mizu_pool()
t <- mizu_submit(p, runif(1))
mizu_pool_dump(p)
#> $name
#> [1] "/mizu_1a2c_e47715f2"
#>
#> $shutdown
#> [1] FALSE
#>
#> $workers
#> slot status pid park_state parked top bottom in_flight
#> 1 0 live 8088 parked TRUE 0 0 -1
#>
#> $submitters
#> slot status pid rs_start rs_count queued ready full_waiter
#> 1 0 live 6700 0 512 0 FALSE FALSE
#> 2 1 free 0 0 0 0 FALSE FALSE
#> 3 2 free 0 0 0 0 FALSE FALSE
#> 4 3 free 0 0 0 0 FALSE FALSE
#> 5 4 free 0 0 0 0 FALSE FALSE
#> 6 5 free 0 0 0 0 FALSE FALSE
#> 7 6 free 0 0 0 0 FALSE FALSE
#> 8 7 free 0 0 0 0 FALSE FALSE
#>
#> $tasks
#> slot status sequence worker waiter
#> 1 0 ok 1 0 -1
#>
#> $local
#> $local$fl_entries
#> [1] 0
#>
#> $local$fl_bytes
#> [1] 0
#>
#> $local$fl_hits
#> [1] 0
#>
#> $local$open_hits
#> [1] 0
#>
#> $local$open_misses
#> [1] 0
#>
#> $local$collect_parks
#> [1] 0
#>
#> $local$ledger_entries
#> [1] 0
#>
#> $local$notify_sends
#> [1] 0
#>
#>
#> $help
#> [1] FALSE
#>
#> $language
#> [1] "R"
#>
#> $capabilities
#> [1] 479
#>
#> $token
#> [1] "1a2c_e47715f2"
#>
mizu_collect(t)
#> [1] 0.4226299
mizu_pool_stop(p)