http

Documentation

Overview

Package http provides functions to trace the net/http package (https://golang.org/pkg/net/http).

Example

package main

import (
	"net/http"

	httptrace "gopkg.in/DataDog/dd-trace-go.v1/contrib/net/http"
)

func main() {
	mux := httptrace.NewServeMux()
	mux.HandleFunc("/", func(w http.ResponseWriter, r *http.Request) {
		w.Write([]byte("Hello World!\n"))
	})
	http.ListenAndServe(":8080", mux)
}

Example (WithServiceName)

package main

import (
	"net/http"

	httptrace "gopkg.in/DataDog/dd-trace-go.v1/contrib/net/http"
)

func main() {
	mux := httptrace.NewServeMux(httptrace.WithServiceName("my-service"))
	mux.HandleFunc("/", func(w http.ResponseWriter, r *http.Request) {
		w.Write([]byte("Hello World!\n"))
	})
	http.ListenAndServe(":8080", mux)
}

Index

• func WrapClient(c *http.Client, opts ...RoundTripperOption) *http.Client
• func WrapHandler(h http.Handler, service, resource string) http.Handler
• func WrapRoundTripper(rt http.RoundTripper, opts ...RoundTripperOption) http.RoundTripper
• type MuxOption
  • func WithServiceName(name string) MuxOption
• type RoundTripperAfterFunc
• type RoundTripperBeforeFunc
• type RoundTripperOption
  • func WithAfter(f RoundTripperAfterFunc) RoundTripperOption
  • func WithBefore(f RoundTripperBeforeFunc) RoundTripperOption
• type ServeMux
  • func NewServeMux(opts ...MuxOption) *ServeMux
  • func (mux *ServeMux) ServeHTTP(w http.ResponseWriter, r *http.Request)

Examples

• Package
• Package (WithServiceName)

Functions

func WrapClient

func WrapClient(c *http.Client, opts ...RoundTripperOption) *http.Client

WrapClient modifies the given client's transport to augment it with tracing and returns it.

func WrapHandler

func WrapHandler(h http.Handler, service, resource string) http.Handler

WrapHandler wraps an http.Handler with tracing using the given service and resource.

func WrapRoundTripper

func WrapRoundTripper(rt http.RoundTripper, opts ...RoundTripperOption) http.RoundTripper

WrapRoundTripper returns a new RoundTripper which traces all requests sent over the transport.

Types

type MuxOption

type MuxOption func(*muxConfig)

MuxOption represents an option that can be passed to NewServeMux.

func WithServiceName

func WithServiceName(name string) MuxOption

WithServiceName sets the given service name for the returned ServeMux.

type RoundTripperAfterFunc

type RoundTripperAfterFunc func(*http.Response, ddtrace.Span)

A RoundTripperAfterFunc can be used to modify a span after an http RoundTrip is made. It is possible for the http Response to be nil.

type RoundTripperBeforeFunc

type RoundTripperBeforeFunc func(*http.Request, ddtrace.Span)

A RoundTripperBeforeFunc can be used to modify a span before an http RoundTrip is made.

type RoundTripperOption

type RoundTripperOption func(*roundTripperConfig)

A RoundTripperOption represents an option that can be passed to WrapRoundTripper.

func WithAfter

func WithAfter(f RoundTripperAfterFunc) RoundTripperOption

WithAfter adds a RoundTripperAfterFunc to the RoundTripper config.

func WithBefore

func WithBefore(f RoundTripperBeforeFunc) RoundTripperOption

WithBefore adds a RoundTripperBeforeFunc to the RoundTripper config.

type ServeMux

type ServeMux struct {
	*http.ServeMux
	// contains filtered or unexported fields
}

ServeMux is an HTTP request multiplexer that traces all the incoming requests.

func NewServeMux

func NewServeMux(opts ...MuxOption) *ServeMux

NewServeMux allocates and returns an http.ServeMux augmented with the global tracer.

func (*ServeMux) ServeHTTP

func (mux *ServeMux) ServeHTTP(w http.ResponseWriter, r *http.Request)

ServeHTTP dispatches the request to the handler whose pattern most closely matches the request URL. We only need to rewrite this function to be able to trace all the incoming requests to the underlying multiplexer