mirror of https://github.com/reiseburo/offtopic
66 lines
2.7 KiB
Plaintext
66 lines
2.7 KiB
Plaintext
= Offtopic
|
|
|
|
image:https://travis-ci.org/reiseburo/offtopic.svg?branch=master["Build Status", link="https://travis-ci.org/reiseburo/offtopic"]
|
|
image:https://api.bintray.com/packages/rtyler/maven/offtopic/images/download.svg[link="https://bintray.com/rtyler/maven/offtopic/_latestVersion"]
|
|
|
|
|
|
Offtopic is a simple web application built with link:http://ratpack.io[Ratpack]
|
|
for inspecting and consuming events from link:http://kafka.apache.org[Apache Kafka]
|
|
|
|
The primary goal of this tool is to give you real-time insight into a running
|
|
Kafka cluster.
|
|
|
|
image:http://strongspace.com/rtyler/public/offtopic-0.2.0-topicwatch.png['Watching topics in action']
|
|
|
|
== System Requirements
|
|
|
|
* Java 8
|
|
* link:http://zookeeper.apache.org[Apache Zookeeper]
|
|
* link:http://kafka.apache.org[Apache Kafka]
|
|
|
|
== Features
|
|
|
|
* **Watch**: From the `/topics` page clicking the "watch" button will set up a
|
|
WebSockets-based stream of events straight from Kafka to your browser
|
|
* **Multipass**: From the `/topics` page you can select multiple topics to
|
|
watch at once (link:http://strongspace.com/rtyler/public/offtopic-usemultipass-20141125.png[screenshot of multipass in action])
|
|
* **Binary data support**: Clicking on a message row in the "watch" view will
|
|
drop down a base64-encoded version of the message data
|
|
|
|
== Usage Notes
|
|
|
|
As of `0.3.0` Offtopic is available as a wholly self-contained executable `.jar`
|
|
file which means running the command below will start Offtopic on link:http://localhost:5050/[localhost:5050]:
|
|
|
|
✗ java -jar offtopic*-all.jar
|
|
log4j:WARN No appenders could be found for logger (io.netty.util.internal.logging.InternalLoggerFactory).
|
|
log4j:WARN Please initialize the log4j system properly.
|
|
log4j:WARN See http://logging.apache.org/log4j/1.2/faq.html#noconfig for more info.
|
|
|
|
|
|
By default Offtopic looks for a Zookeeper on `localhost:2181`, if you wish to
|
|
connect it to another Zookeeper ensemble, use the `zookeeper` Java property,
|
|
e.g.:
|
|
|
|
✗ java -Dzookeepers=example.com:2181 -jar offtopic*-all.jar
|
|
log4j:WARN No appenders could be found for logger (io.netty.util.internal.logging.InternalLoggerFactory).
|
|
log4j:WARN Please initialize the log4j system properly.
|
|
log4j:WARN See http://logging.apache.org/log4j/1.2/faq.html#noconfig for more info.
|
|
|
|
|
|
|
|
=== Topic Watch Wildcards
|
|
|
|
A somewhat "hidden" feature is the ability to use regular expression when
|
|
watching topics. A normal topic watch URL might be
|
|
`localhost:5050/topics/foo/watch`. If there are a number of topics which are
|
|
all prefixed with `foo` you can watch them all at the same time with:
|
|
link:http://localhost:5050/topics/foo*/watch[localhost:5050/topics/foo*/watch].
|
|
|
|
The regular expressions that
|
|
link:http://www.groovy-lang.org/Regular+Expressions[Groovy supports] should all
|
|
be supported in the URL space.
|
|
|
|
|
|
|