apmgorilla

func Instrument ¶ added in v1.4.0

func Instrument(r *mux.Router, o ...Option)

Instrument instruments the mux.Router so that requests are traced.

Instrument installs middleware into r, and alsos overrides r.NotFoundHandler and r.MethodNotAllowedHandler so that they are traced. If you modify either of those fields, you must do so before calling Instrument.

func Middleware ¶

func Middleware(o ...Option) mux.MiddlewareFunc

Middleware returns a new gorilla/mux middleware handler for tracing requests and reporting errors.

This middleware will recover and report panics, so it can be used instead of the gorilla/middleware.RecoveryHandler middleware.

Middleware does not get invoked when a route cannot be matched, or when an unsupported method is used. To report transactions in these cases, you should use the Instrument function, or set the router's NotFoundHandler and MethodNotAllowedHandler fields using the Wrap functions in this package.

By default, the middleware will use apm.DefaultTracer. Use WithTracer to specify an alternative tracer.

func WrapMethodNotAllowedHandler ¶ added in v1.4.0

func WrapMethodNotAllowedHandler(h http.Handler, m mux.MiddlewareFunc) http.Handler

WrapMethodNotAllowedHandler wraps h with m. If h is nil, then a default handler will be used that returns status code 405.

func WrapNotFoundHandler ¶ added in v1.4.0

func WrapNotFoundHandler(h http.Handler, m mux.MiddlewareFunc) http.Handler

WrapNotFoundHandler wraps h with m. If h is nil, then http.NotFoundHandler() will be used.