Why Go
- Case Studies
  
  Common problems companies solve with Go
- Use Cases
  
  Stories about how and why companies use Go
- Security Policy
  
  How Go can help keep you secure by default
Learn
Docs
- Effective Go
  
  Tips for writing clear, performant, and idiomatic Go code
- Go User Manual
  
  A complete introduction to building software with Go
- Standard library
  
  Reference documentation for Go's standard library
- Release Notes
  
  Learn what's new in each Go release
Packages
Community
- Recorded Talks
  
  Videos from prior events
- Meetups
  
  Meet other local Go developers
- Conferences
  
  Learn and network with Go developers from around the world
- Go blog
  
  The Go project's official blog.
- Go project
  
  Get help and stay informed from Go
- Get connected

adaptive_placement

package

Go to main page

Versions in this module

v1

v1.12.0

Jan 15, 2025

v1.11.1

Jan 9, 2025

v1.11.0

Dec 19, 2024

v1.10.1

Jan 14, 2025

v1.10.0

Nov 9, 2024

Changes in this version

+ var ErrLoadBalancing = errors.New("invalid load balancing option")

+ var ErrRulesNotFound = errors.New("placement rules not found")

+ var ErrStatsNotFound = errors.New("placement stats not found")

+ type AdaptivePlacement struct

+ func NewAdaptivePlacement(limits Limits) *AdaptivePlacement

+ func (a *AdaptivePlacement) Policy(k placement.Key) placement.Policy

+ func (a *AdaptivePlacement) Update(rules *adaptive_placementpb.PlacementRules)

+ type Agent struct

+ func NewAgent(logger log.Logger, reg prometheus.Registerer, config Config, limits Limits, ...) *Agent

+ func (a *Agent) Placement() *AdaptivePlacement

+ func (a *Agent) Service() services.Service

+ type BucketStore struct

+ func NewStore(bucket objstore.Bucket) *BucketStore

+ func (s *BucketStore) LoadRules(ctx context.Context) (*adaptive_placementpb.PlacementRules, error)

+ func (s *BucketStore) LoadStats(ctx context.Context) (*adaptive_placementpb.DistributionStats, error)

+ func (s *BucketStore) StoreRules(ctx context.Context, rules *adaptive_placementpb.PlacementRules) error

+ func (s *BucketStore) StoreStats(ctx context.Context, stats *adaptive_placementpb.DistributionStats) error

+ type Config struct

+ ExportShardLimitMetrics bool

+ ExportShardUsageBreakdownMetrics bool

+ ExportShardUsageMetrics bool

+ PlacementRetentionPeriod time.Duration

+ PlacementUpdateInterval time.Duration

+ StatsAggregationWindow time.Duration

+ StatsConfidencePeriod time.Duration

+ StatsRetentionPeriod time.Duration

+ func DefaultConfig() Config

+ func (c *Config) RegisterFlags(f *flag.FlagSet)

+ func (c *Config) RegisterFlagsWithPrefix(prefix string, f *flag.FlagSet)

+ type DistributionStats struct

+ func NewDistributionStats(window time.Duration) *DistributionStats

+ func (d *DistributionStats) Build() *adaptive_placementpb.DistributionStats

+ func (d *DistributionStats) Expire(before time.Time)

+ func (d *DistributionStats) RecordStats(samples iter.Iterator[Sample])

+ type EmptyStore struct

+ func NewEmptyStore() *EmptyStore

+ func (e *EmptyStore) LoadRules(context.Context) (*adaptive_placementpb.PlacementRules, error)

+ func (e *EmptyStore) LoadStats(context.Context) (*adaptive_placementpb.DistributionStats, error)

+ func (e *EmptyStore) StoreRules(context.Context, *adaptive_placementpb.PlacementRules) error

+ func (e *EmptyStore) StoreStats(context.Context, *adaptive_placementpb.DistributionStats) error

+ type Limits interface

+ PlacementLimits func(tenant string) PlacementLimits

+ type LoadBalancing string

+ const DynamicLoadBalancing

+ const FingerprintLoadBalancing

+ const RoundRobinLoadBalancing

+ func (lb *LoadBalancing) Set(text string) error

+ func (lb *LoadBalancing) String() string

+ type Manager struct

+ func NewManager(logger log.Logger, reg prometheus.Registerer, config Config, limits Limits, ...) *Manager

+ func (m *Manager) RecordStats(samples iter.Iterator[Sample])

+ func (m *Manager) Service() services.Service

+ func (m *Manager) Start()

+ func (m *Manager) Stop()

+ type PlacementLimits struct

+ BurstWindow time.Duration

+ DecayWindow time.Duration

+ DefaultDatasetShards uint64

+ LoadBalancing LoadBalancing

+ MaxDatasetShards uint64

+ MinDatasetShards uint64

+ TenantShards uint64

+ UnitSizeBytes uint64

+ func (o *PlacementLimits) RegisterFlags(f *flag.FlagSet)

+ func (o *PlacementLimits) RegisterFlagsWithPrefix(prefix string, f *flag.FlagSet)

+ type Ruler struct

+ func NewRuler(limits Limits) *Ruler

+ func (r *Ruler) BuildRules(stats *adaptive_placementpb.DistributionStats) *adaptive_placementpb.PlacementRules

+ func (r *Ruler) Expire(before time.Time)

+ func (r *Ruler) Load(rules *adaptive_placementpb.PlacementRules)

+ type Sample struct

+ DatasetName string

+ ShardID uint32

+ ShardOwner string

+ Size uint64

+ TenantID string

+ type Store interface

+ type StoreReader interface

+ LoadRules func(context.Context) (*adaptive_placementpb.PlacementRules, error)

+ LoadStats func(context.Context) (*adaptive_placementpb.DistributionStats, error)

+ type StoreWriter interface

+ StoreRules func(context.Context, *adaptive_placementpb.PlacementRules) error

+ StoreStats func(context.Context, *adaptive_placementpb.DistributionStats) error