httptracer

Documentation

Overview

Package httptracer implements http tracing functionality

Index

• type HTTPTracer
• type RoundTripTrace
  • func GetNewTraceTransport(trace HTTPTracer, transport http.RoundTripper) RoundTripTrace
  • func (t RoundTripTrace) RoundTrip(req *http.Request) (res *http.Response, err error)

Types

type HTTPTracer

type HTTPTracer interface {
	Request(req *http.Request) error
	Response(res *http.Response) error
}

HTTPTracer provides callback hook mechanism for HTTP transport.

type RoundTripTrace

type RoundTripTrace struct {
	Trace     HTTPTracer        // User provides callback methods
	Transport http.RoundTripper // HTTP transport that needs to be intercepted
}

RoundTripTrace interposes HTTP transport requests and respsonses using HTTPTracer hooks

func GetNewTraceTransport

func GetNewTraceTransport(trace HTTPTracer, transport http.RoundTripper) RoundTripTrace

GetNewTraceTransport returns a traceable transport

Takes first argument a custom tracer which implements Response, Request() conforming to HTTPTracer interface. Another argument can be a default transport or a custom http.RoundTripper implementation

func (RoundTripTrace) RoundTrip

func (t RoundTripTrace) RoundTrip(req *http.Request) (res *http.Response, err error)

RoundTrip executes user provided request and response hooks for each HTTP call.