README.md in remote_syslog-1.6.7.2 vs README.md in remote_syslog-1.6.8
- old
+ new
@@ -239,19 +239,35 @@
parse_fields: "something-meaningless ()()()(.*)"
Per-file regexes are not supported. Run multiple instances with different
config files.
+
### Excluding lines matching a pattern
There may be certain log messages that you do not want to be sent. These may
repetitive log lines that are "noise" that you might not be able to filter out
easily from the respective application. To filter these lines, use the
exclude_patterns with an array or regexes:
exclude_patterns:
- exclude this
- \d+ things
+
+
+### Choosing app name
+
+remote_syslog uses the log file name (like "access_log") as the syslog
+program name, or what the syslog RFCs call the "tag." This is ideal unless
+remote_syslog watches many files that have the same name.
+
+In that case, tell remote_syslog to set another program name by creating
+symbolic link to the generically-named file:
+
+ cd /path/to/logs
+ ln -s generic_name.log unique_name.log
+
+Point remote_syslog at unique_name.log. It will use that as the program name.
## Reporting bugs
1. See whether the issue has already been reported: <https://github.com/papertrail/remote_syslog/issues/>