accesslogv3connect

Documentation

Index

• Constants
• func NewAccessLogServiceHandler(svc AccessLogServiceHandler, opts ...connect.HandlerOption) (string, http.Handler)
• type AccessLogServiceClient
  • func NewAccessLogServiceClient(httpClient connect.HTTPClient, baseURL string, opts ...connect.ClientOption) AccessLogServiceClient
• type AccessLogServiceHandler
• type UnimplementedAccessLogServiceHandler
  • func (UnimplementedAccessLogServiceHandler) StreamAccessLogs(context.Context, *connect.ClientStream[v3.StreamAccessLogsMessage]) (*connect.Response[v3.StreamAccessLogsResponse], error)

Constants

const (
	// AccessLogServiceName is the fully-qualified name of the AccessLogService service.
	AccessLogServiceName = "envoy.service.accesslog.v3.AccessLogService"
)

const (
	// AccessLogServiceStreamAccessLogsProcedure is the fully-qualified name of the AccessLogService's
	// StreamAccessLogs RPC.
	AccessLogServiceStreamAccessLogsProcedure = "/envoy.service.accesslog.v3.AccessLogService/StreamAccessLogs"
)

These constants are the fully-qualified names of the RPCs defined in this package. They're exposed at runtime as Spec.Procedure and as the final two segments of the HTTP route.

Note that these are different from the fully-qualified method names used by google.golang.org/protobuf/reflect/protoreflect. To convert from these constants to reflection-formatted method names, remove the leading slash and convert the remaining slash to a period.

Functions

func NewAccessLogServiceHandler

func NewAccessLogServiceHandler(svc AccessLogServiceHandler, opts ...connect.HandlerOption) (string, http.Handler)

NewAccessLogServiceHandler builds an HTTP handler from the service implementation. It returns the path on which to mount the handler and the handler itself.

By default, handlers support the Connect, gRPC, and gRPC-Web protocols with the binary Protobuf and JSON codecs. They also support gzip compression.

Types

type AccessLogServiceClient

type AccessLogServiceClient interface {
	// Envoy will connect and send StreamAccessLogsMessage messages forever. It does not expect any
	// response to be sent as nothing would be done in the case of failure. The server should
	// disconnect if it expects Envoy to reconnect. In the future we may decide to add a different
	// API for "critical" access logs in which Envoy will buffer access logs for some period of time
	// until it gets an ACK so it could then retry. This API is designed for high throughput with the
	// expectation that it might be lossy.
	StreamAccessLogs(context.Context) *connect.ClientStreamForClient[v3.StreamAccessLogsMessage, v3.StreamAccessLogsResponse]
}

AccessLogServiceClient is a client for the envoy.service.accesslog.v3.AccessLogService service.

func NewAccessLogServiceClient

func NewAccessLogServiceClient(httpClient connect.HTTPClient, baseURL string, opts ...connect.ClientOption) AccessLogServiceClient

NewAccessLogServiceClient constructs a client for the envoy.service.accesslog.v3.AccessLogService service. By default, it uses the Connect protocol with the binary Protobuf Codec, asks for gzipped responses, and sends uncompressed requests. To use the gRPC or gRPC-Web protocols, supply the connect.WithGRPC() or connect.WithGRPCWeb() options.

The URL supplied here should be the base URL for the Connect or gRPC server (for example, http://api.acme.com or https://acme.com/grpc).

type AccessLogServiceHandler

type AccessLogServiceHandler interface {
	// Envoy will connect and send StreamAccessLogsMessage messages forever. It does not expect any
	// response to be sent as nothing would be done in the case of failure. The server should
	// disconnect if it expects Envoy to reconnect. In the future we may decide to add a different
	// API for "critical" access logs in which Envoy will buffer access logs for some period of time
	// until it gets an ACK so it could then retry. This API is designed for high throughput with the
	// expectation that it might be lossy.
	StreamAccessLogs(context.Context, *connect.ClientStream[v3.StreamAccessLogsMessage]) (*connect.Response[v3.StreamAccessLogsResponse], error)
}

AccessLogServiceHandler is an implementation of the envoy.service.accesslog.v3.AccessLogService service.

type UnimplementedAccessLogServiceHandler

type UnimplementedAccessLogServiceHandler struct{}

UnimplementedAccessLogServiceHandler returns CodeUnimplemented from all methods.

func (UnimplementedAccessLogServiceHandler) StreamAccessLogs

func (UnimplementedAccessLogServiceHandler) StreamAccessLogs(context.Context, *connect.ClientStream[v3.StreamAccessLogsMessage]) (*connect.Response[v3.StreamAccessLogsResponse], error)