Add not about RFC3164 to syslog input readme

This commit is contained in:
Daniel Nelson 2018-10-01 12:02:28 -07:00
parent f712e63a89
commit a63c0dda94
No known key found for this signature in database
GPG Key ID: CAAD59C9444F6155
1 changed files with 29 additions and 19 deletions

View File

@ -55,25 +55,7 @@ The [`best_effort`](https://github.com/influxdata/go-syslog#best-effort-mode)
option instructs the parser to extract partial but valid info from syslog option instructs the parser to extract partial but valid info from syslog
messages. If unset only full messages will be collected. messages. If unset only full messages will be collected.
### Metrics #### Rsyslog Integration
- syslog
- tags
- severity (string)
- facility (string)
- hostname (string)
- appname (string)
- fields
- version (integer)
- severity_code (integer)
- facility_code (integer)
- timestamp (integer)
- procid (string)
- msgid (string)
- sdid (bool)
- *Structured Data* (string)
### Rsyslog Integration
Rsyslog can be configured to forward logging messages to Telegraf by configuring Rsyslog can be configured to forward logging messages to Telegraf by configuring
[remote logging](https://www.rsyslog.com/doc/v8-stable/configuration/actions.html#remote-machine). [remote logging](https://www.rsyslog.com/doc/v8-stable/configuration/actions.html#remote-machine).
@ -96,3 +78,31 @@ $ActionQueueSaveOnShutdown on # save in-memory data if rsyslog shuts down
``` ```
To complete TLS setup please refer to [rsyslog docs](https://www.rsyslog.com/doc/v8-stable/tutorials/tls.html). To complete TLS setup please refer to [rsyslog docs](https://www.rsyslog.com/doc/v8-stable/tutorials/tls.html).
### Metrics
- syslog
- tags
- severity (string)
- facility (string)
- hostname (string)
- appname (string)
- fields
- version (integer)
- severity_code (integer)
- facility_code (integer)
- timestamp (integer)
- procid (string)
- msgid (string)
- sdid (bool)
- *Structured Data* (string)
### Troubleshooting
The syslog plugin does not yet support RFC3164 format data. You may see the following error when this syslog format is received:
``
E! Error in plugin [inputs.syslog]: expecting a version value in the range 1-999 [col 5]
```
You can use rsyslog to translate RFC3164 syslog messages to RFC5424 or RFC5425 format.