summaryrefslogtreecommitdiffstats
path: root/debian/rsyslog-kafka.README.Debian
diff options
context:
space:
mode:
authorDaniel Baumann <daniel.baumann@progress-linux.org>2024-04-15 16:28:21 +0000
committerDaniel Baumann <daniel.baumann@progress-linux.org>2024-04-15 16:28:21 +0000
commit24b1e14e26b1bc6cf98663c2964a3637c56944eb (patch)
tree5dfbc4d09ae789919613f5e20d0dcac87e6ece90 /debian/rsyslog-kafka.README.Debian
parentAdding upstream version 8.2402.0. (diff)
downloadrsyslog-24b1e14e26b1bc6cf98663c2964a3637c56944eb.tar.xz
rsyslog-24b1e14e26b1bc6cf98663c2964a3637c56944eb.zip
Adding debian version 8.2402.0-1.debian/8.2402.0-1
Signed-off-by: Daniel Baumann <daniel.baumann@progress-linux.org>
Diffstat (limited to 'debian/rsyslog-kafka.README.Debian')
-rw-r--r--debian/rsyslog-kafka.README.Debian26
1 files changed, 26 insertions, 0 deletions
diff --git a/debian/rsyslog-kafka.README.Debian b/debian/rsyslog-kafka.README.Debian
new file mode 100644
index 0000000..7cbf85c
--- /dev/null
+++ b/debian/rsyslog-kafka.README.Debian
@@ -0,0 +1,26 @@
+How to use rsyslog and Apache Kafka
+===================================
+
+Starting with version 8.7.0, rsyslog comes with an output module named
+“omkafka”, allowing to publish log messages to an Apache Kafka message broker.
+
+Apache Kafka isn't part of the Debian archive, and documenting how to set it up
+is out of the scope of this document. Fortunately, setting up a single-node
+Kafka service is quite easy. The following instructions should be enough to get
+started: https://kafka.apache.org/documentation.html#quickstart
+
+At this point, you'll have to alter your rsyslog configuration, typically by
+adding the following lines to rsyslog.conf (or to a separate files such as
+/etc/rsyslog.d/kafka.conf, which will be included by the main config file):
+
+ module(load="omkafka")
+ *.* action(type="omkafka" topic="test")
+
+Don't forget to restart the rsyslogd daemon, and make sure the “topic”
+parameter matches one of the topics in Kafka. You should then be able to start
+consuming the logs stored in Kafka with the consumer of your choice. A trivial
+consumer comes with the Kafka server installation.
+
+The full configuration details of this module, are found in the following file
+(which is part of the rsyslog-doc package):
+/usr/share/doc/rsyslog-doc/html/configuration/modules/omkafka.html