storm-amqp-spout: AMQP input source for Storm
storm-amqp-spout allows a Storm topology to consume an AMQP queue as an input source. It currently provides:
- AMQPSpout: an implementation of
backtype.storm.topology.IRichSpoutthat connects to an AMQP broker, consumes the messages routed to a specified AMQP queue and emits them as Storm tuples.
- QueueDeclaration: an interface that encapsulates declaring an AMQP queue and setting up any exchange bindings it requires, used by AMQPSpout to set up the queue to consume.
- ExclusiveQueueWithBinding: a QueueDeclaration suitable for prototyping and one-off analytics use cases.
- SharedQueueWithBinding: a QueueDeclaration suitable for production use cases needing guaranteed processing.
The Javadocs can be found at http://code.rapportive.com/storm-amqp-spout.
To produce a jar:
$ mvn package
To install in your local Maven repository:
$ mvn install
To use in your
<project> <!-- ... --> <repositories> <repository> <id>clojars</id> <url>http://clojars.org/repo</url> </repository> </repositories> <dependencies> <!-- ... --> <dependency> <groupId>org.clojars.storm-amqp</groupId> <artifactId>storm-amqp-spout</artifactId> <version>0.2.7-SNAPSHOT</version> </dependency> <!-- ... --> </dependencies> <!-- ... --> </project>
This is early software. It has been used at production volumes, but not yet for business-critical use cases. It may break and the API is liable to change completely between releases. Pull requests, patches and bug reports are very welcome.
N.B. if you need to guarantee all messages are reliably processed, you should have AMQPSpout consume from a queue that is not set as 'exclusive' or 'auto-delete': otherwise if the spout task crashes or is restarted, the queue will be deleted and any messages in it lost, as will any messages published while the task remains down. See SharedQueueWithBinding to declare a shared queue that allows for guaranteed processing. (For prototyping, an ExclusiveQueueWithBinding may be simpler to manage.)
This does not currently handle malformed messages very well: the spout worker will crash if the provided Scheme fails to deserialise a message.
This does not currently support retrying messages in the event of transient failure to process: any message which the topology fails to process will simply be dropped. This is to prevent infinite redelivery in the event of non-transient failures (e.g. malformed messages, though see previous caveat!). This will probably be made configurable in a future release.
AMQPSpout has been tested with RabbitMQ 2.3.1, 2.6.1, 2.7.0, 2.8.2, and 3.0.2 It should probably work with other versions and other AMQP brokers.