block

package
v0.14.3 Latest Latest
Warning

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

Go to latest
Published: Apr 22, 2020 License: Apache-2.0 Imports: 13 Imported by: 0

Documentation

Overview

Package block is a generated GoMock package.

Index

Constants

This section is empty.

Variables

This section is empty.

Functions

func TakeLast added in v0.4.6

func TakeLast(values ts.Datapoints) float64

TakeLast is a consolidation function which takes the last datapoint which has non nan value.

Types

type AccountedBlock added in v0.7.1

type AccountedBlock struct {
	Block
	// contains filtered or unexported fields
}

AccountedBlock is a wrapper for a block which enforces limits on the number of datapoints used by the block.

func NewAccountedBlock added in v0.7.1

func NewAccountedBlock(
	wrapped Block,
	enforcer cost.ChainedEnforcer,
) *AccountedBlock

NewAccountedBlock wraps the given block and enforces datapoint limits.

func (*AccountedBlock) Close added in v0.7.1

func (ab *AccountedBlock) Close() error

Close closes the block, and marks the number of datapoints used by this block as finished.

type AccumulatorBlock added in v0.9.3

type AccumulatorBlock interface {
	Block
	// AddBlock adds a block to this accumulator.
	AddBlock(bl Block) error
}

func NewContainerBlock added in v0.9.3

func NewContainerBlock(blocks ...Block) (AccumulatorBlock, error)

NewContainerBlock creates a container block, which allows iterating across blocks incoming from multiple data sources, provided they have the same bounds.

type Block

type Block interface {
	io.Closer
	// Unconsolidated returns the unconsolidated version of the block.
	Unconsolidated() (UnconsolidatedBlock, error)
	// StepIter returns a step-wise block iterator, giving consolidated values
	// across all series comprising the box at a single time step.
	StepIter() (StepIter, error)
	// SeriesIter returns a series-wise block iterator, giving consolidated values
	// by series.
	SeriesIter() (SeriesIter, error)
	// Meta returns the metadata for the block.
	Meta() Metadata
	// Info returns information about the block.
	Info() BlockInfo
}

Block represents a group of series across a time bound.

func NewEmptyBlock added in v0.11.0

func NewEmptyBlock(meta Metadata) Block

NewEmptyBlock creates an empty block with the given metadata.

func NewLazyBlock added in v0.9.2

func NewLazyBlock(block Block, opts LazyOptions) Block

NewLazyBlock creates a lazy block wrapping another block with lazy options.

func NewScalar added in v0.4.1

func NewScalar(
	val float64,
	meta Metadata,
) Block

NewScalar creates a scalar block whose value is given by the function over the metadata bounds.

type BlockInfo added in v0.11.0

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

func NewBlockInfo added in v0.11.0

func NewBlockInfo(blockType BlockType) BlockInfo

func NewWrappedBlockInfo added in v0.11.0

func NewWrappedBlockInfo(
	blockType BlockType,
	wrap BlockInfo,
) BlockInfo

func (BlockInfo) BaseType added in v0.11.0

func (b BlockInfo) BaseType() BlockType

func (BlockInfo) InnerType added in v0.11.0

func (b BlockInfo) InnerType() BlockType

func (BlockInfo) Type added in v0.11.0

func (b BlockInfo) Type() BlockType

type BlockType added in v0.11.0

type BlockType uint8

BlockType describes a block type.

const (
	// BlockM3TSZCompressed is an M3TSZ compressed block.
	BlockM3TSZCompressed BlockType = iota
	// BlockDecompressed is a decompressed raw data block.
	BlockDecompressed
	// BlockScalar is a scalar block with a single value throughout its range.
	BlockScalar
	// BlockTime is a block with datapoint values given by a function of their
	// timestamps.
	BlockTime
	// BlockLazy is a wrapper for an inner block that lazily applies transforms.
	BlockLazy
	// BlockContainer is a block that contains multiple inner blocks that share
	// common metadata.
	BlockContainer
	// BlockEmpty is a block with metadata but no series or values.
	BlockEmpty
	//
	// TODO: (arnikola) do some refactoring to remove the blocks and types below,
	// as they can be better handled by the above block types.
	//
	// BlockMultiSeries is a block containing series with common metadata.
	BlockMultiSeries
	// BlockConsolidated is a consolidated block.
	BlockConsolidated
)

func (BlockType) String added in v0.11.0

func (t BlockType) String() string

type Builder

type Builder interface {
	// AddCols adds the given number of columns to the block.
	AddCols(num int) error
	// AppendValue adds a single value to the column at the given index.
	AppendValue(idx int, value float64) error
	// AppendValues adds a slice of values to the column at the given index.
	AppendValues(idx int, values []float64) error
	// Build builds the block.
	Build() Block
	// BuildAsType builds the block, forcing it to the given BlockType.
	BuildAsType(blockType BlockType) Block
}

func NewColumnBlockBuilder

func NewColumnBlockBuilder(
	queryCtx *models.QueryContext,
	meta Metadata,
	seriesMeta []SeriesMeta) Builder

NewColumnBlockBuilder creates a new column block builder

type ColStep

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

ColStep is a single column containing data from multiple series at a given time step

func (ColStep) Time

func (c ColStep) Time() time.Time

Time for the step

func (ColStep) Values

func (c ColStep) Values() []float64

Values for the column

type ColumnBlockBuilder

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

ColumnBlockBuilder builds a block optimized for column iteration

func (ColumnBlockBuilder) AddCols

func (cb ColumnBlockBuilder) AddCols(num int) error

func (ColumnBlockBuilder) AppendValue

func (cb ColumnBlockBuilder) AppendValue(idx int, value float64) error

AppendValue adds a value to a column at index

func (ColumnBlockBuilder) AppendValues added in v0.4.1

func (cb ColumnBlockBuilder) AppendValues(idx int, values []float64) error

AppendValues adds a slice of values to a column at index

func (ColumnBlockBuilder) Build

func (cb ColumnBlockBuilder) Build() Block

func (ColumnBlockBuilder) BuildAsType added in v0.11.0

func (cb ColumnBlockBuilder) BuildAsType(blockType BlockType) Block

type ConsolidationFunc added in v0.4.6

type ConsolidationFunc func(datapoints ts.Datapoints) float64

ConsolidationFunc consolidates a bunch of datapoints into a single float value.

type Iterator

type Iterator interface {
	// Next moves to the next item in the iterator. It will return false if there
	// are no more items, or if encountering an error.
	//
	// NB: it is important to check that Err() is nil after Next returns false, to
	// ensure that any errors during iteration are detected and accounted for.
	Next() bool
	// Err returns any error encountered during iteration.
	Err() error
	// Close frees up resources held by the iterator.
	Close()
}

Iterator is the base iterator.

type LazyOptions added in v0.9.2

type LazyOptions interface {
	// SetTimeTransform sets the time transform function.
	SetTimeTransform(TimeTransform) LazyOptions
	// TimeTransform returns the time transform function.
	TimeTransform() TimeTransform
	// SetValueTransform sets the value transform function.
	SetValueTransform(ValueTransform) LazyOptions
	// ValueTransform returns the value transform function.
	ValueTransform() ValueTransform
	// SetMetaTransform sets the meta transform function.
	SetMetaTransform(MetaTransform) LazyOptions
	// MetaTransform returns the meta transform function.
	MetaTransform() MetaTransform
	// SetSeriesMetaTransform sets the series meta transform function.
	SetSeriesMetaTransform(SeriesMetaTransform) LazyOptions
	// SeriesMetaTransform returns the series meta transform function.
	SeriesMetaTransform() SeriesMetaTransform
}

LazyOptions describes options for lazy blocks.

func NewLazyOptions added in v0.11.0

func NewLazyOptions() LazyOptions

NewLazyOptions creates LazyOpts with default values.

type MetaTransform added in v0.9.2

type MetaTransform func(meta Metadata) Metadata

MetaTransform transforms meta data.

type Metadata

type Metadata struct {
	// Bounds represents the time bounds for all series in the block.
	Bounds models.Bounds
	// Tags contains any tags common across all series in the block.
	Tags models.Tags
	// ResultMetadata contains metadata from any database access operations during
	// fetching block details.
	ResultMetadata ResultMetadata
}

Metadata is metadata for a block, describing size and common tags across constituent series.

func MustMakeMeta added in v0.11.0

func MustMakeMeta(bounds models.Bounds, tags ...string) Metadata

MustMakeMeta returns block metadata or panics (unsafe for use).

func (Metadata) Equals added in v0.11.0

func (m Metadata) Equals(other Metadata) bool

Equals returns a boolean reporting whether the compared metadata has equal fields.

func (Metadata) String

func (m Metadata) String() string

String returns a string representation of metadata.

type MockBlock added in v0.4.1

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

MockBlock is a mock of Block interface

func NewMockBlock added in v0.4.1

func NewMockBlock(ctrl *gomock.Controller) *MockBlock

NewMockBlock creates a new mock instance

func (*MockBlock) Close added in v0.4.1

func (m *MockBlock) Close() error

Close mocks base method

func (*MockBlock) EXPECT added in v0.4.1

func (m *MockBlock) EXPECT() *MockBlockMockRecorder

EXPECT returns an object that allows the caller to indicate expected use

func (*MockBlock) Info added in v0.11.0

func (m *MockBlock) Info() BlockInfo

Info mocks base method

func (*MockBlock) Meta added in v0.11.0

func (m *MockBlock) Meta() Metadata

Meta mocks base method

func (*MockBlock) SeriesIter added in v0.4.1

func (m *MockBlock) SeriesIter() (SeriesIter, error)

SeriesIter mocks base method

func (*MockBlock) StepIter added in v0.4.1

func (m *MockBlock) StepIter() (StepIter, error)

StepIter mocks base method

func (*MockBlock) Unconsolidated added in v0.4.6

func (m *MockBlock) Unconsolidated() (UnconsolidatedBlock, error)

Unconsolidated mocks base method

type MockBlockMockRecorder added in v0.4.1

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

MockBlockMockRecorder is the mock recorder for MockBlock

func (*MockBlockMockRecorder) Close added in v0.4.1

func (mr *MockBlockMockRecorder) Close() *gomock.Call

Close indicates an expected call of Close

func (*MockBlockMockRecorder) Info added in v0.11.0

func (mr *MockBlockMockRecorder) Info() *gomock.Call

Info indicates an expected call of Info

func (*MockBlockMockRecorder) Meta added in v0.11.0

func (mr *MockBlockMockRecorder) Meta() *gomock.Call

Meta indicates an expected call of Meta

func (*MockBlockMockRecorder) SeriesIter added in v0.4.1

func (mr *MockBlockMockRecorder) SeriesIter() *gomock.Call

SeriesIter indicates an expected call of SeriesIter

func (*MockBlockMockRecorder) StepIter added in v0.4.1

func (mr *MockBlockMockRecorder) StepIter() *gomock.Call

StepIter indicates an expected call of StepIter

func (*MockBlockMockRecorder) Unconsolidated added in v0.4.6

func (mr *MockBlockMockRecorder) Unconsolidated() *gomock.Call

Unconsolidated indicates an expected call of Unconsolidated

type MockBuilder added in v0.4.1

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

MockBuilder is a mock of Builder interface

func NewMockBuilder added in v0.4.1

func NewMockBuilder(ctrl *gomock.Controller) *MockBuilder

NewMockBuilder creates a new mock instance

func (*MockBuilder) AddCols added in v0.4.1

func (m *MockBuilder) AddCols(arg0 int) error

AddCols mocks base method

func (*MockBuilder) AppendValue added in v0.4.1

func (m *MockBuilder) AppendValue(arg0 int, arg1 float64) error

AppendValue mocks base method

func (*MockBuilder) AppendValues added in v0.4.1

func (m *MockBuilder) AppendValues(arg0 int, arg1 []float64) error

AppendValues mocks base method

func (*MockBuilder) Build added in v0.4.1

func (m *MockBuilder) Build() Block

Build mocks base method

func (*MockBuilder) BuildAsType added in v0.11.0

func (m *MockBuilder) BuildAsType(arg0 BlockType) Block

BuildAsType mocks base method

func (*MockBuilder) EXPECT added in v0.4.1

func (m *MockBuilder) EXPECT() *MockBuilderMockRecorder

EXPECT returns an object that allows the caller to indicate expected use

type MockBuilderMockRecorder added in v0.4.1

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

MockBuilderMockRecorder is the mock recorder for MockBuilder

func (*MockBuilderMockRecorder) AddCols added in v0.4.1

func (mr *MockBuilderMockRecorder) AddCols(arg0 interface{}) *gomock.Call

AddCols indicates an expected call of AddCols

func (*MockBuilderMockRecorder) AppendValue added in v0.4.1

func (mr *MockBuilderMockRecorder) AppendValue(arg0, arg1 interface{}) *gomock.Call

AppendValue indicates an expected call of AppendValue

func (*MockBuilderMockRecorder) AppendValues added in v0.4.1

func (mr *MockBuilderMockRecorder) AppendValues(arg0, arg1 interface{}) *gomock.Call

AppendValues indicates an expected call of AppendValues

func (*MockBuilderMockRecorder) Build added in v0.4.1

func (mr *MockBuilderMockRecorder) Build() *gomock.Call

Build indicates an expected call of Build

func (*MockBuilderMockRecorder) BuildAsType added in v0.11.0

func (mr *MockBuilderMockRecorder) BuildAsType(arg0 interface{}) *gomock.Call

BuildAsType indicates an expected call of BuildAsType

type MockSeriesIter added in v0.4.1

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

MockSeriesIter is a mock of SeriesIter interface

func NewMockSeriesIter added in v0.4.1

func NewMockSeriesIter(ctrl *gomock.Controller) *MockSeriesIter

NewMockSeriesIter creates a new mock instance

func (*MockSeriesIter) Close added in v0.4.1

func (m *MockSeriesIter) Close()

Close mocks base method

func (*MockSeriesIter) Current added in v0.4.1

func (m *MockSeriesIter) Current() Series

Current mocks base method

func (*MockSeriesIter) EXPECT added in v0.4.1

EXPECT returns an object that allows the caller to indicate expected use

func (*MockSeriesIter) Err added in v0.6.0

func (m *MockSeriesIter) Err() error

Err mocks base method

func (*MockSeriesIter) Next added in v0.4.1

func (m *MockSeriesIter) Next() bool

Next mocks base method

func (*MockSeriesIter) SeriesCount added in v0.4.1

func (m *MockSeriesIter) SeriesCount() int

SeriesCount mocks base method

func (*MockSeriesIter) SeriesMeta added in v0.4.1

func (m *MockSeriesIter) SeriesMeta() []SeriesMeta

SeriesMeta mocks base method

type MockSeriesIterMockRecorder added in v0.4.1

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

MockSeriesIterMockRecorder is the mock recorder for MockSeriesIter

func (*MockSeriesIterMockRecorder) Close added in v0.4.1

func (mr *MockSeriesIterMockRecorder) Close() *gomock.Call

Close indicates an expected call of Close

func (*MockSeriesIterMockRecorder) Current added in v0.4.1

func (mr *MockSeriesIterMockRecorder) Current() *gomock.Call

Current indicates an expected call of Current

func (*MockSeriesIterMockRecorder) Err added in v0.6.0

Err indicates an expected call of Err

func (*MockSeriesIterMockRecorder) Next added in v0.4.1

Next indicates an expected call of Next

func (*MockSeriesIterMockRecorder) SeriesCount added in v0.4.1

func (mr *MockSeriesIterMockRecorder) SeriesCount() *gomock.Call

SeriesCount indicates an expected call of SeriesCount

func (*MockSeriesIterMockRecorder) SeriesMeta added in v0.4.1

func (mr *MockSeriesIterMockRecorder) SeriesMeta() *gomock.Call

SeriesMeta indicates an expected call of SeriesMeta

type MockStep added in v0.4.1

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

MockStep is a mock of Step interface

func NewMockStep added in v0.4.1

func NewMockStep(ctrl *gomock.Controller) *MockStep

NewMockStep creates a new mock instance

func (*MockStep) EXPECT added in v0.4.1

func (m *MockStep) EXPECT() *MockStepMockRecorder

EXPECT returns an object that allows the caller to indicate expected use

func (*MockStep) Time added in v0.4.1

func (m *MockStep) Time() time.Time

Time mocks base method

func (*MockStep) Values added in v0.4.1

func (m *MockStep) Values() []float64

Values mocks base method

type MockStepIter added in v0.4.1

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

MockStepIter is a mock of StepIter interface

func NewMockStepIter added in v0.4.1

func NewMockStepIter(ctrl *gomock.Controller) *MockStepIter

NewMockStepIter creates a new mock instance

func (*MockStepIter) Close added in v0.4.1

func (m *MockStepIter) Close()

Close mocks base method

func (*MockStepIter) Current added in v0.4.1

func (m *MockStepIter) Current() Step

Current mocks base method

func (*MockStepIter) EXPECT added in v0.4.1

EXPECT returns an object that allows the caller to indicate expected use

func (*MockStepIter) Err added in v0.6.0

func (m *MockStepIter) Err() error

Err mocks base method

func (*MockStepIter) Next added in v0.4.1

func (m *MockStepIter) Next() bool

Next mocks base method

func (*MockStepIter) SeriesMeta added in v0.4.1

func (m *MockStepIter) SeriesMeta() []SeriesMeta

SeriesMeta mocks base method

func (*MockStepIter) StepCount added in v0.4.1

func (m *MockStepIter) StepCount() int

StepCount mocks base method

type MockStepIterMockRecorder added in v0.4.1

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

MockStepIterMockRecorder is the mock recorder for MockStepIter

func (*MockStepIterMockRecorder) Close added in v0.4.1

func (mr *MockStepIterMockRecorder) Close() *gomock.Call

Close indicates an expected call of Close

func (*MockStepIterMockRecorder) Current added in v0.4.1

func (mr *MockStepIterMockRecorder) Current() *gomock.Call

Current indicates an expected call of Current

func (*MockStepIterMockRecorder) Err added in v0.6.0

Err indicates an expected call of Err

func (*MockStepIterMockRecorder) Next added in v0.4.1

func (mr *MockStepIterMockRecorder) Next() *gomock.Call

Next indicates an expected call of Next

func (*MockStepIterMockRecorder) SeriesMeta added in v0.4.1

func (mr *MockStepIterMockRecorder) SeriesMeta() *gomock.Call

SeriesMeta indicates an expected call of SeriesMeta

func (*MockStepIterMockRecorder) StepCount added in v0.4.1

func (mr *MockStepIterMockRecorder) StepCount() *gomock.Call

StepCount indicates an expected call of StepCount

type MockStepMockRecorder added in v0.4.1

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

MockStepMockRecorder is the mock recorder for MockStep

func (*MockStepMockRecorder) Time added in v0.4.1

func (mr *MockStepMockRecorder) Time() *gomock.Call

Time indicates an expected call of Time

func (*MockStepMockRecorder) Values added in v0.4.1

func (mr *MockStepMockRecorder) Values() *gomock.Call

Values indicates an expected call of Values

type MockUnconsolidatedBlock added in v0.8.4

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

MockUnconsolidatedBlock is a mock of UnconsolidatedBlock interface

func NewMockUnconsolidatedBlock added in v0.8.4

func NewMockUnconsolidatedBlock(ctrl *gomock.Controller) *MockUnconsolidatedBlock

NewMockUnconsolidatedBlock creates a new mock instance

func (*MockUnconsolidatedBlock) Close added in v0.8.4

func (m *MockUnconsolidatedBlock) Close() error

Close mocks base method

func (*MockUnconsolidatedBlock) Consolidate added in v0.8.4

func (m *MockUnconsolidatedBlock) Consolidate() (Block, error)

Consolidate mocks base method

func (*MockUnconsolidatedBlock) EXPECT added in v0.8.4

EXPECT returns an object that allows the caller to indicate expected use

func (*MockUnconsolidatedBlock) Meta added in v0.11.0

Meta mocks base method

func (*MockUnconsolidatedBlock) SeriesIter added in v0.8.4

SeriesIter mocks base method

func (*MockUnconsolidatedBlock) StepIter added in v0.8.4

StepIter mocks base method

type MockUnconsolidatedBlockMockRecorder added in v0.8.4

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

MockUnconsolidatedBlockMockRecorder is the mock recorder for MockUnconsolidatedBlock

func (*MockUnconsolidatedBlockMockRecorder) Close added in v0.8.4

Close indicates an expected call of Close

func (*MockUnconsolidatedBlockMockRecorder) Consolidate added in v0.8.4

func (mr *MockUnconsolidatedBlockMockRecorder) Consolidate() *gomock.Call

Consolidate indicates an expected call of Consolidate

func (*MockUnconsolidatedBlockMockRecorder) Meta added in v0.11.0

Meta indicates an expected call of Meta

func (*MockUnconsolidatedBlockMockRecorder) SeriesIter added in v0.8.4

SeriesIter indicates an expected call of SeriesIter

func (*MockUnconsolidatedBlockMockRecorder) StepIter added in v0.8.4

StepIter indicates an expected call of StepIter

type MockUnconsolidatedSeriesIter added in v0.8.4

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

MockUnconsolidatedSeriesIter is a mock of UnconsolidatedSeriesIter interface

func NewMockUnconsolidatedSeriesIter added in v0.8.4

func NewMockUnconsolidatedSeriesIter(ctrl *gomock.Controller) *MockUnconsolidatedSeriesIter

NewMockUnconsolidatedSeriesIter creates a new mock instance

func (*MockUnconsolidatedSeriesIter) Close added in v0.8.4

func (m *MockUnconsolidatedSeriesIter) Close()

Close mocks base method

func (*MockUnconsolidatedSeriesIter) Current added in v0.8.4

Current mocks base method

func (*MockUnconsolidatedSeriesIter) EXPECT added in v0.8.4

EXPECT returns an object that allows the caller to indicate expected use

func (*MockUnconsolidatedSeriesIter) Err added in v0.8.4

Err mocks base method

func (*MockUnconsolidatedSeriesIter) Next added in v0.8.4

Next mocks base method

func (*MockUnconsolidatedSeriesIter) SeriesCount added in v0.8.4

func (m *MockUnconsolidatedSeriesIter) SeriesCount() int

SeriesCount mocks base method

func (*MockUnconsolidatedSeriesIter) SeriesMeta added in v0.8.4

func (m *MockUnconsolidatedSeriesIter) SeriesMeta() []SeriesMeta

SeriesMeta mocks base method

type MockUnconsolidatedSeriesIterMockRecorder added in v0.8.4

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

MockUnconsolidatedSeriesIterMockRecorder is the mock recorder for MockUnconsolidatedSeriesIter

func (*MockUnconsolidatedSeriesIterMockRecorder) Close added in v0.8.4

Close indicates an expected call of Close

func (*MockUnconsolidatedSeriesIterMockRecorder) Current added in v0.8.4

Current indicates an expected call of Current

func (*MockUnconsolidatedSeriesIterMockRecorder) Err added in v0.8.4

Err indicates an expected call of Err

func (*MockUnconsolidatedSeriesIterMockRecorder) Next added in v0.8.4

Next indicates an expected call of Next

func (*MockUnconsolidatedSeriesIterMockRecorder) SeriesCount added in v0.8.4

SeriesCount indicates an expected call of SeriesCount

func (*MockUnconsolidatedSeriesIterMockRecorder) SeriesMeta added in v0.8.4

SeriesMeta indicates an expected call of SeriesMeta

type MockUnconsolidatedStep added in v0.8.4

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

MockUnconsolidatedStep is a mock of UnconsolidatedStep interface

func NewMockUnconsolidatedStep added in v0.8.4

func NewMockUnconsolidatedStep(ctrl *gomock.Controller) *MockUnconsolidatedStep

NewMockUnconsolidatedStep creates a new mock instance

func (*MockUnconsolidatedStep) EXPECT added in v0.8.4

EXPECT returns an object that allows the caller to indicate expected use

func (*MockUnconsolidatedStep) Time added in v0.8.4

func (m *MockUnconsolidatedStep) Time() time.Time

Time mocks base method

func (*MockUnconsolidatedStep) Values added in v0.8.4

func (m *MockUnconsolidatedStep) Values() []ts.Datapoints

Values mocks base method

type MockUnconsolidatedStepIter added in v0.8.4

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

MockUnconsolidatedStepIter is a mock of UnconsolidatedStepIter interface

func NewMockUnconsolidatedStepIter added in v0.8.4

func NewMockUnconsolidatedStepIter(ctrl *gomock.Controller) *MockUnconsolidatedStepIter

NewMockUnconsolidatedStepIter creates a new mock instance

func (*MockUnconsolidatedStepIter) Close added in v0.8.4

func (m *MockUnconsolidatedStepIter) Close()

Close mocks base method

func (*MockUnconsolidatedStepIter) Current added in v0.8.4

Current mocks base method

func (*MockUnconsolidatedStepIter) EXPECT added in v0.8.4

EXPECT returns an object that allows the caller to indicate expected use

func (*MockUnconsolidatedStepIter) Err added in v0.8.4

Err mocks base method

func (*MockUnconsolidatedStepIter) Next added in v0.8.4

func (m *MockUnconsolidatedStepIter) Next() bool

Next mocks base method

func (*MockUnconsolidatedStepIter) SeriesMeta added in v0.8.4

func (m *MockUnconsolidatedStepIter) SeriesMeta() []SeriesMeta

SeriesMeta mocks base method

func (*MockUnconsolidatedStepIter) StepCount added in v0.8.4

func (m *MockUnconsolidatedStepIter) StepCount() int

StepCount mocks base method

type MockUnconsolidatedStepIterMockRecorder added in v0.8.4

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

MockUnconsolidatedStepIterMockRecorder is the mock recorder for MockUnconsolidatedStepIter

func (*MockUnconsolidatedStepIterMockRecorder) Close added in v0.8.4

Close indicates an expected call of Close

func (*MockUnconsolidatedStepIterMockRecorder) Current added in v0.8.4

Current indicates an expected call of Current

func (*MockUnconsolidatedStepIterMockRecorder) Err added in v0.8.4

Err indicates an expected call of Err

func (*MockUnconsolidatedStepIterMockRecorder) Next added in v0.8.4

Next indicates an expected call of Next

func (*MockUnconsolidatedStepIterMockRecorder) SeriesMeta added in v0.8.4

SeriesMeta indicates an expected call of SeriesMeta

func (*MockUnconsolidatedStepIterMockRecorder) StepCount added in v0.8.4

StepCount indicates an expected call of StepCount

type MockUnconsolidatedStepMockRecorder added in v0.8.4

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

MockUnconsolidatedStepMockRecorder is the mock recorder for MockUnconsolidatedStep

func (*MockUnconsolidatedStepMockRecorder) Time added in v0.8.4

Time indicates an expected call of Time

func (*MockUnconsolidatedStepMockRecorder) Values added in v0.8.4

Values indicates an expected call of Values

type Result

type Result struct {
	// Blocks is a list of blocks, optionally split across time boundaries.
	Blocks []Block
	// Metadata contains information on fetch status.
	Metadata ResultMetadata
	// Resolutions contains a slice representing resolution for graphite queries.
	Resolutions []int
}

Result is a fetch result containing multiple blocks optionally split across time boundaries.

type ResultMetadata added in v0.14.0

type ResultMetadata struct {
	// LocalOnly indicates that this query was executed only on the local store.
	LocalOnly bool
	// Exhaustive indicates whether the underlying data set presents a full
	// collection of retrieved data.
	Exhaustive bool
	// Warnings is a list of warnings that indicate potetitally partial or
	// incomplete results.
	Warnings Warnings
	// Resolutions is a list of resolutions for series obtained by this query.
	Resolutions []int64
}

ResultMetadata describes metadata common to each type of query results, indicating any additional information about the result.

func NewResultMetadata added in v0.14.0

func NewResultMetadata() ResultMetadata

NewResultMetadata creates a new result metadata.

func (*ResultMetadata) AddWarning added in v0.14.0

func (m *ResultMetadata) AddWarning(name string, message string)

AddWarning adds a warning to the result metadata. NB: warnings are expected to be small in general, so it's better to iterate over the array rather than introduce a map.

func (ResultMetadata) CombineMetadata added in v0.14.0

func (m ResultMetadata) CombineMetadata(other ResultMetadata) ResultMetadata

CombineMetadata combines two result metadatas.

func (ResultMetadata) IsDefault added in v0.14.0

func (m ResultMetadata) IsDefault() bool

IsDefault returns true if this result metadata matches the unchanged default.

type Scalar added in v0.4.1

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

Scalar is a block containing a single value over a certain bound This represents constant values; it greatly simplifies downstream operations by allowing them to treat this as a regular block, while at the same time having an option to optimize by accessing the scalar value directly instead.

func (*Scalar) Close added in v0.4.1

func (b *Scalar) Close() error

func (*Scalar) Info added in v0.11.0

func (c *Scalar) Info() BlockInfo

func (*Scalar) Meta added in v0.11.0

func (b *Scalar) Meta() Metadata

func (*Scalar) SeriesIter added in v0.4.1

func (b *Scalar) SeriesIter() (SeriesIter, error)

func (*Scalar) StepIter added in v0.4.1

func (b *Scalar) StepIter() (StepIter, error)

func (*Scalar) Unconsolidated added in v0.4.6

func (b *Scalar) Unconsolidated() (UnconsolidatedBlock, error)

Unconsolidated returns the unconsolidated version for the block.

func (*Scalar) Value added in v0.4.1

func (b *Scalar) Value() float64

type Series

type Series struct {
	Meta SeriesMeta
	// contains filtered or unexported fields
}

Series is a single series within a block

func NewSeries

func NewSeries(values []float64, meta SeriesMeta) Series

NewSeries creates a new series

func (Series) Len

func (s Series) Len() int

Len returns the number of datapoints in the series

func (Series) ValueAtStep

func (s Series) ValueAtStep(idx int) float64

ValueAtStep returns the datapoint value at a step index

func (Series) Values

func (s Series) Values() []float64

Values returns the internal values slice

type SeriesIter

type SeriesIter interface {
	Iterator
	SeriesMetaIter
	// Current returns the current series for the block.
	Current() Series
}

SeriesIter iterates through a block horizontally.

type SeriesMeta

type SeriesMeta struct {
	Tags models.Tags
	Name []byte
}

SeriesMeta is metadata data for the series.

func MustMakeSeriesMeta added in v0.11.0

func MustMakeSeriesMeta(tags ...string) SeriesMeta

MustMakeSeriesMeta returns series metadata or panics (unsafe for use).

type SeriesMetaIter added in v0.4.6

type SeriesMetaIter interface {
	// SeriesMeta returns the metadata for each series in the block.
	SeriesMeta() []SeriesMeta
	// SeriesCount returns the number of series.
	SeriesCount() int
}

SeriesMetaIter is implemented by series iterators which provide meta information.

type SeriesMetaTransform added in v0.14.0

type SeriesMetaTransform func(meta []SeriesMeta) []SeriesMeta

SeriesMetaTransform transforms series meta data.

type Step

type Step interface {
	Time() time.Time
	Values() []float64
}

Step is a single time step within a block.

func NewColStep

func NewColStep(t time.Time, values []float64) Step

NewColStep creates a new column step

type StepIter

type StepIter interface {
	Iterator
	StepMetaIter
	// Current returns the current step for the block.
	Current() Step
}

StepIter iterates through a block vertically.

type StepMetaIter added in v0.4.6

type StepMetaIter interface {
	// SeriesMeta returns the metadata for each series in the block.
	SeriesMeta() []SeriesMeta
	// StepCount returns the number of steps.
	StepCount() int
}

StepMetaIter is implemented by step iterators which provide meta information.

type TimeTransform added in v0.9.2

type TimeTransform func(time.Time) time.Time

TimeTransform transforms a timestamp.

type UnconsolidatedBlock added in v0.4.6

type UnconsolidatedBlock interface {
	io.Closer
	// StepIter returns a step-wise block iterator, giving unconsolidated values
	// across all series comprising the box at a single time step.
	StepIter() (UnconsolidatedStepIter, error)
	// SeriesIter returns a series-wise block iterator, giving unconsolidated
	// by series.
	SeriesIter() (UnconsolidatedSeriesIter, error)
	// Consolidate attempts to consolidate the unconsolidated block.
	Consolidate() (Block, error)
	// Meta returns the metadata for the block.
	Meta() Metadata
}

UnconsolidatedBlock represents a group of unconsolidated series across a time bound

type UnconsolidatedSeries added in v0.4.6

type UnconsolidatedSeries struct {
	Meta SeriesMeta
	// contains filtered or unexported fields
}

UnconsolidatedSeries is the series with raw datapoints

func NewUnconsolidatedSeries added in v0.4.6

func NewUnconsolidatedSeries(datapoints []ts.Datapoints, meta SeriesMeta) UnconsolidatedSeries

NewUnconsolidatedSeries creates a new series with raw datapoints

func (UnconsolidatedSeries) Consolidated added in v0.4.6

func (s UnconsolidatedSeries) Consolidated(consolidationFunc ConsolidationFunc) Series

Consolidated consolidates the series

func (UnconsolidatedSeries) Datapoints added in v0.4.6

func (s UnconsolidatedSeries) Datapoints() []ts.Datapoints

Datapoints returns the internal datapoints slice

func (UnconsolidatedSeries) DatapointsAtStep added in v0.4.6

func (s UnconsolidatedSeries) DatapointsAtStep(idx int) ts.Datapoints

DatapointsAtStep returns the raw datapoints at a step index

func (UnconsolidatedSeries) Len added in v0.4.6

func (s UnconsolidatedSeries) Len() int

Len returns the number of datapoints slices in the series

type UnconsolidatedSeriesIter added in v0.4.6

type UnconsolidatedSeriesIter interface {
	Iterator
	SeriesMetaIter
	// Current returns the current series for the block.
	Current() UnconsolidatedSeries
}

UnconsolidatedSeriesIter iterates through a block horizontally.

type UnconsolidatedStep added in v0.4.6

type UnconsolidatedStep interface {
	Time() time.Time
	Values() []ts.Datapoints
}

UnconsolidatedStep is a single unconsolidated time step within a block.

type UnconsolidatedStepIter added in v0.4.6

type UnconsolidatedStepIter interface {
	Iterator
	StepMetaIter
	// Current returns the current step for the block.
	Current() UnconsolidatedStep
}

UnconsolidatedStepIter iterates through a block vertically.

type ValueTransform added in v0.9.2

type ValueTransform func(float64) float64

ValueTransform transform a float64.

type Warning added in v0.14.0

type Warning struct {
	// Name is the name of the store originating the warning.
	Name string
	// Message is the content of the warning message.
	Message string
}

Warning is a message that indicates potential partial or incomplete results.

func (Warning) Header added in v0.14.0

func (w Warning) Header() string

Header formats the warning into a format to send in a response header.

type Warnings added in v0.14.0

type Warnings []Warning

Warnings is a slice of warnings.

Jump to

Keyboard shortcuts

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