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

docs: Added info about client config options for suppressing/enabling FQDN info in syslogmsgs (#8396)

Browse Source 
* Update Graylog.md

* Added some hints for configuring some syslog clients.
This commit is contained in:
Dag Bakke
2018-03-15 22:46:50 +01:00
committed by Neil Lathwood
parent 0ac40421e1
commit 69bedd0101
2 changed files with 32 additions and 1 deletions
Download Patch File Download Diff File Expand all files Collapse all files

31
doc/Extensions/Graylog.md
View File

@@ -9,7 +9,7 @@ Currently, LibreNMS does not associate shortnames from Graylog with full FQDNS.
`$PreserveFQDN on`
to your rsyslog config to send the full FQDN so device logs will be associated correctly in LibreNMS
to your rsyslog config to send the full FQDN so device logs will be associated correctly in LibreNMS. Also see near the bottom of this document for tips on how to enable/suppress the domain part of hostnames in syslog-messages for some platforms.
Graylog itself isn't included within LibreNMS, you will need to install this separately either on the same infrastructure as LibreNMS or as a totally
standalone appliance.
@@ -43,3 +43,32 @@ If you choose to use another user besides the admin user, please note that curre
If you have enabled TLS for the Graylog API and you are using a self-signed certificate, please make sure that the certificate is trusted by your LibreNMS host, otherwise the connection will fail.
Additionally, the certificate's Common Name (CN) has to match the FQDN or IP address specified in `$config['graylog']['server']`.
## Suppressing/enabling the domain part of a hostname for specific platforms
You should see if what you get in syslog/Graylog matches up with your configured hosts first. If you need to modify the syslog messages from specific platforms, this may be of assistance:
### IOS (Cisco)
```
router(config)# logging origin-id hostname
```
or
```
router(config)# logging origin-id string
```
### JunOS (Juniper Networks)
```
set system syslog host yourlogserver.corp log-prefix YOUR_PREFERRED_STRING
```
### PanOS (Palo Alto Networks)
```
set deviceconfig setting management hostname-type-in-syslog hostname
```
or
```
set deviceconfig setting management hostname-type-in-syslog FQDN
```

2
doc/Extensions/Syslog.md
View File

@@ -2,6 +2,7 @@ source: Extensions/Syslog.md
# Setting up syslog support
This document will explain how to send syslog data to LibreNMS.
Please also refer to the file Graylog.md for an alternate way of integrating syslog with LibreNMS.
### Syslog server installation
@@ -163,6 +164,7 @@ See here for more Clean Up Options [Link](https://docs.librenms.org/#Support/Con
### 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.
Further configuration hints may be found in the file Graylog.md.
Replace librenms.ip with IP or hostname of your LibreNMS install.