public static final class PreviousPrioritiesConfig.Builder extends com.google.protobuf.GeneratedMessageV3.Builder<PreviousPrioritiesConfig.Builder> implements PreviousPrioritiesConfigOrBuilder
A retry host selector that attempts to spread retries between priorities, even if certain
priorities would not normally be attempted due to higher priorities being available.
As priorities get excluded, load will be distributed amongst the remaining healthy priorities
based on the relative health of the priorities, matching how load is distributed during regular
host selection. For example, given priority healths of {100, 50, 50}, the original load will be
{100, 0, 0} (since P0 has capacity to handle 100% of the traffic). If P0 is excluded, the load
changes to {0, 50, 50}, because P1 is only able to handle 50% of the traffic, causing the
remaining to spill over to P2.
Each priority attempted will be excluded until there are no healthy priorities left, at which
point the list of attempted priorities will be reset, essentially starting from the beginning.
For example, given three priorities P0, P1, P2 with healthy % of 100, 0 and 50 respectively, the
following sequence of priorities would be selected (assuming update_frequency = 1):
Attempt 1: P0 (P0 is 100% healthy)
Attempt 2: P2 (P0 already attempted, P2 only healthy priority)
Attempt 3: P0 (no healthy priorities, reset)
Attempt 4: P2
In the case of all upstream hosts being unhealthy, no adjustments will be made to the original
priority load, so behavior should be identical to not using this plugin.
Using this PriorityFilter requires rebuilding the priority load, which runs in O(# of
priorities), which might incur significant overhead for clusters with many priorities.
[#extension: envoy.retry_priorities.previous_priorities]
Protobuf type envoy.extensions.retry.priority.previous_priorities.v3.PreviousPrioritiesConfig| Modifier and Type | Method and Description |
|---|---|
PreviousPrioritiesConfig.Builder |
addRepeatedField(com.google.protobuf.Descriptors.FieldDescriptor field,
Object value) |
PreviousPrioritiesConfig |
build() |
PreviousPrioritiesConfig |
buildPartial() |
PreviousPrioritiesConfig.Builder |
clear() |
PreviousPrioritiesConfig.Builder |
clearField(com.google.protobuf.Descriptors.FieldDescriptor field) |
PreviousPrioritiesConfig.Builder |
clearOneof(com.google.protobuf.Descriptors.OneofDescriptor oneof) |
PreviousPrioritiesConfig.Builder |
clearUpdateFrequency()
How often the priority load should be updated based on previously attempted priorities.
|
PreviousPrioritiesConfig.Builder |
clone() |
PreviousPrioritiesConfig |
getDefaultInstanceForType() |
static com.google.protobuf.Descriptors.Descriptor |
getDescriptor() |
com.google.protobuf.Descriptors.Descriptor |
getDescriptorForType() |
int |
getUpdateFrequency()
How often the priority load should be updated based on previously attempted priorities.
|
protected com.google.protobuf.GeneratedMessageV3.FieldAccessorTable |
internalGetFieldAccessorTable() |
boolean |
isInitialized() |
PreviousPrioritiesConfig.Builder |
mergeFrom(com.google.protobuf.CodedInputStream input,
com.google.protobuf.ExtensionRegistryLite extensionRegistry) |
PreviousPrioritiesConfig.Builder |
mergeFrom(com.google.protobuf.Message other) |
PreviousPrioritiesConfig.Builder |
mergeFrom(PreviousPrioritiesConfig other) |
PreviousPrioritiesConfig.Builder |
mergeUnknownFields(com.google.protobuf.UnknownFieldSet unknownFields) |
PreviousPrioritiesConfig.Builder |
setField(com.google.protobuf.Descriptors.FieldDescriptor field,
Object value) |
PreviousPrioritiesConfig.Builder |
setRepeatedField(com.google.protobuf.Descriptors.FieldDescriptor field,
int index,
Object value) |
PreviousPrioritiesConfig.Builder |
setUnknownFields(com.google.protobuf.UnknownFieldSet unknownFields) |
PreviousPrioritiesConfig.Builder |
setUpdateFrequency(int value)
How often the priority load should be updated based on previously attempted priorities.
|
getAllFields, getField, getFieldBuilder, getOneofFieldDescriptor, getParentForChildren, getRepeatedField, getRepeatedFieldBuilder, getRepeatedFieldCount, getUnknownFields, hasField, hasOneof, internalGetMapField, internalGetMutableMapField, isClean, markClean, newBuilderForField, onBuilt, onChanged, setUnknownFieldsProto3findInitializationErrors, getInitializationErrorString, internalMergeFrom, mergeDelimitedFrom, mergeDelimitedFrom, mergeFrom, mergeFrom, mergeFrom, mergeFrom, mergeFrom, mergeFrom, mergeFrom, mergeFrom, mergeFrom, newUninitializedMessageException, toStringaddAll, addAll, mergeFrom, newUninitializedMessageExceptionequals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, waitpublic static final com.google.protobuf.Descriptors.Descriptor getDescriptor()
protected com.google.protobuf.GeneratedMessageV3.FieldAccessorTable internalGetFieldAccessorTable()
internalGetFieldAccessorTable in class com.google.protobuf.GeneratedMessageV3.Builder<PreviousPrioritiesConfig.Builder>public PreviousPrioritiesConfig.Builder clear()
clear in interface com.google.protobuf.Message.Builderclear in interface com.google.protobuf.MessageLite.Builderclear in class com.google.protobuf.GeneratedMessageV3.Builder<PreviousPrioritiesConfig.Builder>public com.google.protobuf.Descriptors.Descriptor getDescriptorForType()
getDescriptorForType in interface com.google.protobuf.Message.BuildergetDescriptorForType in interface com.google.protobuf.MessageOrBuildergetDescriptorForType in class com.google.protobuf.GeneratedMessageV3.Builder<PreviousPrioritiesConfig.Builder>public PreviousPrioritiesConfig getDefaultInstanceForType()
getDefaultInstanceForType in interface com.google.protobuf.MessageLiteOrBuildergetDefaultInstanceForType in interface com.google.protobuf.MessageOrBuilderpublic PreviousPrioritiesConfig build()
build in interface com.google.protobuf.Message.Builderbuild in interface com.google.protobuf.MessageLite.Builderpublic PreviousPrioritiesConfig buildPartial()
buildPartial in interface com.google.protobuf.Message.BuilderbuildPartial in interface com.google.protobuf.MessageLite.Builderpublic PreviousPrioritiesConfig.Builder clone()
clone in interface com.google.protobuf.Message.Builderclone in interface com.google.protobuf.MessageLite.Builderclone in class com.google.protobuf.GeneratedMessageV3.Builder<PreviousPrioritiesConfig.Builder>public PreviousPrioritiesConfig.Builder setField(com.google.protobuf.Descriptors.FieldDescriptor field, Object value)
setField in interface com.google.protobuf.Message.BuildersetField in class com.google.protobuf.GeneratedMessageV3.Builder<PreviousPrioritiesConfig.Builder>public PreviousPrioritiesConfig.Builder clearField(com.google.protobuf.Descriptors.FieldDescriptor field)
clearField in interface com.google.protobuf.Message.BuilderclearField in class com.google.protobuf.GeneratedMessageV3.Builder<PreviousPrioritiesConfig.Builder>public PreviousPrioritiesConfig.Builder clearOneof(com.google.protobuf.Descriptors.OneofDescriptor oneof)
clearOneof in interface com.google.protobuf.Message.BuilderclearOneof in class com.google.protobuf.GeneratedMessageV3.Builder<PreviousPrioritiesConfig.Builder>public PreviousPrioritiesConfig.Builder setRepeatedField(com.google.protobuf.Descriptors.FieldDescriptor field, int index, Object value)
setRepeatedField in interface com.google.protobuf.Message.BuildersetRepeatedField in class com.google.protobuf.GeneratedMessageV3.Builder<PreviousPrioritiesConfig.Builder>public PreviousPrioritiesConfig.Builder addRepeatedField(com.google.protobuf.Descriptors.FieldDescriptor field, Object value)
addRepeatedField in interface com.google.protobuf.Message.BuilderaddRepeatedField in class com.google.protobuf.GeneratedMessageV3.Builder<PreviousPrioritiesConfig.Builder>public PreviousPrioritiesConfig.Builder mergeFrom(com.google.protobuf.Message other)
mergeFrom in interface com.google.protobuf.Message.BuildermergeFrom in class com.google.protobuf.AbstractMessage.Builder<PreviousPrioritiesConfig.Builder>public PreviousPrioritiesConfig.Builder mergeFrom(PreviousPrioritiesConfig other)
public final boolean isInitialized()
isInitialized in interface com.google.protobuf.MessageLiteOrBuilderisInitialized in class com.google.protobuf.GeneratedMessageV3.Builder<PreviousPrioritiesConfig.Builder>public PreviousPrioritiesConfig.Builder mergeFrom(com.google.protobuf.CodedInputStream input, com.google.protobuf.ExtensionRegistryLite extensionRegistry) throws IOException
mergeFrom in interface com.google.protobuf.Message.BuildermergeFrom in interface com.google.protobuf.MessageLite.BuildermergeFrom in class com.google.protobuf.AbstractMessage.Builder<PreviousPrioritiesConfig.Builder>IOExceptionpublic int getUpdateFrequency()
How often the priority load should be updated based on previously attempted priorities. Useful to allow each priorities to receive more than one request before being excluded or to reduce the number of times that the priority load has to be recomputed. For example, by setting this to 2, then the first two attempts (initial attempt and first retry) will use the unmodified priority load. The third and fourth attempt will use priority load which excludes the priorities routed to with the first two attempts, and the fifth and sixth attempt will use the priority load excluding the priorities used for the first four attempts. Must be greater than 0.
int32 update_frequency = 1 [(.validate.rules) = { ... }getUpdateFrequency in interface PreviousPrioritiesConfigOrBuilderpublic PreviousPrioritiesConfig.Builder setUpdateFrequency(int value)
How often the priority load should be updated based on previously attempted priorities. Useful to allow each priorities to receive more than one request before being excluded or to reduce the number of times that the priority load has to be recomputed. For example, by setting this to 2, then the first two attempts (initial attempt and first retry) will use the unmodified priority load. The third and fourth attempt will use priority load which excludes the priorities routed to with the first two attempts, and the fifth and sixth attempt will use the priority load excluding the priorities used for the first four attempts. Must be greater than 0.
int32 update_frequency = 1 [(.validate.rules) = { ... }public PreviousPrioritiesConfig.Builder clearUpdateFrequency()
How often the priority load should be updated based on previously attempted priorities. Useful to allow each priorities to receive more than one request before being excluded or to reduce the number of times that the priority load has to be recomputed. For example, by setting this to 2, then the first two attempts (initial attempt and first retry) will use the unmodified priority load. The third and fourth attempt will use priority load which excludes the priorities routed to with the first two attempts, and the fifth and sixth attempt will use the priority load excluding the priorities used for the first four attempts. Must be greater than 0.
int32 update_frequency = 1 [(.validate.rules) = { ... }public final PreviousPrioritiesConfig.Builder setUnknownFields(com.google.protobuf.UnknownFieldSet unknownFields)
setUnknownFields in interface com.google.protobuf.Message.BuildersetUnknownFields in class com.google.protobuf.GeneratedMessageV3.Builder<PreviousPrioritiesConfig.Builder>public final PreviousPrioritiesConfig.Builder mergeUnknownFields(com.google.protobuf.UnknownFieldSet unknownFields)
mergeUnknownFields in interface com.google.protobuf.Message.BuildermergeUnknownFields in class com.google.protobuf.GeneratedMessageV3.Builder<PreviousPrioritiesConfig.Builder>Copyright © 2018–2021 The Envoy Project. All rights reserved.