echo

Documentation

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.

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.

// 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

• func Middleware(opts ...Option) echo.MiddlewareFunc
• type Option
  • func WithServiceName(name string) Option

Examples

• Package
• Package (SpanFromContext)

Functions

func Middleware

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

Middleware returns echo middleware which will trace incoming requests.

Types

type Option

type Option func(*config)

Option represents an option that can be passed to Middleware.

func WithServiceName

func WithServiceName(name string) Option

WithServiceName sets the given service name for the system.