explain the chunked logging and the prefix

Signed-off-by: Sandor Szücs <sandor.szuecs@zalando.de>
zalando · Jan 5, 2024 · 3095e93 · 3095e93
1 parent d5f360b
commit 3095e93
Showing 1 changed file with 10 additions and 6 deletions.
diff --git a/docs/reference/filters.md b/docs/reference/filters.md
@@ -732,12 +732,16 @@ Example:
 
 ### logBody
 
-The `logBody` filter logs the request or response body while
-streaming.  Note that this filter should be used only in diagnostics
-setup and with care, since the request and response body may contain
-sensitive data, and they also can explode the amount of logs. You can
-log request or response bodies. This filter has close to no overhead
-other than the I/O created by the logger.
+The `logBody` filter logs the request or response body in chunks while
+streaming. Chunks start with `logBody("request") $flowid: `, such that
+you can find all chunks belonging to a given flow. See also
+[flowId()](#flowid) filter.
+
+Note that this filter should be used only in diagnostics setup and
+with care, since the request and response body may contain sensitive
+data, and they also can explode the amount of logs. You can log
+request or response bodies. This filter has close to no overhead other
+than the I/O created by the logger.
 
 Parameters: