internal

Documentation

Index

• Variables
• func NewMockStorageExtension(getClientError error) storage.Extension
• type Queue
  • func NewBoundedMemoryQueue[T any](capacity int) Queue[T]
  • func NewPersistentQueue[T any](capacity int, dataType component.DataType, storageID component.ID, ...) Queue[T]
• type QueueConsumers
  • func NewQueueConsumers[T any](q Queue[T], numConsumers int, consumeFunc func(context.Context, T)) *QueueConsumers[T]
  • func (qc *QueueConsumers[T]) Shutdown(ctx context.Context) error
  • func (qc *QueueConsumers[T]) Start(ctx context.Context, host component.Host) error

Variables

var (
	// ErrQueueIsFull is the error returned when an item is offered to the Queue and the queue is full.
	ErrQueueIsFull = errors.New("sending queue is full")
	// ErrQueueIsStopped is the error returned when an item is offered to the Queue and the queue is stopped.
	ErrQueueIsStopped = errors.New("sending queue is stopped")
)

Functions

func NewMockStorageExtension

func NewMockStorageExtension(getClientError error) storage.Extension

Types

type Queue

type Queue[T any] interface {
	component.Component
	// Offer inserts the specified element into this queue if it is possible to do so immediately
	// without violating capacity restrictions. If success returns no error.
	// It returns ErrQueueIsFull if no space is currently available.
	Offer(ctx context.Context, item T) error
	// Consume applies the provided function on the head of queue.
	// The call blocks until there is an item available or the queue is stopped.
	// The function returns true when an item is consumed or false if the queue is stopped.
	Consume(func(ctx context.Context, item T)) bool
	// Size returns the current Size of the queue
	Size() int
	// Capacity returns the capacity of the queue.
	Capacity() int
}

Queue defines a producer-consumer exchange which can be backed by e.g. the memory-based ring buffer queue (boundedMemoryQueue) or via a disk-based queue (persistentQueue)

func NewBoundedMemoryQueue

func NewBoundedMemoryQueue[T any](capacity int) Queue[T]

NewBoundedMemoryQueue constructs the new queue of specified capacity, and with an optional callback for dropped items (e.g. useful to emit metrics).

func NewPersistentQueue

func NewPersistentQueue[T any](capacity int, dataType component.DataType, storageID component.ID, marshaler func(req T) ([]byte, error), unmarshaler func([]byte) (T, error), set exporter.CreateSettings) Queue[T]

NewPersistentQueue creates a new queue backed by file storage; name and signal must be a unique combination that identifies the queue storage

type QueueConsumers

type QueueConsumers[T any] struct {
	// contains filtered or unexported fields
}

func NewQueueConsumers

func NewQueueConsumers[T any](q Queue[T], numConsumers int, consumeFunc func(context.Context, T)) *QueueConsumers[T]

func (*QueueConsumers[T]) Shutdown

func (qc *QueueConsumers[T]) Shutdown(ctx context.Context) error

Shutdown ensures that queue and all consumers are stopped.

func (*QueueConsumers[T]) Start

func (qc *QueueConsumers[T]) Start(ctx context.Context, host component.Host) error

Start ensures that queue and all consumers are started.