mirror/librenms-librenms
1
0
Fork 0
mirror of https://github.com/librenms/librenms.git synced 2024-10-07 16:52:45 +00:00
Code Issues Actions Packages Projects Releases Wiki Activity

Syslog.md update to reflect syslog-ng 3.5.1

Browse Source 
Updated configuration in documentation to suit syslog-ng 3.5.1 (tested
in Ubuntu LTS 14.04 Server)

Added line to add to config.php to enable Syslog functionality
This commit is contained in:
James Campbell
2015-06-01 06:42:32 +10:00
parent edada217fb
commit 7e96118c94
1 changed files with 38 additions and 22 deletions
Download Patch File Download Diff File Expand all files Collapse all files

60
doc/Extensions/Syslog.md
View File

@@ -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: Once syslog-ng is installed, edit the relevant config file (most likely /etc/syslog-ng/syslog-ng.conf) and paste the following:
```ssh ```ssh
@version: 3.5
@include "scl.conf"
@include "`scl-root`/system/tty10.conf"
# First, set some global options. # First, set some global options.
options { options {
chain_hostnames(0); chain_hostnames(off);
flush_lines(0); flush_lines(0);
use_dns(1); # Search name with DNS of the machine use_dns(no);
use_fqdn(1); # Use all FQDN name of the machine use_fqdn(no);
owner("root");
group("adm");
perm(0640); perm(0640);
stats_freq(0); stats_freq(0);
keep_hostname(0); bad_hostname("^gconfd$");
log_fifo_size (1000);
time_reopen (10);
create_dirs (no);
}; };
########################
# Sources
########################
source s_sys { source s_sys {
system(); system();
internal(); internal();
}; };
source s_net { source s_net {
udp(port(514) flags(syslog-protocol));
tcp(port(514) flags(syslog-protocol)); tcp(port(514) flags(syslog-protocol));
udp(port(514) flags(syslog-protocol));
}; };
########################
# Destinations
########################
destination d_librenms { 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)); 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 { log {
source(s_net); source(s_net);
source(s_sys); source(s_sys);
destination(d_librenms); 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: Next start syslog-ng:
@@ -65,6 +75,12 @@ Next start syslog-ng:
service syslog-ng restart 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 ### 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. 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.
@@ -105,4 +121,4 @@ logging librenms.ip
logging server librenms.ip 5 use-vrf default facility local6 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.