diff options
| author | Robert Göhler <github@ghlr.de> | 2025-03-25 08:23:20 +0100 |
|---|---|---|
| committer | GitHub <noreply@github.com> | 2025-03-25 08:23:20 +0100 |
| commit | d257b1a30132a82a0be9cc731da68a219ceb7bf4 (patch) | |
| tree | 101b111e2dd8b94dc596f6a69fecff0b740500d2 | |
| parent | 7e70f1813d0f5d1830e897744d193444f5d80e2c (diff) | |
| parent | d493cad2a536357fd81bae73227df0724f2adf74 (diff) | |
| download | vyos-documentation-d257b1a30132a82a0be9cc731da68a219ceb7bf4.tar.gz vyos-documentation-d257b1a30132a82a0be9cc731da68a219ceb7bf4.zip | |
Merge pull request #1611 from woodsb02/patch-1
syslog: improve description of remote host config options
| -rw-r--r-- | docs/configuration/system/syslog.rst | 25 |
1 files changed, 22 insertions, 3 deletions
diff --git a/docs/configuration/system/syslog.rst b/docs/configuration/system/syslog.rst index 2a3eaa13..d266131d 100644 --- a/docs/configuration/system/syslog.rst +++ b/docs/configuration/system/syslog.rst @@ -83,13 +83,32 @@ sending the messages via port 514/UDP. Configure protocol used for communication to remote syslog host. This can be either UDP or TCP. +.. cfgcmd:: set system syslog remote <address> port <port> + + Configure the TCP or UDP port to connect to on the remote syslog host. + By default, the standard port 514 is used. + .. cfgcmd:: set system syslog remote <address> format include-timezone - Include system timezone in syslog message + Send syslog messages in the :rfc:`5424` format, rather than the + default :rfc:`3164` (BSD syslog) format. + + .. note:: + The :rfc:`5424` format utilises an :rfc:`3339` / ISO 8601 formatted + timestamp, including the system timezone. + + Examples of the two syslog message formats: + + :rfc:`3164` format: <34>Oct 11 22:14:15 mymachine su: 'su root' failed for lonvick on /dev/pts/8 + + :rfc:`5424` format: <34>1 2003-10-11T22:14:15.003-07:00 mymachine.example.com su - ID47 - BOM'su root' failed for lonvick on /dev/pts/8 .. cfgcmd:: set system syslog remote <address> format octet-counted - Allows for the transmission of all characters inside a syslog message. + Allows for the transmission of multi-line messages, without them being split + across separate syslog messages. This only applies for the TCP protocol + (this setting is ignored for UDP protocol). Ensure the receiving system is + compatible before enabling this. .. cfgcmd:: set system syslog remote <address> vrf <name> @@ -164,7 +183,7 @@ Facilities can be adjusted to meet the needs of the user: +----------+----------+----------------------------------------------------+ | 21 | local5 | local use 5 (local5) | +----------+----------+----------------------------------------------------+ -| 22 | local6 | use 6 (local6) | +| 22 | local6 | local use 6 (local6) | +----------+----------+----------------------------------------------------+ | 23 | local7 | local use 7 (local7) | +----------+----------+----------------------------------------------------+ |