consistent_hashingv3

Documentation

Index

• Variables
• type ConsistentHashing
  • func (*ConsistentHashing) Descriptor() ([]byte, []int)
  • func (x *ConsistentHashing) GetModulo() uint32
  • func (x *ConsistentHashing) GetSeed() uint64
  • func (x *ConsistentHashing) GetThreshold() uint32
  • func (*ConsistentHashing) ProtoMessage()
  • func (x *ConsistentHashing) ProtoReflect() protoreflect.Message
  • func (x *ConsistentHashing) Reset()
  • func (x *ConsistentHashing) String() string

Variables

var File_envoy_extensions_matching_input_matchers_consistent_hashing_v3_consistent_hashing_proto protoreflect.FileDescriptor

Types

type ConsistentHashing

type ConsistentHashing struct {

	// The threshold the resulting hash must be over in order for this matcher to evaluate to true.
	// This value must be below the configured modulo value.
	// Setting this to 0 is equivalent to this matcher always matching.
	Threshold uint32 `protobuf:"varint,1,opt,name=threshold,proto3" json:"threshold,omitempty"`
	// The value to use for the modulus in the calculation. This effectively  bounds the hash output,
	// specifying the range of possible values.
	// This value must be above the configured threshold.
	Modulo uint32 `protobuf:"varint,2,opt,name=modulo,proto3" json:"modulo,omitempty"`
	// Optional seed passed through the hash function. This allows using additional information when computing
	// the hash value: by changing the seed value, a different partition of matching and non-matching inputs will
	// be created that remains consistent for that seed value.
	Seed uint64 `protobuf:"varint,3,opt,name=seed,proto3" json:"seed,omitempty"`
	// contains filtered or unexported fields
}

The consistent hashing matchers computes a consistent hash from the input and matches if the resulting hash is within the configured threshold. More specifically, this matcher evaluates to true if hash(input, seed) % modulo >= threshold. Note that the consistency of the match result relies on the internal hash function (xxhash) remaining unchanged. While this is unlikely to happen intentionally, this could cause inconsistent match results between deployments.

func (*ConsistentHashing) Descriptor

func (*ConsistentHashing) Descriptor() ([]byte, []int)

Deprecated: Use ConsistentHashing.ProtoReflect.Descriptor instead.

func (*ConsistentHashing) GetModulo

func (x *ConsistentHashing) GetModulo() uint32

func (*ConsistentHashing) GetSeed

func (x *ConsistentHashing) GetSeed() uint64

func (*ConsistentHashing) GetThreshold

func (x *ConsistentHashing) GetThreshold() uint32

func (*ConsistentHashing) ProtoMessage

func (*ConsistentHashing) ProtoMessage()

func (*ConsistentHashing) ProtoReflect

func (x *ConsistentHashing) ProtoReflect() protoreflect.Message

func (*ConsistentHashing) Reset

func (x *ConsistentHashing) Reset()

func (*ConsistentHashing) String

func (x *ConsistentHashing) String() string