monitoring

Overview ¶

Package monitoring provides pluggable metrics collection for BubblyUI composables.

The monitoring system is entirely optional and has zero overhead when disabled. By default, a NoOp implementation is used which performs no operations.

This package is an alias for github.com/newbpydev/bubblyui/pkg/bubbly/monitoring, providing a cleaner import path for users.

Features ¶

• Composable creation count and duration tracking
• Provide/Inject tree depth monitoring
• Memory allocation tracking per composable
• Cache hit/miss rates for performance optimization
• Prometheus metrics integration
• pprof profiling endpoints

Example ¶

import "github.com/newbpydev/bubblyui/monitoring"

func main() {
    // Enable Prometheus metrics
    metrics := monitoring.NewPrometheusMetrics(prometheus.DefaultRegisterer)
    monitoring.SetGlobalMetrics(metrics)

    // Enable pprof profiling on port 6060
    monitoring.EnableProfiling(":6060")
    defer monitoring.StopProfiling()
}

Zero Overhead ¶

When monitoring is disabled (default), there is zero overhead:

• No allocations
• No mutex contention
• No function calls (inlined NoOp methods)
• No performance impact