proto

Documentation

Index

• func NewIterator(reader xio.Reader64, descr namespace.SchemaDescr, opts encoding.Options) encoding.ReaderIterator
• func ParseProtoSchema(filePath string, messageName string) (*desc.MessageDescriptor, error)
• type Encoder
  • func NewEncoder(start xtime.UnixNano, opts encoding.Options) *Encoder
  • func (enc *Encoder) Bytes() ([]byte, error)
  • func (enc *Encoder) Close()
  • func (enc *Encoder) Discard() ts.Segment
  • func (enc *Encoder) DiscardReset(start xtime.UnixNano, capacity int, descr namespace.SchemaDescr) ts.Segment
  • func (enc *Encoder) Encode(dp ts.Datapoint, timeUnit xtime.Unit, protoBytes ts.Annotation) error
  • func (enc *Encoder) LastAnnotationChecksum() (uint64, error)
  • func (enc *Encoder) LastEncoded() (ts.Datapoint, error)
  • func (enc *Encoder) Len() int
  • func (enc *Encoder) NumEncoded() int
  • func (enc *Encoder) Reset(start xtime.UnixNano, capacity int, descr namespace.SchemaDescr)
  • func (enc *Encoder) SetSchema(descr namespace.SchemaDescr)
  • func (enc *Encoder) Stats() EncoderStats
  • func (enc *Encoder) Stream(ctx context.Context) (xio.SegmentReader, bool)
• type EncoderStats
• type Schema

Functions

func NewIterator

func NewIterator(
	reader xio.Reader64,
	descr namespace.SchemaDescr,
	opts encoding.Options,
) encoding.ReaderIterator

NewIterator creates a new iterator.

func ParseProtoSchema

func ParseProtoSchema(filePath string, messageName string) (*desc.MessageDescriptor, error)

ParseProtoSchema parses a Protobuf schema. TODO(rartoul): This is temporary code that will eventually be replaced with storing the schemas in etcd.

Types

type Encoder

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

Encoder compresses arbitrary ProtoBuf streams given a schema.

func NewEncoder

func NewEncoder(start xtime.UnixNano, opts encoding.Options) *Encoder

NewEncoder creates a new protobuf encoder.

func (*Encoder) Bytes

func (enc *Encoder) Bytes() ([]byte, error)

Bytes returns the raw bytes of the underlying data stream. Does not transfer ownership and is generally unsafe.

func (*Encoder) Close

func (enc *Encoder) Close()

Close closes the encoder.

func (*Encoder) Discard

func (enc *Encoder) Discard() ts.Segment

Discard closes the encoder and transfers ownership of the data stream to the caller.

func (*Encoder) DiscardReset

func (enc *Encoder) DiscardReset(
	start xtime.UnixNano,
	capacity int,
	descr namespace.SchemaDescr,
) ts.Segment

DiscardReset does the same thing as Discard except it also resets the encoder for reuse.

func (*Encoder) Encode

func (enc *Encoder) Encode(dp ts.Datapoint, timeUnit xtime.Unit, protoBytes ts.Annotation) error

Encode encodes a timestamp and a protobuf message. The function signature is strange in order to implement the encoding.Encoder interface. It accepts a ts.Datapoint, but only the Timestamp field will be used, the Value field will be ignored and will always return 0 on subsequent iteration. In addition, the provided annotation is expected to be a marshalled protobuf message that matches the configured schema.

func (*Encoder) LastAnnotationChecksum

func (enc *Encoder) LastAnnotationChecksum() (uint64, error)

LastAnnotation returns the checksum of the last encoded annotation (which contain the bytes used for ProtoBuf data).

func (*Encoder) LastEncoded

func (enc *Encoder) LastEncoded() (ts.Datapoint, error)

LastEncoded returns the last encoded datapoint. Does not include annotation / protobuf message for interface purposes.

func (*Encoder) Len

func (enc *Encoder) Len() int

Len returns the length of the data stream.

func (*Encoder) NumEncoded

func (enc *Encoder) NumEncoded() int

NumEncoded returns the number of encoded messages.

func (*Encoder) Reset

func (enc *Encoder) Reset(
	start xtime.UnixNano,
	capacity int,
	descr namespace.SchemaDescr,
)

Reset resets the encoder for reuse.

func (*Encoder) SetSchema

func (enc *Encoder) SetSchema(descr namespace.SchemaDescr)

SetSchema sets the schema for the encoder.

func (*Encoder) Stats

func (enc *Encoder) Stats() EncoderStats

Stats returns EncoderStats which contain statistics about the encoders compression ratio.

func (*Encoder) Stream

func (enc *Encoder) Stream(ctx context.Context) (xio.SegmentReader, bool)

Stream returns a copy of the underlying data stream.

type EncoderStats

type EncoderStats struct {
	UncompressedBytes int
	CompressedBytes   int
}

EncoderStats contains statistics about the encoders compression performance.

type Schema

type Schema *desc.MessageDescriptor

Schema represents a schema for a protobuf message.