aboutsummaryrefslogtreecommitdiffstats
path: root/tools/syslog-ng.html
diff options
context:
space:
mode:
authorSilvino Silva <silvino@bk.ru>2016-09-15 00:47:34 +0100
committerSilvino Silva <silvino@bk.ru>2016-09-15 00:47:34 +0100
commit07bedee34d9ded6f86904c7e4b4e02464ff8cb14 (patch)
tree242dcbfdcd97667017bdfcaaa535919b01168fe1 /tools/syslog-ng.html
parentb9762bb44befe4a852688eb19cce1aec3462f2ca (diff)
downloaddoc-07bedee34d9ded6f86904c7e4b4e02464ff8cb14.tar.gz
added tools
Diffstat (limited to 'tools/syslog-ng.html')
-rw-r--r--tools/syslog-ng.html261
1 files changed, 261 insertions, 0 deletions
diff --git a/tools/syslog-ng.html b/tools/syslog-ng.html
new file mode 100644
index 0000000..20bb1b1
--- /dev/null
+++ b/tools/syslog-ng.html
@@ -0,0 +1,261 @@
+<!DOCTYPE html>
+<html dir="ltr" lang="en">
+ <head>
+ <meta charset='utf-8'>
+ <title>1. Syslog-ng</title>
+ </head>
+ <body>
+ <h1>1. Syslog-ng</h1>
+
+ <p>Syslog-ng offers more than sysklogd, for example, we
+ can log messages to different files based on pattern. It
+ is possible to have both syslog-ng and sysklog, I will
+ only configure syslog-ng and remove sysklog.</p>
+
+ <p>A simple way to "watch" log files is to use tail, with
+ exception of faillog, see man faillog for more information.</p>
+
+ <pre>
+ $ cd /var/log
+ $ sudo tail -f messages kernel cron auth
+ </pre>
+
+ <h2 id="eventlog">1.1. Install event log</h2>
+
+ <pre>
+ $ mkdir eventlog
+ $ vim Pkgfile
+ </pre>
+
+ <pre>
+ # Description: replacement of the simple syslog() API
+ # URL: http://www.balabit.com/network-security/syslog-ng/opensource-logging-system
+ # Maintainer: Thomas Penteker, tek at serverop dot de
+ #
+ # Depends on:
+
+ name=eventlog
+ version=0.2.12
+ release=1
+ source=(http://ftp.uni-erlangen.de/pub/mirrors/gentoo/distfiles/${name}_${version}.tar.gz)
+
+ build() {
+ cd $name-$version
+
+ ./configure \
+ --prefix=/usr \
+ --disable-nls \
+ --mandir=/usr/man
+
+ make && make DESTDIR=$PKG install
+ rm -rf $PKG/usr/doc
+ }
+ </pre>
+
+ <pre>
+ $ fakeroot pkgmk -d
+ $ sudo pkgadd /usr/ports/packages/eventlog#0.2.12-1.pkg.tar.gz
+ </pre>
+
+ <h2 id="install">1.2. Install syslog-ng</h2>
+
+ <pre>
+ $ cd ..
+ $ mkdir syslog-ng
+ $ vim Pkgfile
+ </pre>
+
+ <pre>
+ # Description: alternate syslogging daemon
+ # URL: http://www.balabit.com/network-security/syslog-ng/opensource-logging-system
+ # Packager: Silvino Silva, silvino at bk dot ru
+ # Depends on: eventlog, glib, libwrap
+
+ name=syslog-ng
+ version=3.5.6
+ release=1
+ source=(http://balabit.com/downloads/files/syslog-ng/sources/$version/source/${name}_${version}.tar.gz
+ syslog-ng.rc syslog-ng.conf)
+
+ build() {
+ cd $name-$version
+
+ ./configure \
+ --prefix=/usr \
+ --sysconfdir=/etc \
+ --libexecdir=/var/libexec \
+ --localstatedir=/var \
+ --mandir=/usr/man \
+ --enable-dynamic-linking \
+ --sbindir=/sbin \
+ --enable-tcp-wraper
+
+
+ make && make DESTDIR=$PKG install
+ rm -rf $PKG/usr/doc
+ rm -rf $PKG/usr/share/include/scl/syslogconf/README
+ install -D -m 644 ../syslog-ng.conf $PKG/etc/syslog-ng.conf
+ install -D -m 755 ../syslog-ng.rc $PKG/etc/rc.d/syslog-ng
+ }
+ </pre>
+
+ <pre>
+ $ sudo prt-get depinst glib
+ $ pkgmk -um
+ $ pkgmk -uf
+ $ fakeroot pkgmk -d
+ $ sudo pkgadd /usr/ports/packages/syslog-ng#3.5.6-1.pkg.tar.gz
+ </pre>
+
+ <p>Change /etc/rc.conf, replace sysklog with syslog-ng;</p>
+
+ <pre>
+ #
+ # /etc/rc.conf: system configuration
+ #
+
+ FONT=default
+ KEYMAP=dvorak
+ TIMEZONE="Europe/Lisbon"
+ HOSTNAME=box
+ SYSLOG=syslog-ng
+ SERVICES=(syslog-ng lo net crond)
+
+ # End of file
+ </pre>
+
+ <h2 id="syslogrc">1.3. Syslog-ng RC</h2>
+
+ <pre>
+ $ vim syslog-ng.rc
+ </pre>
+
+ <pre>
+ #!/bin/sh
+ #
+ # /etc/rc.d/syslog-ng: start/stop syslog-ng logging daemon
+ #
+
+ case $1 in
+ start)
+ /sbin/syslog-ng -f /etc/syslog-ng.conf -p /var/run/syslog-ng.pid
+ ;;
+ stop)
+ killall -q /sbin/syslog-ng
+ rm -f /var/run/syslog-ng.pid
+ ;;
+ restart)
+ $0 stop
+ sleep 2
+ $0 start
+ ;;
+ *)
+ echo "usage: $0 [start|stop|restart]"
+ ;;
+ esac
+ </pre>
+
+ <h3 id="syslog-conf">1.4. Syslog-ng configuration</h3>
+
+ <p>Example of <a href="../conf/etc/syslog-ng.conf">/etc/syslog-ng.conf</a>
+ that configures syslog-ng matching tools already installed in the system
+ and some that are part of <a href="../tools/index.html">tools</a>.</p>
+
+ <p>Description off global options used;</p>
+
+ <dl>
+ <dt>chain-hostnames()</dt>
+
+ <dd>Accepted values: yes | no</dd>
+ <dd>Default: no</dd>
+
+ <dd>Description: Enable or disable the chained hostname format.
+ If the log message is forwarded to the log server via a relay,
+ and the chain-hostnames() option is enabled, the relay adds its
+ own hostname to the hostname of the client, separated with
+ a / character.</dd>
+
+ <dt>create-dirs()</dt>
+
+ <dd>Accepted values: yes | no</dd>
+ <dd>Default: no</dd>
+
+ <dd>Description: Enable or disable directory creation for
+ destination files.</dd>
+
+ <dt>use-dns()</dt>
+
+ <dd>Type: yes, no, persist_only</dd>
+ <dd>Default: yes</dd>
+
+ <dd>Description: Enable or disable DNS usage. The persist_only
+ option attempts to resolve hostnames locally from file (for example
+ from /etc/hosts). The syslog-ng OSE application blocks on DNS
+ queries, so enabling DNS may lead to a Denial of Service attack.</dd>
+
+ <dt>stats_freq()</dt>
+
+ <dd>Accepted values: number</dd>
+ <dd>Default: 600</dd>
+
+ <dd>Description: The period between two STATS messages in seconds.
+ STATS are log messages sent by syslog-ng, containing statistics
+ about dropped log messages. Set to 0 to disable the STATS
+ messages.</dd>
+
+ <dt>perm()</dt>
+
+ <dd>Accepted values: permission value</dd>
+ <dd>Default: 0600</dd>
+
+ <dd>Description: The default permission for output files.
+ By default, syslog-ng changes the privileges of accessed files
+ (for example /dev/null) to root.root 0600. To disable modifying
+ privileges, use this option with the -1 value.</dd>
+
+ <dt>log-fifo-size()</dt>
+
+ <dd>Accepted values: number</dd>
+ <dd>Default: 10000</dd>
+
+ <dd>Description: The number of messages that the output queue
+ can store.</dd>
+
+ <dt>log-msg-size()</dt>
+
+ <dd>Accepted values: number</dd>
+ <dd>Default: 8192</dd>
+
+ <dd>Description: Maximum length of a message in bytes. This
+ length includes the entire message (the data structure and
+ individual fields). The maximal value that can be set is 268435456
+ bytes (256MB). For messages using the IETF-syslog message format
+ (RFC5424), the maximal size of the value of an SDATA field is
+ 64kB.</dd>
+
+ <dt>flush-lines()</dt>
+
+ <dd>Type: number</dd>
+ <dd>Default: Use global setting.</dd>
+
+ <dd>Description: Specifies how many lines are flushed to a
+ destination at a time. The syslog-ng OSE application waits for
+ this number of lines to accumulate and sends them off in a single
+ batch. Increasing this number increases throughput as more
+ messages are sent in a single batch, but also increases message
+ latency.</dd>
+ </dl>
+
+ <pre>
+ $ sudo sh /etc/rc.d/syslog-ng start
+ $ sudo sh /etc/rc.d/sysklogd stop
+ </pre>
+
+ <p>This is part of the c9-doc Manual.
+Copyright (C) 2016
+Silvino Silva.
+See the file <a href="fdl-1.3-standalone.html">Gnu Free Documentation License</a>
+for copying conditions.</p>
+
+ </body>
+</html>