From 02471b6c909e57aeb2c6d9a08b2df384fa419c69 Mon Sep 17 00:00:00 2001
From: Peter Bieringer <pb@bieringer.de>
Date: Sat, 19 Jul 2025 14:39:47 +0200
Subject: [PATCH] add trace options

---
 DOCUMENTATION.md   | 18 ++++++++++++++++++
 config             |  6 ++++++
 radicale/config.py |  8 ++++++++
 3 files changed, 32 insertions(+)

diff --git a/DOCUMENTATION.md b/DOCUMENTATION.md
index be7fe021..d00cd01a 100644
--- a/DOCUMENTATION.md
+++ b/DOCUMENTATION.md
@@ -1420,6 +1420,24 @@ Available levels: **debug**, **info**, **warning**, **error**, **critical**
 
 Default: `warning` _(< 3.2.0)_ `info` _(>= 3.2.0)_
 
+##### trace_on_debug
+
+_(> 3.5.4)_
+
+Do not filter debug messages starting with 'TRACE'
+
+Default: `False`
+
+##### trace_filter
+
+_(> 3.5.4)_
+
+Filter debug messages starting with 'TRACE/<TOKEN>'
+
+Precondition: `trace_on_debug = True`
+
+Default: (empty)
+
 ##### mask_passwords
 
 Don't include passwords in logs.
diff --git a/config b/config
index ab2ea7eb..51e5324c 100644
--- a/config
+++ b/config
@@ -272,6 +272,12 @@
 # Value: debug | info | warning | error | critical
 #level = info
 
+# do not filter debug messages starting with 'TRACE'
+#trace_on_debug = False
+
+# filter debug messages starting with 'TRACE/<TOKEN>'
+#trace_filter = ""
+
 # Don't include passwords in logs
 #mask_passwords = True
 
diff --git a/radicale/config.py b/radicale/config.py
index 15405063..7deee5ca 100644
--- a/radicale/config.py
+++ b/radicale/config.py
@@ -509,6 +509,14 @@ This is an automated message. Please do not reply.""",
             "value": "info",
             "help": "threshold for the logger",
             "type": logging_level}),
+        ("trace_on_debug", {
+            "value": "False",
+            "help": "do not filter debug messages starting with 'TRACE'",
+            "type": bool}),
+        ("trace_filter", {
+            "value": "",
+            "help": "filter debug messages starting with 'TRACE/<TOKEN>'",
+            "type": str}),
         ("bad_put_request_content", {
             "value": "False",
             "help": "log bad PUT request content",