Documentation on Memory Usage / out-of-memory behavior
jleibs opened this issue · 3 comments
There's enough nuance here to potentially make for a good how-to guide?
- Identifying that rerun is using too much memory
- The UIs involved in inspecting/debugging
- The flags involved in configuring the behavior
- Some best practices for reducing overhead
I agree we should improve the documentation here. Currently we have this in rerun_py/USAGE.md
:
You can set
--memory-limit=16GB
to tell the Rerun Viewer to purge older log data when memory use goes above that limit. This is useful for using Rerun in continuous mode, i.e. where you keep logging new data to Rerun forever.It is still possible to log data faster than the Rerun Viewer can process it, and in those cases you may still run out of memory unless you also set
--drop-at-latency=200ms
or similar.
We should also make sure that both --memory-limit
and --drop-at-latency
can be set from the Python SDK and with environment variables:
This is now documented in https://www.rerun.io/docs/howto/limit-ram