Skip to content

Commit 8897bf9

Browse files
authored
Create README.md
1 parent 6c7e3a0 commit 8897bf9

File tree

1 file changed

+24
-0
lines changed

1 file changed

+24
-0
lines changed

README.md

+24
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,24 @@
1+
## xAPI Kafka Viewer
2+
Simple WebSocket-based xAPI viewer for a Kafka cluster.
3+
4+
This repo is just the service without any additional deployment guidance, but does contain a Dockerfile to streamline that.
5+
6+
![Example Image](https://i.imgur.com/hqKFAyg.png)
7+
8+
## Setup
9+
Setup is pretty straightforward, as it's just a basic NodeJS Express app.
10+
11+
### tl;dr:
12+
- `git clone https://github.com/vbhayden/kafka-xapi-viewer`
13+
- `cd kafka-xapi-viewer`
14+
- `cp config.example.js config.js`
15+
- Populate the `config.js` file (see comments in-file and/or notes below)
16+
- `npm install`
17+
- `node app.js`
18+
19+
### Setting the Config Values
20+
The example config file is commented to help with settings things up, but it's not too bad. Mainly, you'll need to specify two things:
21+
- The Kafka brokers to use
22+
- The Kafka topics to monitor
23+
24+
Additionally, the Kafka adapter supports plaintext SASL auth (also commented), but this isn't a requirement.

0 commit comments

Comments
 (0)