Migration: v1 → v2

Breaking Changes

v1	v2
monigo.TraceFunction(fn)	monigo.TraceFunction(ctx, fn)
monigo.TraceFunctionWithArgs(fn, args...)	monigo.TraceFunctionWithArgs(ctx, fn, args...)
monigo.TraceFunctionWithReturn(fn, args...)	monigo.TraceFunctionWithReturn(ctx, fn, args...)
monigo.TraceFunctionWithReturns(fn, args...)	monigo.TraceFunctionWithReturns(ctx, fn, args...)
monigo.GetRuningPort()	monigo.GetRunningPort()
api.ViewFunctionMaetrtics	api.ViewFunctionMetrics
Build() silent on errors	Build() panics on invalid config
API accepts any HTTP method	API enforces GET/POST - wrong method returns 405
log.Printf logging	Structured logging via log/slog
Data purged on startup	Historical data preserved across restarts
http.DefaultServeMux used internally	Dedicated http.ServeMux per instance

Quick Migration Steps

1. Add context.Context to All Tracing Calls

All TraceFunction* methods now require context.Context as the first argument:

monigo.TraceFunction(myFunc)
monigo.TraceFunction(ctx, myFunc)

monigo.TraceFunctionWithArgs(myFunc, arg1, arg2)
monigo.TraceFunctionWithArgs(ctx, myFunc, arg1, arg2)

monigo.TraceFunctionWithReturn(myFunc, arg1)
monigo.TraceFunctionWithReturn(ctx, myFunc, arg1)

2. Use r.Context() in HTTP Handlers

func handler(w http.ResponseWriter, r *http.Request) {
    monigo.TraceFunction(r.Context(), myFunc)
}

3. Rename Typo Fixes

monigoInstance.GetRuningPort()
monigoInstance.GetRunningPort()

4. Handle Build() Panics

Build() now panics if ServiceName is not set or config is invalid (bad port, invalid storage type). Ensure your config is valid:

monigoInstance := monigo.NewBuilder().
    WithServiceName("my-service").  // Required!
    Build()

5. Update Logging Configuration

Replace any log.Printf tuning with structured logging:

monigoInstance := monigo.NewBuilder().
    WithServiceName("my-service").
    WithLogLevel(slog.LevelInfo).   // or slog.LevelDebug, slog.LevelWarn
    Build()

6. Add Graceful Shutdown

v2 handles SIGINT/SIGTERM automatically when using Start(). For manual control:

if err := monigoInstance.Shutdown(ctx); err != nil {
    log.Printf("shutdown error: %v", err)
}

What’s New in v2.0.0

• context.Context support - All tracing functions accept context.Context.
• OpenTelemetry export - Send metrics to any OTel Collector via WithOTelEndpoint().
• Structured logging - Uses log/slog - configure via WithLogLevel() or WithLogger().
• Graceful shutdown - SIGINT/SIGTERM triggers proper cleanup; also available via Shutdown(ctx).
• Builder validation - Build() validates config at construction time.
• Decoupled storage types - Storage interface uses monigo-owned types (no tstorage leak).
• Data preservation - Historical data survives restarts (no more PurgeStorage() on startup).
• Thread-safe sampling - samplingRate uses sync/atomic to eliminate data races.
• Deep copy traces - FunctionTraceDetails() returns deep copies instead of raw map pointers.
• Prometheus fixes - Raw float64 values instead of parsing formatted strings.

See CHANGELOG.md for the full list.