debug

Documentation

Index

• func AttachSlowTickLogger(srv *golem.Server, opts SlowTickLoggerOptions)
• func AttachTickProfiler(srv *golem.Server, opts TickProfilerOptions)
• func StartPprof(addr string) error
• type SlowTickLoggerOptions
• type TickProfilerOptions

Functions

func AttachSlowTickLogger

func AttachSlowTickLogger(srv *golem.Server, opts SlowTickLoggerOptions)

AttachSlowTickLogger logs slow ticks and periodic rolling wall-time samples.

func AttachTickProfiler

func AttachTickProfiler(srv *golem.Server, opts TickProfilerOptions)

AttachTickProfiler labels pprof samples by tick and optionally wraps each tick in a runtime/trace region.

func StartPprof

func StartPprof(addr string) error

StartPprof starts a pprof debug HTTP server on addr (e.g. "127.0.0.1:6060"). All pprof handlers are mounted on a dedicated ServeMux so http.DefaultServeMux is not affected. Call from main when a debug flag is set; never import this package in production binaries.

Types

type SlowTickLoggerOptions

type SlowTickLoggerOptions struct {
	Budget        time.Duration
	Interval      time.Duration
	Window        int
	Logf          func(format string, args ...any)
	MessagePrefix string
}

SlowTickLoggerOptions configures AttachSlowTickLogger.

type TickProfilerOptions

type TickProfilerOptions struct {
	Context context.Context
	Trace   bool
}

TickProfilerOptions configures AttachTickProfiler.