From eb6622521a81d9122f3101f3aa2829fe3f1ca398 Mon Sep 17 00:00:00 2001
From: Konrad Bucheli <konrad.bucheli@psi.ch>
Date: Thu, 22 Feb 2024 16:58:37 +0100
Subject: [PATCH] start log documentation

---
 _toc.yml                                       | 2 ++
 admin-guide/configuration/syslog_forwarding.md | 9 +++++++++
 2 files changed, 11 insertions(+)
 create mode 100644 admin-guide/configuration/syslog_forwarding.md

diff --git a/_toc.yml b/_toc.yml
index 0d264964..2e7747b5 100644
--- a/_toc.yml
+++ b/_toc.yml
@@ -56,6 +56,8 @@ chapters:
           - file: admin-guide/configuration/banner_message
           - file: admin-guide/configuration/alternative_desktops
           - file: admin-guide/configuration/central_logging_elastic
+          - file: admin-guide/configuration/syslog_forwarding
+          - file: admin-guide/configuration/journal
           - file: admin-guide/configuration/metrics_telegraf
           - file: admin-guide/configuration/ntp_server
           - file: admin-guide/configuration/ssh_host_hopping
diff --git a/admin-guide/configuration/syslog_forwarding.md b/admin-guide/configuration/syslog_forwarding.md
new file mode 100644
index 00000000..38857717
--- /dev/null
+++ b/admin-guide/configuration/syslog_forwarding.md
@@ -0,0 +1,9 @@
+# Syslog Forwarding
+
+To forward the system logs to a Syslog server, configure in Hiera `log_client::forward_to`:
+```
+  log_client::forward_to:
+    - 'log1.psi.ch:1514'
+    - '@log2.psi.ch'
+```
+This sends to `log1.psi.ch` on the custom UDP port `1544`, but also `log2.psi.ch` gets a copy on TCP default port `514`.