tracev1connect

Documentation

Index

• Constants
• func NewTraceServiceHandler(svc TraceServiceHandler, opts ...connect.HandlerOption) (string, http.Handler)
• type TraceServiceClient
  • func NewTraceServiceClient(httpClient connect.HTTPClient, baseURL string, opts ...connect.ClientOption) TraceServiceClient
• type TraceServiceHandler
• type UnimplementedTraceServiceHandler
  • func (UnimplementedTraceServiceHandler) Config(context.Context, ...) error
  • func (UnimplementedTraceServiceHandler) Export(context.Context, ...) error

Constants

const (
	// TraceServiceConfigProcedure is the fully-qualified name of the TraceService's Config RPC.
	TraceServiceConfigProcedure = "/opencensus.proto.agent.trace.v1.TraceService/Config"
	// TraceServiceExportProcedure is the fully-qualified name of the TraceService's Export RPC.
	TraceServiceExportProcedure = "/opencensus.proto.agent.trace.v1.TraceService/Export"
)

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.

const (
	// TraceServiceName is the fully-qualified name of the TraceService service.
	TraceServiceName = "opencensus.proto.agent.trace.v1.TraceService"
)

Functions

func NewTraceServiceHandler

func NewTraceServiceHandler(svc TraceServiceHandler, opts ...connect.HandlerOption) (string, http.Handler)

NewTraceServiceHandler 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 TraceServiceClient

type TraceServiceClient interface {
	// After initialization, this RPC must be kept alive for the entire life of
	// the application. The agent pushes configs down to applications via a
	// stream.
	Config(context.Context) *connect.BidiStreamForClient[v1.CurrentLibraryConfig, v1.UpdatedLibraryConfig]
	// For performance reasons, it is recommended to keep this RPC
	// alive for the entire life of the application.
	Export(context.Context) *connect.BidiStreamForClient[v1.ExportTraceServiceRequest, v1.ExportTraceServiceResponse]
}

TraceServiceClient is a client for the opencensus.proto.agent.trace.v1.TraceService service.

func NewTraceServiceClient

func NewTraceServiceClient(httpClient connect.HTTPClient, baseURL string, opts ...connect.ClientOption) TraceServiceClient

NewTraceServiceClient constructs a client for the opencensus.proto.agent.trace.v1.TraceService 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 TraceServiceHandler

type TraceServiceHandler interface {
	// After initialization, this RPC must be kept alive for the entire life of
	// the application. The agent pushes configs down to applications via a
	// stream.
	Config(context.Context, *connect.BidiStream[v1.CurrentLibraryConfig, v1.UpdatedLibraryConfig]) error
	// For performance reasons, it is recommended to keep this RPC
	// alive for the entire life of the application.
	Export(context.Context, *connect.BidiStream[v1.ExportTraceServiceRequest, v1.ExportTraceServiceResponse]) error
}

TraceServiceHandler is an implementation of the opencensus.proto.agent.trace.v1.TraceService service.

type UnimplementedTraceServiceHandler

type UnimplementedTraceServiceHandler struct{}

UnimplementedTraceServiceHandler returns CodeUnimplemented from all methods.

func (UnimplementedTraceServiceHandler) Config

func (UnimplementedTraceServiceHandler) Config(context.Context, *connect.BidiStream[v1.CurrentLibraryConfig, v1.UpdatedLibraryConfig]) error

func (UnimplementedTraceServiceHandler) Export

func (UnimplementedTraceServiceHandler) Export(context.Context, *connect.BidiStream[v1.ExportTraceServiceRequest, v1.ExportTraceServiceResponse]) error