Crate heapster 

Lightweight heap telemetry for Rust, built on relaxed atomics.

heapster is a lightweight, generic wrapper over any GlobalAlloc that tracks allocations, deallocations, and reallocations using pure relaxed atomics. it is designed to be always-on, allowing you to identify allocation patterns, diff heap usage between code paths, and export raw allocator metrics to your telemetry dashboards with minimal overhead.

why heapster?

Heap profilers like dhat or heaptrack capture rich per-allocation data but add significant overhead and require dedicated viewers. Heapster occupies a lighter tier: aggregate counters and histograms only, with overhead low enough to leave on in production.

• atomics-only: no mutexes, no thread-locals, no external viewer files. just relaxed atomic counters.
• no_std by default: uses only core and alloc in the default build, with no third-party dependencies. The fmt and serde features add std requirements.
• generic over any allocator: wraps System, jemalloc, mimalloc, or any custom GlobalAlloc.
• size histograms: power-of-two buckets for allocations and reallocations make the size distribution visible at a glance.
• realloc classification: distinguishes between reallocations that grew in-place, shrank in-place, or forced a full memory copy.
• snapshot diffing: measure() returns a Stats delta for a closure, suitable for assertion-style tests and benchmark comparisons.

quickstart

wrap your global allocator of choice (e.g., System) in your main.rs or lib.rs:

use heapster::Heapster;
use std::alloc::System;

#[global_allocator]
static GLOBAL: Heapster<System> = Heapster::new(System);

fn main() {
    // ... do some heavy work ...

    // see what has transpired in the heap
    let stats = GLOBAL.stats();
    println!("allocated: {} bytes", stats.alloc_sum);
}

measuring specific operations

heapster lets you diff the heap stats of critical sections of code using snapshot math:

let (result, heap_diff) = GLOBAL.measure(|| {
    // ... operation to measure ...
    42
});

assert!(heap_diff.alloc_count < 10, "regression: the operation allocated too many times!");

Structs

Heapster

A global allocator enhanced with stats.

Histogram

A histogram with power-of-two buckets containing the numbers of entries of different sizes, starting with 2^0 and ending with the [2^63, 2^64) bucket.

Stats

A summary of an allocator’s stats.