query

Documentation

Index

• type QueryableCreator
  • func NewQueryableCreator(logger log.Logger, proxy storepb.StoreServer, replicaLabel string) QueryableCreator
• type StoreSet
  • func NewStoreSet(logger log.Logger, reg *prometheus.Registry, storeSpecs func() []StoreSpec, ...) *StoreSet
  • func (s *StoreSet) Close()
  • func (s *StoreSet) Get() []store.Client
  • func (s *StoreSet) GetStoreStatus() []StoreStatus
  • func (s *StoreSet) Update(ctx context.Context)
• type StoreSpec
  • func NewGRPCStoreSpec(addr string) StoreSpec
• type StoreStatus
• type WarningReporter

Types

type QueryableCreator

type QueryableCreator func(deduplicate bool, maxSourceResolution time.Duration, partialResponse bool, r WarningReporter) storage.Queryable

QueryableCreator returns implementation of promql.Queryable that fetches data from the proxy store API endpoints. If deduplication is enabled, all data retrieved from it will be deduplicated along the replicaLabel by default. maxSourceResolution controls downsampling resolution that is allowed. partialResponse controls `partialResponseDisabled` option of StoreAPI and partial response behaviour of proxy.

func NewQueryableCreator

func NewQueryableCreator(logger log.Logger, proxy storepb.StoreServer, replicaLabel string) QueryableCreator

NewQueryableCreator creates QueryableCreator.

type StoreSet

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

StoreSet maintains a set of active stores. It is backed up by Store Specifications that are dynamically fetched on every Update() call.

func NewStoreSet

func NewStoreSet(
	logger log.Logger,
	reg *prometheus.Registry,
	storeSpecs func() []StoreSpec,
	dialOpts []grpc.DialOption,
) *StoreSet

NewStoreSet returns a new set of stores from cluster peers and statically configured ones.

func (*StoreSet) Close

func (s *StoreSet) Close()

func (*StoreSet) Get

func (s *StoreSet) Get() []store.Client

Get returns a list of all active stores.

func (*StoreSet) GetStoreStatus

func (s *StoreSet) GetStoreStatus() []StoreStatus

func (*StoreSet) Update

func (s *StoreSet) Update(ctx context.Context)

Update updates the store set. It fetches current list of store specs from function and updates the fresh metadata from all stores.

type StoreSpec

type StoreSpec interface {
	// Addr returns StoreAPI Address for the store spec. It is used as ID for store.
	Addr() string
	// Metadata returns current labels, store type and min, max ranges for store.
	// It can change for every call for this method.
	// If metadata call fails we assume that store is no longer accessible and we should not use it.
	// NOTE: It is implementation responsibility to retry until context timeout, but a caller responsibility to manage
	// given store connection.
	Metadata(ctx context.Context, client storepb.StoreClient) (labels []storepb.Label, mint int64, maxt int64, err error)
}

func NewGRPCStoreSpec

func NewGRPCStoreSpec(addr string) StoreSpec

NewGRPCStoreSpec creates store pure gRPC spec. It uses Info gRPC call to get Metadata.

type StoreStatus

type StoreStatus struct {
	Name      string
	LastCheck time.Time
	LastError error
	Labels    []storepb.Label
	StoreType component.StoreAPI
	MinTime   int64
	MaxTime   int64
}

type WarningReporter

type WarningReporter func(error)

WarningReporter allows to report warnings to frontend layer.

Warning can include partial errors `partialResponse` is enabled. It occurs when only part of the results are ready and another is not available because of the failure. It is required to be thread-safe.