metrics

package
v1.1.0 Latest Latest
Warning

This package is not in the latest version of its module.

Go to latest
Published: Jan 29, 2026 License: AGPL-3.0 Imports: 3 Imported by: 0

Documentation

Overview

Package metrics provides a decoupled interface for collecting library metrics.

By using the Provider interface, the lifecycle library remains free of external monitoring dependencies (like Prometheus or OpenTelemetry) while still providing hook points for observability.

Consumers can implement their own Provider or use the provided LogProvider for debugging.

Index

Constants

This section is empty.

Variables

This section is empty.

Functions

func SetProvider

func SetProvider(p Provider)

SetProvider sets the global metrics provider.

Types

type LogProvider

type LogProvider struct{}

LogProvider is a metrics provider that logs increments at Debug level. This is useful for development and debugging without external dependencies.

func (*LogProvider) IncHookExecuted

func (l *LogProvider) IncHookExecuted()

func (*LogProvider) IncHookPanicked

func (l *LogProvider) IncHookPanicked()

func (*LogProvider) IncProcessFailed

func (l *LogProvider) IncProcessFailed()

func (*LogProvider) IncProcessStarted

func (l *LogProvider) IncProcessStarted()

func (*LogProvider) IncSignalReceived

func (l *LogProvider) IncSignalReceived(sig string)

func (*LogProvider) IncTerminalUpgrade

func (l *LogProvider) IncTerminalUpgrade(success bool)

func (*LogProvider) ObserveHookDuration

func (l *LogProvider) ObserveHookDuration(d time.Duration)

type NoOpProvider

type NoOpProvider struct{}

NoOpProvider is a metrics provider that does nothing.

func (*NoOpProvider) IncHookExecuted

func (n *NoOpProvider) IncHookExecuted()

func (*NoOpProvider) IncHookPanicked

func (n *NoOpProvider) IncHookPanicked()

func (*NoOpProvider) IncProcessFailed

func (n *NoOpProvider) IncProcessFailed()

func (*NoOpProvider) IncProcessStarted

func (n *NoOpProvider) IncProcessStarted()

func (*NoOpProvider) IncSignalReceived

func (n *NoOpProvider) IncSignalReceived(sig string)

func (*NoOpProvider) IncTerminalUpgrade

func (n *NoOpProvider) IncTerminalUpgrade(success bool)

func (*NoOpProvider) ObserveHookDuration

func (n *NoOpProvider) ObserveHookDuration(d time.Duration)

type Provider

type Provider interface {
	IncSignalReceived(sig string)
	IncProcessStarted()
	IncProcessFailed()
	IncTerminalUpgrade(success bool)
	IncHookExecuted()
	IncHookPanicked()
	ObserveHookDuration(duration time.Duration)
}

Provider defines the interface for collecting lifecycle metrics. Implementations can bridge these calls to Prometheus, OpenTelemetry, etc.

func GetProvider

func GetProvider() Provider

GetProvider returns the current global metrics provider.

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL