Skip to content

Commit

Permalink
Browse files Browse the repository at this point in the history
Merge pull request #1171 from neokjames/master
Syslog.md update to reflect syslog-ng 3.5.1
  • Loading branch information
laf committed May 31, 2015
2 parents 924c8e2 + 8a774cd commit 34f9b20
Showing 1 changed file with 38 additions and 22 deletions.
60 changes: 38 additions & 22 deletions doc/Extensions/Syslog.md
Expand Up @@ -17,46 +17,56 @@ yum install syslog-ng
Once syslog-ng is installed, edit the relevant config file (most likely /etc/syslog-ng/syslog-ng.conf) and paste the following:

```ssh
@version: 3.5
@include "scl.conf"
@include "`scl-root`/system/tty10.conf"
# First, set some global options.
options {
chain_hostnames(0);
chain_hostnames(off);
flush_lines(0);
use_dns(1); # Search name with DNS of the machine
use_fqdn(1); # Use all FQDN name of the machine
use_dns(no);
use_fqdn(no);
owner("root");
group("adm");
perm(0640);
stats_freq(0);
keep_hostname(0);
log_fifo_size (1000);
time_reopen (10);
create_dirs (no);
bad_hostname("^gconfd$");
};
########################
# Sources
########################
source s_sys {
system();
internal();
system();
internal();
};
source s_net {
udp(port(514) flags(syslog-protocol));
tcp(port(514) flags(syslog-protocol));
udp(port(514) flags(syslog-protocol));
};
########################
# Destinations
########################
destination d_librenms {
program("/opt/librenms/syslog.php" template ("$HOST||$FACILITY||$PRIORITY||$LEVEL||$TAG||$YEAR-$MONTH-$DAY $HOUR:$MIN:$SEC||$MSG||$PROGRAM\n") template-escape(yes));
};
########################
# Log paths
########################
log {
source(s_net);
source(s_sys);
destination(d_librenms);
};
@include "/etc/syslog-ng/conf.d/"
###
# Include all config files in /etc/syslog-ng/conf.d/
###
@include "/etc/syslog-ng/conf.d/*.conf"
```

Next start syslog-ng:
Expand All @@ -65,6 +75,12 @@ Next start syslog-ng:
service syslog-ng restart
```

Add the following to your LibreNMS config.php file to enable the Syslog extension:

```ssh
$config['enable_syslog'] = 1;
```

### Client configuration

Below are sample configurations for a variety of clients. You should understand the config before using it as you may want to make some slight changes.
Expand Down Expand Up @@ -105,4 +121,4 @@ logging librenms.ip
logging server librenms.ip 5 use-vrf default facility local6
```

If you have permitted udp and tcp 514 through any firewall then that should be all you need. Logs should start appearing and displayed within the LibreNMS web ui.
If you have permitted udp and tcp 514 through any firewall then that should be all you need. Logs should start appearing and displayed within the LibreNMS web UI.

0 comments on commit 34f9b20

Please sign in to comment.