adaptive

package
v0.3.1 Latest Latest
Warning

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

 Go to latest Published: Mar 9, 2026 License: Apache-2.0 Imports: 13 Imported by: 0

Documentation

Overview

Package adaptive implements a dual-engine controller that dynamically switches between io_uring and epoll based on runtime telemetry.

Index

Constants

This section is empty.

Variables

This section is empty.

Functions

This section is empty.

Types

type Engine 

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

Engine is an adaptive meta-engine that switches between io_uring and epoll.

func New 

func New(cfg resource.Config, handler stream.Handler) (*Engine, error)

New creates a new adaptive engine with io_uring as primary and epoll as secondary.

func (*Engine) ActiveEngine 

func (e *Engine) ActiveEngine() engine.Engine

ActiveEngine returns the currently active engine.

func (*Engine) Addr 

func (e *Engine) Addr() net.Addr

Addr returns the bound listener address.

func (*Engine) FreezeSwitching 

func (e *Engine) FreezeSwitching()

FreezeSwitching prevents the controller from switching engines.

func (*Engine) Listen 

func (e *Engine) Listen(ctx context.Context) error

Listen starts both sub-engines and the evaluation loop.

func (*Engine) Metrics 

func (e *Engine) Metrics() engine.EngineMetrics

Metrics aggregates metrics from both sub-engines.

func (*Engine) Shutdown 

func (e *Engine) Shutdown(ctx context.Context) error

Shutdown gracefully shuts down both sub-engines.

func (*Engine) Type 

func (e *Engine) Type() engine.EngineType

Type returns the engine type.

func (*Engine) UnfreezeSwitching 

func (e *Engine) UnfreezeSwitching()

UnfreezeSwitching allows the controller to switch engines again.

type ScoreWeights 

type ScoreWeights struct {
	Throughput float64
	ErrorRate  float64
}

ScoreWeights defines the weighting for each telemetry signal in score computation.

func DefaultWeights 

func DefaultWeights() ScoreWeights

DefaultWeights returns the default score weights.

type TelemetrySampler 

type TelemetrySampler interface {
	Sample(e engine.Engine) TelemetrySnapshot
}

TelemetrySampler produces telemetry snapshots from an engine.

type TelemetrySnapshot 

type TelemetrySnapshot struct {
	Timestamp         time.Time
	ThroughputRPS     float64
	ErrorRate         float64
	ActiveConnections int64
	CPUUtilization    float64
}

TelemetrySnapshot captures a point-in-time view of engine performance.

Source Files

View all Source files

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL
go.dev uses cookies from Google to deliver and enhance the quality of its services and to analyze traffic. Learn more.