.. _envoy_v3_api_file_envoy/data/tap/v3/wrapper.proto: Tap data wrappers ================= This documentation is for the Envoy v3 API. As of Envoy v1.18 the v2 API has been removed and is no longer supported. If you are upgrading from v2 API config you may wish to view the v2 API documentation: :ref:`data/tap/v2alpha/wrapper.proto ` .. _envoy_v3_api_msg_data.tap.v3.TraceWrapper: data.tap.v3.TraceWrapper ------------------------ :repo:`[data.tap.v3.TraceWrapper proto] ` Wrapper for all fully buffered and streamed tap traces that Envoy emits. This is required for sending traces over gRPC APIs or more easily persisting binary messages to files. .. code-block:: json { "http_buffered_trace": "{...}", "http_streamed_trace_segment": "{...}", "socket_buffered_trace": "{...}", "socket_streamed_trace_segment": "{...}" } .. _envoy_v3_api_field_data.tap.v3.TraceWrapper.http_buffered_trace: http_buffered_trace (:ref:`data.tap.v3.HttpBufferedTrace `) An HTTP buffered tap trace. Precisely one of :ref:`http_buffered_trace `, :ref:`http_streamed_trace_segment `, :ref:`socket_buffered_trace `, :ref:`socket_streamed_trace_segment ` must be set. .. _envoy_v3_api_field_data.tap.v3.TraceWrapper.http_streamed_trace_segment: http_streamed_trace_segment (:ref:`data.tap.v3.HttpStreamedTraceSegment `) An HTTP streamed tap trace segment. Precisely one of :ref:`http_buffered_trace `, :ref:`http_streamed_trace_segment `, :ref:`socket_buffered_trace `, :ref:`socket_streamed_trace_segment ` must be set. .. _envoy_v3_api_field_data.tap.v3.TraceWrapper.socket_buffered_trace: socket_buffered_trace (:ref:`data.tap.v3.SocketBufferedTrace `) A socket buffered tap trace. Precisely one of :ref:`http_buffered_trace `, :ref:`http_streamed_trace_segment `, :ref:`socket_buffered_trace `, :ref:`socket_streamed_trace_segment ` must be set. .. _envoy_v3_api_field_data.tap.v3.TraceWrapper.socket_streamed_trace_segment: socket_streamed_trace_segment (:ref:`data.tap.v3.SocketStreamedTraceSegment `) A socket streamed tap trace segment. Precisely one of :ref:`http_buffered_trace `, :ref:`http_streamed_trace_segment `, :ref:`socket_buffered_trace `, :ref:`socket_streamed_trace_segment ` must be set.