Actual-time streaming knowledge processing is a strategic crucial that straight impacts enterprise competitiveness. Organizations face mounting stress to course of large knowledge streams instantaneously—from detecting fraudulent transactions and delivering customized buyer experiences to optimizing advanced provide chains and responding to market dynamics milliseconds forward of opponents.
Apache Spark Structured Streaming addresses these crucial enterprise challenges by means of its stateful processing capabilities, enabling functions to keep up and replace intermediate outcomes throughout a number of knowledge streams or time home windows. RocksDB was launched in Apache Spark 3.2, providing a extra environment friendly various to the default HDFS-based in-memory retailer. RocksDB excels in stateful streaming in eventualities that require dealing with massive portions of state knowledge. It delivers optimum efficiency advantages, significantly in lowering Java digital machine (JVM) reminiscence stress and rubbish assortment (GC) overhead.
This submit explores RocksDB’s key options and demonstrates its implementation utilizing Spark on Amazon EMR and AWS Glue, offering you with the information you want to scale your real-time knowledge processing capabilities.
RocksDB state retailer overview
Spark Structured Streaming processes fall into two classes:
- Stateful: Requires monitoring intermediate outcomes throughout micro-batches (for instance, when operating aggregations and de-duplication).
- Stateless: Processes every batch independently.
A state retailer is required by stateful functions that monitor intermediate question outcomes. That is important for computations that rely upon steady occasions and alter outcomes based mostly on every batch of enter, or on combination knowledge over time, together with late arriving knowledge. By default, Spark presents a state retailer that retains states in JVM reminiscence, which is performant and ample for many normal streaming circumstances. Nevertheless, when you have numerous stateful operations in a streaming software—equivalent to, streaming aggregation, streaming dropDuplicates, stream-stream joins, and so forth—the default in-memory state retailer may face out-of-memory (OOM) points due to a big JVM reminiscence footprint or frequent GC pauses, leading to degraded efficiency.
Benefits of RocksDB over in-memory state retailer
RocksDB addresses the challenges of an in-memory state retailer by means of off-heap reminiscence administration and environment friendly checkpointing.
- Off-heap reminiscence administration: RocksDB shops state knowledge in OS-managed off-heap reminiscence, lowering GC stress. Whereas off-heap reminiscence nonetheless consumes machine reminiscence, it doesn’t occupy house within the JVM. As a substitute, its core reminiscence constructions, equivalent to block cache or memTables, allocate straight from the working system, bypassing the JVM heap. This method makes RocksDB an optimum selection for memory-intensive functions.
- Environment friendly checkpointing: RocksDB routinely saves state adjustments to checkpoint places, equivalent to Amazon Easy Storage Service (Amazon S3) paths or native directories, serving to to make sure full fault tolerance. When interacting with S3, RocksDB is designed to enhance checkpointing effectivity; it does this by means of incremental updates and compaction to cut back the quantity of information transferred to S3 throughout checkpoints, and by persisting fewer massive state recordsdata in comparison with the numerous small recordsdata of the default state retailer, lowering S3 API calls and latency.
Implementation concerns
RocksDB operates as a local C++ library embedded inside the Spark executor, utilizing off-heap reminiscence. Whereas it doesn’t fall beneath JVM GC management, it nonetheless impacts total executor reminiscence utilization from the YARN or OS perspective. RocksDB’s off-heap reminiscence utilization may exceed YARN container limits with out triggering container termination, probably resulting in OOM points. It’s best to take into account the next approaches to handle Spark’s reminiscence:
Alter the Spark executor reminiscence dimension
Enhance spark.executor.memoryOverhead
orspark.executor.memoryOverheadFactor
to depart extra room for off-heap utilization. The next instance units half (4 GB) of spark.executor.reminiscence
(8 GB) because the reminiscence overhead dimension.
For Amazon EMR on Amazon Elastic Compute Cloud (Amazon EC2), enabling YARN reminiscence management with the next strict container reminiscence enforcement by means of polling technique preempts containers to keep away from node-wide OOM failures:
Off-heap reminiscence management
Use RocksDB-specific settings to configure reminiscence utilization. Extra particulars could be discovered within the Finest practices and concerns part.
Get began with RocksDB on Amazon EMR and AWS Glue
To activate the state retailer RocksDB in Spark, configure your software with the next setting:
Within the following sections, we discover making a pattern Spark Structured Streaming job with RocksDB enabled operating on Amazon EMR and AWS Glue respectively.
RocksDB on Amazon EMR
Amazon EMR variations 6.6.0 and later assist RocksDB, together with Amazon EMR on EC2, Amazon EMR serverless and Amazon EMR on Amazon Elastic Kubernetes Service (Amazon EKS). On this case, we use Amazon EMR on EC2 for instance.
Use the next steps to run a pattern streaming job with RocksDB enabled.
- Add the next pattern script toÂ
s3://
/script/sample_script.py
- On the AWS Administration Console for Amazon EMR, select Create Cluster
- For Title and functions – required, choose the newest Amazon EMR launch.
- For Steps, select Add. For Kind, choose Spark software.
- For Title, enterÂ
GettingStartedWithRocksDB
ands3://
 because the Utility location./script/sample_script.py - Select Save step.
- For different settings, select the suitable settings based mostly in your use case.
- Select Create cluster to begin the streaming software by way of Amazon EMR step.
RocksDB on AWS Glue
AWS Glue 4.0 and later variations assist RocksDB. Use the next steps to run the pattern job with RocksDB enabled on AWS Glue.
- On the AWS Glue console, within the navigation pane, select ETL jobs.
- Select Script editor and Create script.
- For the job title, enter
GettingStartedWithRocksDB
. - Copy the script from the earlier instance and paste it on the Script tab.
- On Job particulars tab, for Kind, choose Spark Streaming.
- Select Save, after which select Run to begin the streaming job on AWS Glue.
Walkthrough particulars
Let’s dive deep into the script to grasp methods to run a easy stateful Spark software with RocksDB utilizing the next instance pySpark code.
- First, arrange RocksDB as your state retailer by configuring the supplier class:
- To simulate streaming knowledge, create a knowledge stream utilizing the
charge
supply sort. It generates one report per second, containing 5 random fruit names from a pre-defined record.
- Create a phrase counting operation on the incoming stream. This can be a stateful operation as a result of it maintains operating counts between processing intervals, that’s, earlier counts should be saved to calculate the subsequent new totals.
- Lastly, output the phrase depend totals to the console:
Enter knowledge
In the identical pattern code, check knowledge (raw_stream
) is generated at a charge of one-row-per-second, as proven within the following instance:
Output consequence
The streaming job produces the next leads to the output logs. It demonstrates how Spark Structured Streaming maintains and updates the state throughout a number of micro-batches:
- Batch 0: Begins with an empty state
- Batch 1: Processes a number of enter data, leading to preliminary counts for each one of many 10 fruits (for instance, banana seems 8 instances)
- Batch 2: Working totals based mostly on new occurrences from the subsequent set of data are added to the counts (for instance, banana will increase from 8 to fifteen, indicating 7 new occurrences).
State retailer logs
RocksDB generates detailed logs in the course of the job run, like the next:
In Amazon EMR on EC2, these logs can be found on the node the place the YARN ApplicationMaster container is operating. They are often discovered at/var/log/hadoop-yarn/containers/
.
As for AWS Glue, you will discover the RocksDB metrics in Amazon CloudWatch, beneath the log group /aws-glue/jobs/error
.
RocksDB metrics
The metrics from the previous logs present insights on RocksDB standing. The followings are some instance metrics you may discover helpful when investigating streaming job points:
rocksdbCommitCheckpointLatency
: Time spent writing checkpoints to native storagerocksdbCommitCompactLatency
: Period of checkpoint compaction operations throughout checkpoint commitsrocksdbSstFileSize
: Present dimension of SST recordsdata in RocksDB.
Deep dive into RocksDB key ideas
To raised perceive the state metrics proven within the logs, we deep dive into RocksDB’s key ideas: MemTable, sorted string desk (SST) file, and checkpoints. Moreover, we offer some suggestions for finest practices and fine-tuning.
Excessive stage structure
RocksDB is an area, non-distributed persistent key-value retailer embedded in Spark executors. It permits scalable state administration for streaming workloads, backed by Spark’s checkpointing for fault tolerance. As proven within the previous determine, RocksDB shops knowledge in reminiscence and likewise on disk. RocksDB’s skill to spill knowledge over to disk is what permits Spark Structured Streaming to deal with state knowledge that exceeds the obtainable reminiscence.
Reminiscence:
- Write buffers (MemTables): Designated reminiscence to buffer writes earlier than flushing onto disk
- Block cache (learn buffer): Reduces question time by caching outcomes from disk
Disk:
- SST recordsdata: Sorted String Desk saved as SST file format for quick entry
MemTable: Saved off-heap
MemTable, proven within the previous determine, is an in-memory retailer the place knowledge is first written off-heap, earlier than being flushed to disk as an SST file. RocksDB caches the newest two batches of information (sizzling knowledge) in MemTable to cut back streaming course of latency. By default, RocksDB solely has two MemTables—one is energetic and the opposite is read-only. In case you have ample reminiscence, the configuration spark.sql.streaming.stateStore.rocksdb.maxWriteBufferNumber
could be elevated to have greater than two MemTables. Amongst these MemTables, there’s at all times one energetic desk, and the remainder are read-only MemTables used as write buffers.
SST recordsdata: Saved on Spark executor’s native disk
SST recordsdata are block-based tables saved on the Spark executor’s native disk. When the in-memory state knowledge can now not match right into a MemTable (outlined by a Spark configuration writeBufferSizeMB
), the energetic desk is marked as immutable, saving it because the SST file format, which switches it to a read-only MemTable whereas asynchronously flushing it to native disks. Whereas flushing, the immutable MemTable can nonetheless be learn, in order that the latest state knowledge is accessible with minimal learn latency.
Studying from RocksDB follows the sequence demonstrated by the previous diagram:
- Learn from the energetic MemTable.
- If not discovered, iterate by means of read-only MemTables within the order of latest to oldest.
- If not discovered, learn from BlockCache (learn buffer).
- If misses, load index (one index per SST) from disk into BlockCache. Search for key from index and if hits, load knowledge block onto BlockCache and return consequence.
SST recordsdata are saved on executors’ native directories beneath the trail of spark.native.dir
(default: /tmp
) or yarn.nodemanager.local-dirs:
- Amazon EMR on EC2 –Â
${yarn.nodemanager.local-dirs}/usercache/hadoop/appcache/
/ / - Amazon EMR Serverless, Amazon EMR on EKS, AWS Glue –
${spark.native.dir}/
/
Moreover, through the use of software logs, you possibly can monitor the MemTable flush and SST file add standing beneath the file path:
- Amazon EMR on EC2 –
/var/log/hadoop-yarn/containers/
/ /stderr - Amazon EMR on EKS –
/var/log/spark/consumer/
- /stderr
The next is an instance command to verify the SST file standing in an executor log from Amazon EMR on EKS:
cat /var/log/spark/consumer/
or
kubectl logs
The next screenshot is an instance of the output of both command.
You should use the next examples to verify if the MemTable data have been deleted and flushed out to SST:
cat /var/log/spark/consumer/
or
kubectl logs
The next screenshot is an instance of the output of both command.
Checkpoints: Saved on the executor’s native disk or in an S3 bucket
To deal with fault tolerance and fail over from the final dedicated level, RocksDB helps checkpoints. The checkpoint recordsdata are normally saved on the executor’s disk or in an S3 bucket, together with snapshot and delta or changelog knowledge recordsdata.
Beginning with Amazon EMR 7.0 and AWS Glue5.0, RocksDB state retailer supplies a brand new characteristic referred to as changelog checkpointing to improve checkpoint efficiency. when the changelog is enabled (disabled by default) utilizing the setting spark.sql.streaming.stateStore.rocksdb.changelogCheckpointing.enabled
, RocksDB writes smaller change logs to the storage location (the native disk by default) as an alternative of steadily persisting massive snapshot knowledge. Be aware that snapshots are nonetheless created however much less steadily, as proven within the following screenshot.
Right here’s an instance of a checkpoint location path when overridden to an S3 bucket: s3://
Finest practices and concerns
This part outlines key methods for fine-tuning RocksDB efficiency and avoiding widespread pitfalls.
1. Reminiscence administration for RocksDB
To stop OOM errors on Spark executors, you possibly can configure RocksDB’s reminiscence utilization at both the node stage or occasion stage:
- Node stage (advisable): Implement a worldwide off-heap reminiscence restrict per executor. On this context, every executor is handled as a RocksDB node. If an executor processes N partitions of a stateful operator, it can have N variety of RocksDB situations on a single executor.
- Occasion-level: Fantastic-tune particular person RocksDB situations.
Node-level reminiscence management per executor
Beginning with Amazon EMR 7.0 and AWS Glue 5.0 (Spark 3.5), a crucial Spark configuration, boundedMemoryUsage
, was launched (by means of SPARK-43311) to implement a worldwide reminiscence cap at a single executor stage that’s shared by a number of RocksDB situations. This prevents RocksDB from consuming unbounded off-heap reminiscence, which may result in OOM errors or executor termination by useful resource managers equivalent to YARN or Kubernetes.
The next instance exhibits the node-level configuration:
A single RocksDB occasion stage management
For granular reminiscence administration, you possibly can configure particular person RocksDB situations utilizing the next settings:
- writeBufferSizeMB (default: 64, recommended: 64 – 128): Controls the most dimension of a single MemTable in RocksDB, affecting reminiscence utilization and write throughput. This setting is accessible in Spark3.5 – [SPARK-42819] and later. It determines the scale of the reminiscence buffer earlier than state knowledge is flushed to disk. Bigger buffer sizes can enhance write efficiency by lowering SST flush frequency however will enhance the executor’s reminiscence utilization. Adjusting this parameter is essential for optimizing reminiscence utilization and write throughput.
- maxWriteBufferNumber (default: 2, recommended: 3 – 4): Units the whole variety of energetic and immutable MemTables.
For read-heavy workloads, prioritize the next block cache tuning over write buffers to cut back disk I/O. You may configure SST block dimension and caching as follows:
-  blockSizeKB (default: 4, recommended: 64–128): When an energetic MemTable is full, it turns into a read-only memTable. From there, new writes proceed to build up in a brand new desk. The read-only MemTable is flushed into SST recordsdata on the disk. The information in SST recordsdata is roughly chunked into fixed-sized blocks (default is 4 KB). Every block, in flip, retains a number of knowledge entries. When writing knowledge to SST recordsdata, you possibly can compress or encode knowledge effectively inside a block, which frequently leads to a smaller knowledge dimension in contrast with its uncooked format.
For workloads with a small state dimension (equivalent to lower than 10 GB), the default block dimension is normally ample. For a big state (equivalent to greater than 50 GB), rising the block dimension can enhance compression effectivity and sequential learn efficiency however enhance CPU overhead.
- blockCacheSizeMB (default: 8, recommended: 64–512, massive state: greater than
1024
): When retrieving knowledge from SST recordsdata, RocksDB supplies a cache layer (block cache) to enhance the learn efficiency. It first locates the info block the place the goal report may reside, then caches the block to reminiscence, and eventually searches that report inside the cached block. To keep away from frequent reads of the identical block, the block cache can be utilized to maintain the loaded blocks in reminiscence.
2. Clear up state knowledge at checkpoint
To assist make sure that your state file sizes and storage prices stay beneath management when checkpoint efficiency turns into a priority, use the next Spark configurations to regulate cleanup frequency, retention limits, and checkpoint file sorts:
- maintenanceInterval (default: 60 seconds):Â Retaining a state for a protracted time period can assist scale back upkeep price and background IO. Nevertheless, longer intervals enhance file itemizing time, as a result of state shops usually scan each retained file.
- minBatchesToRetain (default: 100, recommended: 10–50): Limits the variety of state variations retained at checkpoint places. Lowering this quantity leads to fewer recordsdata being persevered and reduces storage utilization.
- changelogCheckpointing (default: false, recommended: true): Historically, RocksDB snapshots and uploads incremental SST recordsdata to checkpoint. To keep away from this price, changelog checkpointing was launched in Amazon EMR7.0+ and AWS Glue 5.0, which write solely state adjustments for the reason that final checkpoint.
To trace an SST file’s retention standing, you possibly can search RocksDBFileManager
entries within the executor logs. Contemplate the next logs in Amazon EMR on EKS for instance. The output (proven within the screenshot) exhibits that 4 SST recordsdata beneath model 102 have been uploaded to an S3 checkpoint location, and that an outdated changelog state file with model 97 was cleaned up.
or
3. Optimize native disk utilization
RocksDB consumes native disk house when producing SST recordsdata at every Spark executor. Whereas disk utilization doesn’t scale linearly, RocksDB can accumulate storage over time based mostly on state knowledge dimension. When operating streaming jobs, if native obtainable disk house will get inadequate, No house left on gadget
errors can happen.
To optimize disk utilization by RocksDB, alter the next Spark configurations:
Infrastructure changes can additional mitigate the disk problem:
For Amazon EMR:
For AWS Glue:
- Use AWS Glue G.2X or bigger employee sorts to keep away from the restricted disk capability of G.1X staff.
- Schedule common upkeep home windows at optimum timing to unencumber disk house based mostly on workload wants.
Conclusion
On this submit, we explored RocksDB because the new state retailer implementation in Apache Spark Structured Streaming, obtainable on Amazon EMR and AWS Glue. RocksDB presents benefits over the default HDFS-backed in-memory state retailer, significantly for functions coping with large-scale stateful operations. RocksDB helps forestall JVM reminiscence stress and rubbish assortment points widespread with the default state retailer.
The implementation is simple, requiring minimal configuration adjustments, although you must pay cautious consideration to reminiscence and disk house administration for optimum efficiency. Whereas RocksDB will not be assured to scale back job latency, it supplies a strong resolution for dealing with large-scale stateful operations in Spark Structured Streaming functions.
We encourage you to judge RocksDB on your use circumstances, significantly for those who’re experiencing reminiscence stress points with the default state retailer or have to deal with massive quantities of state knowledge in your streaming functions.
In regards to the authors
Melody Yang is a Principal Analytics Architect for Amazon EMR at AWS. She is an skilled analytics chief working with AWS prospects to offer finest observe steerage and technical recommendation with a view to help their success in knowledge transformation. Her areas of pursuits are open-source frameworks and automation, knowledge engineering and DataOps.
Dai Ozaki is a Cloud Help Engineer on the AWS Huge Information Help staff. He’s keen about serving to prospects construct knowledge lakes utilizing ETL workloads. In his spare time, he enjoys enjoying desk tennis.
Noritaka Sekiyama is a Principal Huge Information Architect with Amazon Internet Providers (AWS) Analytics companies. He’s answerable for constructing software program artifacts to assist prospects. In his spare time, he enjoys biking on his street bike.
Amir Shenavandeh is a Senior Analytics Specialist Options Architect and Amazon EMR subject material skilled at Amazon Internet Providers. He helps prospects with architectural steerage and optimisation. He leverages his expertise to assist individuals deliver their concepts to life, specializing in distributed processing and massive knowledge architectures.
Xi Yang is a Senior Hadoop System Engineer and Amazon EMR subject material skilled at Amazon Internet Providers. He’s keen about serving to prospects resolve difficult points within the Huge Information space.