mux

Documentation

Overview

Package mux provides tracing functions for tracing the gorilla/mux package (https://github.com/gorilla/mux).

Example

package main

import (
	"net/http"

	muxtrace "gopkg.in/DataDog/dd-trace-go.v1/contrib/gorilla/mux"
)

func handler(w http.ResponseWriter, _ *http.Request) {
	w.Write([]byte("Hello World!\n"))
}

func main() {
	mux := muxtrace.NewRouter()
	mux.HandleFunc("/", handler)
	http.ListenAndServe(":8080", mux)
}

Example (WithServiceName)

package main

import (
	"net/http"

	muxtrace "gopkg.in/DataDog/dd-trace-go.v1/contrib/gorilla/mux"
)

func handler(w http.ResponseWriter, _ *http.Request) {
	w.Write([]byte("Hello World!\n"))
}

func main() {
	mux := muxtrace.NewRouter(muxtrace.WithServiceName("mux.route"))
	mux.HandleFunc("/", handler)
	http.ListenAndServe(":8080", mux)
}

Index

• type Router
  • func NewRouter(opts ...RouterOption) *Router
  • func WrapRouter(router *mux.Router, opts ...RouterOption) *Router
• type RouterOption
  • func NoDebugStack() RouterOption
  • func WithAnalytics(on bool) RouterOption
  • func WithAnalyticsRate(rate float64) RouterOption
  • func WithHeaderTags(headers []string) RouterOption
  • func WithIgnoreRequest(f func(*http.Request) bool) RouterOption
  • func WithQueryParams() RouterOption
  • func WithResourceNamer(namer func(router *Router, req *http.Request) string) RouterOption
  • func WithServiceName(name string) RouterOption
  • func WithSpanOptions(opts ...ddtrace.StartSpanOption) RouterOption
  • func WithStatusCheck(fn func(statusCode int) bool) RouterOption

Examples

• Package
• Package (WithServiceName)

Types

type Router

type Router = v2.Router

Router registers routes to be matched and dispatches a handler.

func NewRouter

func NewRouter(opts ...RouterOption) *Router

NewRouter returns a new router instance traced with the global tracer.

func WrapRouter

func WrapRouter(router *mux.Router, opts ...RouterOption) *Router

WrapRouter returns the given router wrapped with the tracing of the HTTP requests and responses served by the router.

type RouterOption

type RouterOption = v2.RouterOption

RouterOption represents an option that can be passed to NewRouter.

func NoDebugStack

func NoDebugStack() RouterOption

NoDebugStack prevents stack traces from being attached to spans finishing with an error. This is useful in situations where errors are frequent and performance is critical.

func WithAnalytics

func WithAnalytics(on bool) RouterOption

WithAnalytics enables Trace Analytics for all started spans.

func WithAnalyticsRate

func WithAnalyticsRate(rate float64) RouterOption

WithAnalyticsRate sets the sampling rate for Trace Analytics events correlated to started spans.

func WithHeaderTags

func WithHeaderTags(headers []string) RouterOption

WithHeaderTags enables the integration to attach HTTP request headers as span tags. Warning: Using this feature can risk exposing sensitive data such as authorization tokens to Datadog. Special headers can not be sub-selected. E.g., an entire Cookie header would be transmitted, without the ability to choose specific Cookies.

func WithIgnoreRequest

func WithIgnoreRequest(f func(*http.Request) bool) RouterOption

WithIgnoreRequest holds the function to use for determining if the incoming HTTP request tracing should be skipped.

func WithQueryParams

func WithQueryParams() RouterOption

WithQueryParams specifies that the integration should attach request query parameters as APM tags. Warning: using this feature can risk exposing sensitive data such as authorization tokens to Datadog.

func WithResourceNamer

func WithResourceNamer(namer func(router *Router, req *http.Request) string) RouterOption

WithResourceNamer specifies a quantizing function which will be used to obtain the resource name for a given request.

func WithServiceName

func WithServiceName(name string) RouterOption

WithServiceName sets the given service name for the router.

func WithSpanOptions

func WithSpanOptions(opts ...ddtrace.StartSpanOption) RouterOption

WithSpanOptions applies the given set of options to the spans started by the router.

func WithStatusCheck

func WithStatusCheck(fn func(statusCode int) bool) RouterOption

WithStatusCheck specifies a function fn which reports whether the passed statusCode should be considered an error.