forked from DataDog/dd-trace-go
/
option.go
90 lines (78 loc) · 2.56 KB
/
option.go
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
// Unless explicitly stated otherwise all files in this repository are licensed
// under the Apache License Version 2.0.
// This product includes software developed at Datadog (https://www.datadoghq.com/).
// Copyright 2016-2020 Datadog, Inc.
package mux
import (
"math"
"net/http"
"gopkg.in/DataDog/dd-trace-go.v1/ddtrace"
"gopkg.in/DataDog/dd-trace-go.v1/ddtrace/tracer"
"gopkg.in/DataDog/dd-trace-go.v1/internal/globalconfig"
)
type routerConfig struct {
serviceName string
spanOpts []ddtrace.StartSpanOption // additional span options to be applied
finishOpts []ddtrace.FinishOption // span finish options to be applied
analyticsRate float64
resourceNamer func(*Router, *http.Request) string
}
// RouterOption represents an option that can be passed to NewRouter.
type RouterOption func(*routerConfig)
func defaults(cfg *routerConfig) {
cfg.analyticsRate = globalconfig.AnalyticsRate()
cfg.serviceName = "mux.router"
if svc := globalconfig.ServiceName(); svc != "" {
cfg.serviceName = svc
}
cfg.resourceNamer = defaultResourceNamer
}
// WithServiceName sets the given service name for the router.
func WithServiceName(name string) RouterOption {
return func(cfg *routerConfig) {
cfg.serviceName = name
}
}
// WithSpanOptions applies the given set of options to the spans started
// by the router.
func WithSpanOptions(opts ...ddtrace.StartSpanOption) RouterOption {
return func(cfg *routerConfig) {
cfg.spanOpts = opts
}
}
// 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 NoDebugStack() RouterOption {
return func(cfg *routerConfig) {
cfg.finishOpts = append(cfg.finishOpts, tracer.NoDebugStack())
}
}
// WithAnalytics enables Trace Analytics for all started spans.
func WithAnalytics(on bool) RouterOption {
return func(cfg *routerConfig) {
if on {
cfg.analyticsRate = 1.0
} else {
cfg.analyticsRate = math.NaN()
}
}
}
// WithAnalyticsRate sets the sampling rate for Trace Analytics events
// correlated to started spans.
func WithAnalyticsRate(rate float64) RouterOption {
return func(cfg *routerConfig) {
if rate >= 0.0 && rate <= 1.0 {
cfg.analyticsRate = rate
} else {
cfg.analyticsRate = math.NaN()
}
}
}
// WithResourceNamer specifies a quantizing function which will be used to
// obtain the resource name for a given request.
func WithResourceNamer(namer func(router *Router, req *http.Request) string) RouterOption {
return func(cfg *routerConfig) {
cfg.resourceNamer = namer
}
}