// Copyright The OpenTelemetry Authors // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. // You may obtain a copy of the License at // // http://www.apache.org/licenses/LICENSE-2.0 // // Unless required by applicable law or agreed to in writing, software // distributed under the License is distributed on an "AS IS" BASIS, // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. package othttp import ( "net/http" "go.opentelemetry.io/otel/api/propagation" "go.opentelemetry.io/otel/api/trace" ) // Config represents the configuration options available for the othttp.Handler // and othttp.Transport types. type Config struct { Tracer trace.Tracer Propagators propagation.Propagators SpanStartOptions []trace.StartOption ReadEvent bool WriteEvent bool Filters []Filter SpanNameFormatter func(string, *http.Request) string } // Option Interface used for setting *optional* Config properties type Option interface { Apply(*Config) } // OptionFunc provides a convenience wrapper for simple Options // that can be represented as functions. type OptionFunc func(*Config) func (o OptionFunc) Apply(c *Config) { o(c) } // NewConfig creates a new Config struct and applies opts to it. func NewConfig(opts ...Option) *Config { c := &Config{} for _, opt := range opts { opt.Apply(c) } return c } // WithTracer configures a specific tracer. If this option // isn't specified then the global tracer is used. func WithTracer(tracer trace.Tracer) Option { return OptionFunc(func(c *Config) { c.Tracer = tracer }) } // WithPublicEndpoint configures the Handler to link the span with an incoming // span context. If this option is not provided, then the association is a child // association instead of a link. func WithPublicEndpoint() Option { return OptionFunc(func(c *Config) { c.SpanStartOptions = append(c.SpanStartOptions, trace.WithNewRoot()) }) } // WithPropagators configures specific propagators. If this // option isn't specified then // go.opentelemetry.io/otel/api/global.Propagators are used. func WithPropagators(ps propagation.Propagators) Option { return OptionFunc(func(c *Config) { c.Propagators = ps }) } // WithSpanOptions configures an additional set of // trace.StartOptions, which are applied to each new span. func WithSpanOptions(opts ...trace.StartOption) Option { return OptionFunc(func(c *Config) { c.SpanStartOptions = append(c.SpanStartOptions, opts...) }) } // WithFilter adds a filter to the list of filters used by the handler. // If any filter indicates to exclude a request then the request will not be // traced. All filters must allow a request to be traced for a Span to be created. // If no filters are provided then all requests are traced. // Filters will be invoked for each processed request, it is advised to make them // simple and fast. func WithFilter(f Filter) Option { return OptionFunc(func(c *Config) { c.Filters = append(c.Filters, f) }) } type event int // Different types of events that can be recorded, see WithMessageEvents const ( ReadEvents event = iota WriteEvents ) // WithMessageEvents configures the Handler to record the specified events // (span.AddEvent) on spans. By default only summary attributes are added at the // end of the request. // // Valid events are: // * ReadEvents: Record the number of bytes read after every http.Request.Body.Read // using the ReadBytesKey // * WriteEvents: Record the number of bytes written after every http.ResponeWriter.Write // using the WriteBytesKey func WithMessageEvents(events ...event) Option { return OptionFunc(func(c *Config) { for _, e := range events { switch e { case ReadEvents: c.ReadEvent = true case WriteEvents: c.WriteEvent = true } } }) } // WithSpanNameFormatter takes a function that will be called on every // request and the returned string will become the Span Name func WithSpanNameFormatter(f func(operation string, r *http.Request) string) Option { return OptionFunc(func(c *Config) { c.SpanNameFormatter = f }) }