Tap/Transport tap Enhance buffer trace to send tapped messages based on configured size (#39540)

Commit Message: Enhance transport tap buffer trace to send tapped
messages based on configured size
Additional Description:
For buffer tracing, tapped messages are sent only on connection closure
by default. This is suitable for HTTP/1 but not for HTTP/2.
Tapped messages are sent based on the configured size is needed for
HTTP/2 and later.

Risk Level: Low
Testing: Done the test in local.
Docs Changes:
Release Notes:
Platform Specific Features:
[Optional Runtime guard:]
[Optional Fixes #Issue]
[Optional Fixes commit #PR or SHA]
[Optional Deprecated:]
[Optional [API
Considerations](https://github.com/envoyproxy/envoy/blob/main/api/review_checklist.md):]

---------

Signed-off-by: fchen7 <[email protected]>

Mirrored from https://github.com/envoyproxy/envoy @ 25037e74fcd73c65991aac8c3a19efc7db7ede86

Author: update-envoy[bot]

envoy/config/tap/v3/common.proto

@@ -154,6 +154,7 @@ message HttpGenericBodyMatch {
 }
 
 // Tap output configuration.
+// [#next-free-field: 6]
 message OutputConfig {
   option (udpa.annotations.versioning).previous_message_type =
       "envoy.service.tap.v2alpha.OutputConfig";
@@ -181,6 +182,12 @@ message OutputConfig {
   // match can be determined. See the HTTP tap filter :ref:`streaming
   // <config_http_filters_tap_streaming>` documentation for more information.
   bool streaming = 4;
+
+  // Tapped messages will be sent on each read/write event for streamed tapping by default.
+  // But this behavior could be controlled by setting this field.
+  // If set then the tapped messages will be send once the threshold is reached.
+  // This could be used to avoid high frequent sending.
+  google.protobuf.UInt32Value min_streamed_sent_bytes = 5;
 }
 
 // Tap output sink configuration.

envoy/data/tap/v3/transport.proto

@@ -96,6 +96,11 @@ message SocketBufferedTrace {
   bool write_truncated = 5;
 }
 
+// A message for the sequence of observed events
+message SocketEvents {
+  repeated SocketEvent events = 1;
+}
+
 // A streamed socket trace segment. Multiple segments make up a full trace.
 message SocketStreamedTraceSegment {
   option (udpa.annotations.versioning).previous_message_type =
@@ -111,5 +116,8 @@ message SocketStreamedTraceSegment {
 
     // Socket event.
     SocketEvent event = 3;
+
+    // Sequence of observed events.
+    SocketEvents events = 4;
   }
 }

envoy/extensions/transport_sockets/tap/v3/tap.proto

@@ -40,4 +40,7 @@ message SocketTapConfig {
   // Indicates to whether output the connection information per event
   // This is only applicable if the streamed trace is enabled
   bool set_connection_per_event = 1;
+
+  // The contents of the transport tap's statistics prefix.
+  string stats_prefix = 2;
 }