telemetry

func CaptureError ¶

func CaptureError(ctx context.Context, err error)

CaptureError logs an error that occured in a request.

func Fatal ¶

func Fatal(ctx context.Context, err error)

Fatal wraps CaptureError with log.Fatal.

func Middleware ¶

func Middleware(name string) func(http.Handler) http.Handler

Middleware returns a middleware that instruments requests with telemetry.

func Open ¶

func Open(driver, dsn string) (*sqlx.DB, error)

Open creates a new instrumented *sqlx.DB without pinging. It wraps otelsql.Open and sqlx.NewDb for full compatibility.

func Start ¶

func Start(ctx context.Context, name string) (context.Context, trace.Span)

Start is a wrapper to tracer.Start and expvar.NewInt.

Calling the function adds a span to the current context. The name should be a symbol reference for the caller. For best results, combine the package, symbol and function into a name like `user.service.Login`.

func StartAuto ¶

func StartAuto(ctx context.Context, symbol any) (context.Context, trace.Span)

StartAuto tries to fill the span name from the symbol.

It's intended to pass a function, or a type. The package name, type name, and function name are combined with `.` to delimit them. See tests under pkg/reflect for more information.

StartAuto uses reflection and may not work correctly under various conditions. If performance or build restrictions are impacting use, use `Start`.

func StartRequest ¶

func StartRequest(r *http.Request, name string) (*http.Request, trace.Span)

StartRequest is an utility to take the http.Request and update it's context.