Adding instructions to deploy a kafkacat container
Change-Id: I59f796c29d976503b95cd981e8f09c066017946c
diff --git a/charts/kafka.md b/charts/kafka.md
index 464dfe5..4004be0 100644
--- a/charts/kafka.md
+++ b/charts/kafka.md
@@ -20,4 +20,32 @@
```shell
helm install --name cord-kafka incubator/kafka -f examples/kafka-single.yaml
+```
+
+## Viewing events on the bus
+
+As a debugging tool you can deploy a container containing `kafkacat` and use
+that to listen for events:
+
+```shell
+helm install -n kafkacat xos-tools/kafkacat/
+```
+
+Once the container is up and running you can exec into the pod and use this
+command to listen for events on a particular topic:
+
+```shell
+kafkacat -C -b <kafka-service> -t <kafka-topic>
+```
+
+For a complete reference, please refer to the [`kafkacat` guide](https://github.com/edenhill/kafkacat)
+
+### Most common topics
+
+Here are some of the most common topic you can listen to on `cord-kafka`:
+
+```shell
+kafkacat -b cord-kafka -t onu.events
+kafkacat -b cord-kafka -t authentication.events
+kafkacat -b cord-kafka -t dhcp.events
```
\ No newline at end of file