diff options
author | Daniel Baumann <daniel.baumann@progress-linux.org> | 2024-04-15 16:28:21 +0000 |
---|---|---|
committer | Daniel Baumann <daniel.baumann@progress-linux.org> | 2024-04-15 16:28:21 +0000 |
commit | 24b1e14e26b1bc6cf98663c2964a3637c56944eb (patch) | |
tree | 5dfbc4d09ae789919613f5e20d0dcac87e6ece90 /debian/rsyslog-kafka.README.Debian | |
parent | Adding upstream version 8.2402.0. (diff) | |
download | rsyslog-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.Debian | 26 |
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 |