Struct ResourceContext 

pub struct ResourceContext { /* private fields */ }

Thread-local resource context tracking active leases and operation counts.

Used by the #[grafos::instrument] proc macro to capture resource metadata on function entry/exit, and by grafos-std integration hooks to push/pop lease tracking automatically.

Examples

use grafos_observe::context::{ResourceContext, LeaseInfo};
use grafos_observe::ResourceType;

ResourceContext::with_mut(|ctx| {
    ctx.push_lease(LeaseInfo {
        resource_type: ResourceType::Mem,
        lease_id: 1,
        node_addr: "10.10.0.11".into(),
        bytes_held: 4096,
    });
});

ResourceContext::with(|ctx| {
    assert_eq!(ctx.lease_count(), 1);
    assert_eq!(ctx.total_bytes_held(), 4096);
    assert_eq!(ctx.nodes_involved(), 1);
});

ResourceContext::with_mut(|ctx| {
    ctx.pop_lease(1);
});

ResourceContext::with(|ctx| {
    assert_eq!(ctx.lease_count(), 0);
});

Implementations

impl ResourceContext

pub fn with<F, R>(f: F) -> R

where F: FnOnce(&ResourceContext) -> R,

Access the current thread-local resource context immutably.

pub fn with_mut<F, R>(f: F) -> R

where F: FnOnce(&mut ResourceContext) -> R,

Access the current thread-local resource context mutably.

pub fn current_snapshot() -> ContextSnapshot

Take a snapshot of the current thread-local resource context.

impl ResourceContext

pub fn push_lease(&mut self, info: LeaseInfo)

Push a new lease into the context (called on acquire).

pub fn pop_lease(&mut self, lease_id: u64)

Remove a lease from the context by lease_id (called on drop/free).

pub fn lease_count(&self) -> usize

Number of active leases in the current context.

pub fn total_bytes_held(&self) -> u64

Total bytes held across all active leases.

pub fn nodes_involved(&self) -> usize

Number of distinct nodes involved in active leases.

pub fn active_leases(&self) -> &[LeaseInfo]

Read-only access to active leases.

pub fn ops_mut(&mut self) -> &mut OpCounters

Mutable access to operation counters.

pub fn ops(&self) -> &OpCounters

Read-only access to operation counters.

pub fn snapshot(&self) -> ContextSnapshot

Take a snapshot of the current context state.

pub fn record_fbmu_write(&mut self)

Record an FBMU write operation.

pub fn record_fbmu_read(&mut self)

Record an FBMU read operation.

pub fn record_fbbu_write(&mut self)

Record an FBBU write operation.

pub fn record_fbbu_read(&mut self)

Record an FBBU read operation.

pub fn record_gpu_submit(&mut self)

Record a GPU submit operation.

pub fn record_tasklet_submit(&mut self)

Record a tasklet submit operation.