You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
97 lines
2.6 KiB
97 lines
2.6 KiB
6 years ago
|
syntax = "proto3";
|
||
|
|
|
||
|
|
// [#protodoc-title: Transport tap data]
|
||
|
|
// Trace format for the tap transport socket extension. This dumps plain text read/write
|
||
|
|
// sequences on a socket.
|
||
|
|
|
||
|
|
package envoy.data.tap.v3alpha;
|
||
|
|
|
||
|
|
option java_outer_classname = "TransportProto";
|
||
|
|
option java_multiple_files = true;
|
||
|
|
option java_package = "io.envoyproxy.envoy.data.tap.v3alpha";
|
||
|
|
|
||
|
|
import "envoy/api/v3alpha/core/address.proto";
|
||
|
|
import "envoy/data/tap/v3alpha/common.proto";
|
||
|
|
|
||
|
|
import "google/protobuf/timestamp.proto";
|
||
|
|
|
||
|
|
// Connection properties.
|
||
|
|
message Connection {
|
||
|
|
// Local address.
|
||
|
|
envoy.api.v3alpha.core.Address local_address = 2;
|
||
|
|
|
||
|
|
// Remote address.
|
||
|
|
envoy.api.v3alpha.core.Address remote_address = 3;
|
||
|
|
}
|
||
|
|
|
||
|
|
// Event in a socket trace.
|
||
|
|
message SocketEvent {
|
||
|
|
// Timestamp for event.
|
||
|
|
google.protobuf.Timestamp timestamp = 1;
|
||
|
|
|
||
|
|
// Data read by Envoy from the transport socket.
|
||
|
|
message Read {
|
||
|
|
// Binary data read.
|
||
|
|
Body data = 1;
|
||
|
|
|
||
|
|
// TODO(htuch): Half-close for reads.
|
||
|
|
}
|
||
|
|
|
||
|
|
// Data written by Envoy to the transport socket.
|
||
|
|
message Write {
|
||
|
|
// Binary data written.
|
||
|
|
Body data = 1;
|
||
|
|
|
||
|
|
// Stream was half closed after this write.
|
||
|
|
bool end_stream = 2;
|
||
|
|
}
|
||
|
|
|
||
|
|
// The connection was closed.
|
||
|
|
message Closed {
|
||
|
|
// TODO(mattklein123): Close event type.
|
||
|
|
}
|
||
|
|
|
||
|
|
// Read or write with content as bytes string.
|
||
|
|
oneof event_selector {
|
||
|
|
Read read = 2;
|
||
|
|
Write write = 3;
|
||
|
|
Closed closed = 4;
|
||
|
|
}
|
||
|
|
}
|
||
|
|
|
||
|
|
// Sequence of read/write events that constitute a buffered trace on a socket.
|
||
|
|
message SocketBufferedTrace {
|
||
|
|
// Trace ID unique to the originating Envoy only. Trace IDs can repeat and should not be used
|
||
|
|
// for long term stable uniqueness. Matches connection IDs used in Envoy logs.
|
||
|
|
uint64 trace_id = 1;
|
||
|
|
|
||
|
|
// Connection properties.
|
||
|
|
Connection connection = 2;
|
||
|
|
|
||
|
|
// Sequence of observed events.
|
||
|
|
repeated SocketEvent events = 3;
|
||
|
|
|
||
|
|
// Set to true if read events were truncated due to the :ref:`max_buffered_rx_bytes
|
||
|
|
// <envoy_api_field_service.tap.v3alpha.OutputConfig.max_buffered_rx_bytes>` setting.
|
||
|
|
bool read_truncated = 4;
|
||
|
|
|
||
|
|
// Set to true if write events were truncated due to the :ref:`max_buffered_tx_bytes
|
||
|
|
// <envoy_api_field_service.tap.v3alpha.OutputConfig.max_buffered_tx_bytes>` setting.
|
||
|
|
bool write_truncated = 5;
|
||
|
|
}
|
||
|
|
|
||
|
|
// A streamed socket trace segment. Multiple segments make up a full trace.
|
||
|
|
message SocketStreamedTraceSegment {
|
||
|
|
// Trace ID unique to the originating Envoy only. Trace IDs can repeat and should not be used
|
||
|
|
// for long term stable uniqueness. Matches connection IDs used in Envoy logs.
|
||
|
|
uint64 trace_id = 1;
|
||
|
|
|
||
|
|
oneof message_piece {
|
||
|
|
// Connection properties.
|
||
|
|
Connection connection = 2;
|
||
|
|
|
||
|
|
// Socket event.
|
||
|
|
SocketEvent event = 3;
|
||
|
|
}
|
||
|
|
}
|