errors

README

Error Handling (sentry)

• Each microservice need to expose "/health" and return with http 200, this is important for the load balancing of the API gateway
• Unhandled exception handling ("in the wild")
• Frontend Application
• Returning 5xx to client (can indicate operations issues)
• Depending on application logic (additional errors; cases that should not happen; security)
• Implausible responses from upstream services (e.g. after validation of result from external API)

Environment based configuration

• SENTRY_DSN
  • URL of the sentry DSN
• SENTRY_ENVIRONMENT
  • Environment of sentry reported in the dashboard
• SENTRY_RELEASE
  • Name of the release e.g. git commit or similar

Documentation

Index

• func HandleError(rp interface{}, handlerName string, w http.ResponseWriter, r *http.Request)
• func HandleRequest(handlerName string, w http.ResponseWriter, r *http.Request)
• func HandleWithCtx(ctx context.Context, handlerName string)
• func Handler() func(http.Handler) http.Handler
• func New(text string) error
• func WrapWithExtra(err error, extraInfo map[string]interface{}) error
• type PanicWrap

Functions

func HandleError

func HandleError(rp interface{}, handlerName string, w http.ResponseWriter, r *http.Request)

HandleError reports the passed error to sentry

func HandleRequest

func HandleRequest(handlerName string, w http.ResponseWriter, r *http.Request)

HandleRequest should be called with defer to recover panics in request handlers

func HandleWithCtx

func HandleWithCtx(ctx context.Context, handlerName string)

HandleWithCtx should be called with defer to recover panics in goroutines

func Handler

func Handler() func(http.Handler) http.Handler

Handler implements a panic recovering middleware

func New

func New(text string) error

New returns an error that formats as the given text.

func WrapWithExtra

func WrapWithExtra(err error, extraInfo map[string]interface{}) error

WrapWithExtra adds extra data to an error before reporting to Sentry

Types

type PanicWrap

type PanicWrap struct {
	// contains filtered or unexported fields
}

PanicWrap wraps a panic for HandleRequest