I help teams fix systemic engineering issues: processes, architecture, and clarity.
→ See how I work with teams.
Memory Requirements for Flume Sources and Sinks
The dominant memory cost for each event comes from its body plus a small overhead for headers (typically around 100 bytes, depending on the transaction agent). To estimate memory for a batch:
- Take the average or p90 event size.
- Add a buffer for headers and variability.
- Multiply by the maximum batch size.
This result approximates the memory required to hold a batch in a Source or Sink.
A Sink needs memory for one batch at a time. A Source needs memory for one batch multiplied by the number of concurrently connected clients. For high-throughput ingestion this multiplier can be substantial, so size your heap accordingly.
Memory Requirements for the File Channel
Under normal operation, each File Channel uses both heap and direct memory. As a rule of thumb:
- ~30 MB heap for operational overhead.
- 1 MB + (capacity × 8 bytes) of direct memory for index structures.
File Channels also require additional heap during fast replay. If you enable:
agent.channels.ch-0.use-fast-replay = true
the channel may use up to capacity × 32 bytes of heap for replay without a checkpoint. For example, replaying 100 million events may require nearly 3.2 GB of heap.
If use-fast-replay is not enabled, Flume performs a slower replay that consumes far less memory but increases recovery time.
Flume Core Memory
Flume’s core runtime typically adds around 50 MB of heap usage. Always include an additional buffer for JVM allocation behavior, GC overhead, and bursts in event size. Monitor real usage via JMX to establish steady-state and peak patterns.
Example JVM Configuration
Flume reads JVM settings from flume-env.sh. The template is shipped as flume-env.sh.template; rename it to activate. It is best practice to allocate the full required memory at startup to avoid pause times when the JVM expands its heap under load.
An example configuration for a large Flume agent:
# Minimum heap: 2GB, maximum: 16GB # Max direct memory: 256MB # Use ParNew + CMS for reduced pause times JAVA_OPTS=" -Xms2000m -Xmx16000m -Xss128k -XX:MaxDirectMemorySize=256m -XX:+UseParNewGC -XX:+UseConcMarkSweepGC "
Adapted from operational guidance originally published in the Flume Wiki.
If you need help with distributed systems, backend engineering, or data platforms, check my Services.