1 unstable release
0.4.0 |
|
---|---|
0.3.1 |
|
0.3.0 |
|
0.2.9 |
|
#31 in #added
92 downloads per month
Used in 2 crates
17KB
306 lines
Track Rust memory usage by adding a 32 bytes header to all allocations. See https://doc.rust-lang.org/std/alloc/trait.GlobalAlloc.html
Usage
You can use code below to enable usage of this library:
use near_rust_allocator_proxy::allocator::MyAllocator;
#[global_allocator]
static ALLOC: MyAllocator = MyAllocator;
Design
- header - For each memory allocation we add a 32 bytes header. This allows figuring out how memory was allocated by looking at memory dump of the process.
- per thread memory usage stats -
thread_memory_usage(tid)
method can be used to get amount of memory allocated by thread PRINT_STACK_TRACE_ON_MEMORY_SPIKE
- if set to true a stack trace will be used on memory spike
Constants
ENABLE_STACK_TRACE
- if enabledbacktrace
will get executed on each allocation and stack pointer will be added to the headerMIN_BLOCK_SIZE
- if allocation size of belowMIN_BLOCK_SIZE
, we will only runbacktrace
SMALL_BLOCK_TRACE_PROBABILITY
percentage of timeSMALL_BLOCK_TRACE_PROBABILITY
- probability of running a stack trace for small allocationsREPORT_USAGE_INTERVAL
- if printing memory spikes is enabled print if memory usage exceeded this value in bytesPRINT_STACK_TRACE_ON_MEMORY_SPIKE
- if true print stack trace when memory usage exceedsREPORT_USAGE_INTERVAL
on given Rust thread
Header representation
Allocation structure:
- magic - unique 8 bytes identifier, which is used to mark memory allocations
- size - size in bytes
- tid - thread id
- stack - stack trace during time of allocation
#[repr(C)]
struct AllocHeader {
magic: u64,
size: u64,
tid: u64,
stack: [*mut c_void; STACK_SIZE],
}
TODO
- Add methods to set the configuration instead of having to change the constants.
- Add tests
Dependencies
~8–14MB
~219K SLoC