Struct Tracker 

pub struct Tracker { /* private fields */ }

Implementations

impl Tracker

pub fn track_deallocation(&self, ptr: usize) -> TrackingResult<bool>

pub fn track_deallocation_of( &self, ptr: usize, serial: u64, ) -> TrackingResult<bool>

Release one specific binding and publish the matching event.

Exact entry point: the caller names the identity, so no policy guess is involved and the published event carries that identity. Returns false when the binding is already gone (a late release of a superseded generation).

pub fn track_reallocation( &self, old_ptr: usize, new_ptr: usize, old_size: usize, new_size: usize, )

Track a reallocation of a tracked block.

The block keeps its identity (and its binding serial): the new size replaces the old one and the allocation counter does not change, whether the allocator kept the address or moved the block. The dedupe state moves with the binding, so a later release still closes the identity it belongs to.

impl Tracker

pub fn new() -> Self

pub fn with_config(config: TrackerConfig) -> Self

Construct a Tracker from a global_tracking::TrackerConfig.

This is the bridge between the user-facing GlobalTrackerConfig.tracker field and the internal Tracker construction. Currently the underlying MemoryTracker does not honor max_allocations (it is unbounded by design), so this method consumes the config without applying that knob. enable_statistics is implicitly always true — the tracker always collects statistics; future implementations may gate this.

The method exists so that GlobalTracker::with_config does not silently discard its config.tracker field.

pub fn global() -> Self

pub fn with_system_monitoring(self) -> Self

pub fn with_sampling(self, config: SamplingConfig) -> Self

pub fn with_auto_export(self, path: &str) -> Self

pub fn track_as<T: Trackable>( &self, var: &T, name: &str, file: &str, line: u32, module_path: &str, )

pub fn track_clone( &self, source_ptr: usize, target_ptr: usize, size: usize, var_name: Option<String>, type_name: Option<String>, file: &str, line: u32, module_path: &str, )

Track a clone operation

pub fn duplicate_observations(&self) -> u64

Number of duplicate observations of an already tracked address.

These sightings are not counted as allocations or bytes; the value exists so reports can show that the capture layer saw the same block twice.

pub fn degraded_releases(&self) -> u64

Releases that could only be matched by address.

Non-zero means a release arrived for an address that still held several live bindings, so the closed binding was the oldest one rather than a named identity.

pub fn events(&self) -> Vec<MemoryEvent>

pub fn event_store(&self) -> &Arc<EventStore>

pub fn stats(&self) -> MemoryStats

pub fn analyze(&self) -> AnalysisReport

pub fn inner(&self) -> &Arc<MemoryTracker>

pub fn elapsed(&self) -> Duration

pub fn system_snapshots(&self) -> Vec<SystemSnapshot>

pub fn current_system_snapshot(&self) -> SystemSnapshot

Trait Implementations

impl Clone for Tracker

fn clone(&self) -> Self

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Default for Tracker

fn default() -> Self

Returns the “default value” for a type.

impl Drop for Tracker

fn drop(&mut self)

Executes the destructor for this type.

fn pin_drop(self: Pin<&mut Self>)

🔬This is a nightly-only experimental API. (pin_ergonomics)

Execute the destructor for this type, but different to Drop::drop, it requires self to be pinned.