update usage.rst

Signed-off-by: deveshkandpal1224 <[email protected]>
envoyproxy · Jan 24, 2024 · 87cad0a · 87cad0a
1 parent ee29a36
commit 87cad0a
Showing 1 changed file with 5 additions and 1 deletion.
diff --git a/docs/root/configuration/observability/access_log/usage.rst b/docs/root/configuration/observability/access_log/usage.rst
@@ -682,7 +682,11 @@ UDP
 .. _config_access_log_format_upstream_connection_id:
 
 %UPSTREAM_CONNECTION_ID%
-  An identifier for the upstream connection.
+  An identifier for the upstream connection. It can be used to
+  cross-reference TCP access logs across multiple log sinks, or to
+  cross-reference timer-based reports for the same connection. The identifier
+  is unique with high likelihood within an execution, but can duplicate across
+  multiple instances or between restarts.
 
 .. _config_access_log_format_stream_id: