Back to godoc.org

Package echo

v1.27.1
Latest Go to latest

The highest tagged major version is v1.

Published: Oct 15, 2020 | Licenses: Apache-2.0 , BSD-3-Clause , Apache-2.0 | Module: gopkg.in/DataDog/dd-trace-go.v1

Overview

Package echo provides functions to trace the labstack/echo package (https://github.com/labstack/echo).

Example

To start tracing requests, add the trace middleware to your echo router.

Code:

r := echo.New()

// Use the tracer middleware with your desired service name.
r.Use(Middleware(WithServiceName("my-web-app")))

// Set up an endpoint.
r.GET("/hello", func(c echo.Context) error {
	return c.String(200, "hello world!")
})

// ...and listen for incoming requests
r.Start(":8080")
Example (SpanFromContext)

An example illustrating tracing a child operation within the main context.

Code:

// Create a new instance of echo
r := echo.New()

// Use the tracer middleware with your desired service name.
r.Use(Middleware(WithServiceName("image-encoder")))

// Set up some endpoints.
r.GET("/image/encode", func(c echo.Context) error {
	// create a child span to track an operation
	span, _ := tracer.StartSpanFromContext(c.Request().Context(), "image.encode")

	// encode an image ...

	// finish the child span
	span.Finish()

	return c.String(200, "ok!")
})

Index

Examples

func Middleware

func Middleware(opts ...Option) echo.MiddlewareFunc

Middleware returns echo middleware which will trace incoming requests.

type Option

type Option func(*config)

Option represents an option that can be passed to Middleware.

func WithAnalytics

func WithAnalytics(on bool) Option

WithAnalytics enables Trace Analytics for all started spans.

func WithAnalyticsRate

func WithAnalyticsRate(rate float64) Option

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

func WithServiceName

func WithServiceName(name string) Option

WithServiceName sets the given service name for the system.

Package Files

Documentation was rendered with GOOS=linux and GOARCH=amd64.

Jump to identifier

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to identifier