druid/docs/content/Realtime.md

55 lines
1.6 KiB
Markdown
Raw Normal View History

---
2013-09-26 19:22:28 -04:00
layout: doc_page
---
Realtime Nodes
2013-09-13 18:20:39 -04:00
========
Realtime nodes provide a realtime index. Data indexed via these nodes is immediately available for querying. Realtime nodes will periodically build segments representing the data theyve collected over some span of time and transfer these segments off to [Historical](Historical.html) nodes. They use ZooKeeper to monitor the transfer and MySQL to store metadata about the transfered segment. Once transfered, segments are forgotten by the Realtime nodes.
2013-09-13 18:20:39 -04:00
Quick Start
-----------
Run:
2013-09-13 18:20:39 -04:00
```
io.druid.cli.Main server realtime
```
2013-09-13 18:20:39 -04:00
With the following JVM configuration:
2013-09-13 18:20:39 -04:00
```
-server
-Xmx256m
-Duser.timezone=UTC
-Dfile.encoding=UTF-8
2013-09-13 18:20:39 -04:00
druid.host=localhost
druid.service=realtime
druid.port=8083
2013-12-20 15:26:27 -05:00
druid.extensions.coordinates=["io.druid.extensions:druid-kafka-seven:0.6.46"]
2013-11-18 19:20:25 -05:00
druid.zk.service.host=localhost
# The realtime config file.
druid.realtime.specFile=/path/to/specFile
# Choices: db (hand off segments), noop (do not hand off segments).
druid.publish.type=db
druid.db.connector.connectURI=jdbc\:mysql\://localhost\:3306/druid
druid.db.connector.user=druid
druid.db.connector.password=diurd
druid.processing.buffer.sizeBytes=10000000
```
The realtime module also uses several of the default modules in [Configuration](Configuration.html). For more information on the realtime spec file (or configuration file), see [realtime ingestion](Realtime-ingestion.html) page.
2013-09-13 18:20:39 -04:00
2013-09-13 18:20:39 -04:00
Requirements
------------
Realtime nodes currently require a Kafka cluster to sit in front of them and collect results. Theres [more configuration](Tutorial\:-Loading-Your-Data-Part-2.md#set-up-kafka) required for these as well.