package io.linkerd.proxy.tap

Get desktop application:
View/edit binary Protocol Buffers messages

A service exposed by proxy instances to setup

• rpc Observe (ObserveRequest, stream TapEvent)

  tap.proto:14

  message ObserveRequest

  tap.proto:17

  • uint32 limit = 1

    Limits the number of event keys that will be returned by this tap.

  • optional ObserveRequest.Match match = 2

    Encodes request-matching logic.

  • optional ObserveRequest.Extract extract = 3

    Conditionally extracts components from requests and responses to include in tap events

  message TapEvent

  tap.proto:109

  • optional net.TcpAddress source = 1

  • optional TapEvent.EndpointMeta source_meta = 5

  • optional TapEvent.RouteMeta route_meta = 7

  • optional net.TcpAddress destination = 2

  • optional TapEvent.EndpointMeta destination_meta = 4

  • TapEvent.ProxyDirection proxy_direction = 6

  • oneof event

    • TapEvent.Http http = 3

Used in: TapEvent.Http.ResponseEnd

• oneof end

  • uint32 grpc_status_code = 1

  • uint32 reset_error_code = 2

Used in: ObserveRequest

• oneof extract

  • Extract.Http http = 1

Used in: Extract

• oneof extract

  • Http.Headers headers = 1

Used in: Http

(message has no fields)

Used in: ObserveRequest, Match.Seq

• oneof match

  • Match.Seq all = 1

  • Match.Seq any = 2

  • Match not = 3

  • Match.Tcp source = 4

  • Match.Tcp destination = 5

  • Match.Http http = 6

  • Match.Label destination_label = 7

  • Match.Label route_label = 8

Used in: Match

• oneof match

  • http_types.Scheme scheme = 1

  • http_types.HttpMethod method = 3

  • Http.StringMatch authority = 2

  • Http.StringMatch path = 4

    TODO Header header = 4;

Used in: Http

• oneof match

  • string exact = 1

  • string prefix = 2

Used in: Match

• string key = 1

• string value = 2

Used in: Match

• repeated Match matches = 1

Used in: Match

• oneof match

  • Tcp.Netmask netmask = 1

  • Tcp.PortRange ports = 3

Used in: Tcp

• optional net.IPAddress ip = 1

• uint32 mask = 2

If either a minimum or maximum is not specified, the range is considered to be over a discrete value.

Used in: Tcp

• uint32 min = 1

  Minimum matching port value (inclusive), if specified.

• uint32 max = 2

  Maximum matching port value (inclusive), if specified.

Used in: TapEvent

• map<string, string> labels = 1

Used in: TapEvent

• oneof event

  • Http.RequestInit request_init = 1

  • Http.ResponseInit response_init = 2

  • Http.ResponseEnd response_end = 3

Used in: Http

• optional StreamId id = 1

• optional http_types.HttpMethod method = 2

• optional http_types.Scheme scheme = 3

• string authority = 4

• string path = 5

• optional http_types.Headers headers = 6

Used in: Http

• optional StreamId id = 1

• optional google.protobuf.Duration since_request_init = 2

• optional google.protobuf.Duration since_response_init = 3

• uint64 response_bytes = 4

• optional Eos eos = 5

• optional http_types.Headers trailers = 6

Used in: Http

• optional StreamId id = 1

• optional google.protobuf.Duration since_request_init = 2

• uint32 http_status = 3

• optional http_types.Headers headers = 4

Used in: RequestInit, ResponseEnd, ResponseInit

• uint32 base = 1

  A randomized base (stable across a process's runtime)

• uint64 stream = 2

  A stream id unique within the lifetime of `base`.

Used in: TapEvent

• UNKNOWN = 0

• INBOUND = 1

• OUTBOUND = 2

Used in: TapEvent

• map<string, string> labels = 1