Package io.envoyproxy.envoy.extensions.load_balancing_policies.common.v3

Class SlowStartConfig

  • All Implemented Interfaces:
    com.google.protobuf.Message, com.google.protobuf.MessageLite, com.google.protobuf.MessageLiteOrBuilder, com.google.protobuf.MessageOrBuilder, SlowStartConfigOrBuilder, Serializable
    public final class SlowStartConfig
extends com.google.protobuf.GeneratedMessageV3
implements SlowStartConfigOrBuilder
     Configuration for :ref:`slow start mode <arch_overview_load_balancing_slow_start>`.
    Protobuf type envoy.extensions.load_balancing_policies.common.v3.SlowStartConfig
    See Also:
    Serialized Form

    • Nested Class Summary

      Nested Classes 
      Modifier and Type Class Description
      static class  SlowStartConfig.Builder
      Configuration for :ref:`slow start mode <arch_overview_load_balancing_slow_start>`.

      • Nested classes/interfaces inherited from class com.google.protobuf.GeneratedMessageV3

        com.google.protobuf.GeneratedMessageV3.BuilderParent, com.google.protobuf.GeneratedMessageV3.ExtendableBuilder<MessageType extends com.google.protobuf.GeneratedMessageV3.ExtendableMessage,​BuilderType extends com.google.protobuf.GeneratedMessageV3.ExtendableBuilder<MessageType,​BuilderType>>, com.google.protobuf.GeneratedMessageV3.ExtendableMessage<MessageType extends com.google.protobuf.GeneratedMessageV3.ExtendableMessage>, com.google.protobuf.GeneratedMessageV3.ExtendableMessageOrBuilder<MessageType extends com.google.protobuf.GeneratedMessageV3.ExtendableMessage>, com.google.protobuf.GeneratedMessageV3.FieldAccessorTable, com.google.protobuf.GeneratedMessageV3.UnusedPrivateParameter

      • Nested classes/interfaces inherited from class com.google.protobuf.AbstractMessageLite

        com.google.protobuf.AbstractMessageLite.InternalOneOfEnum

    • Field Summary

      Fields 
      Modifier and Type Field Description
      static int AGGRESSION_FIELD_NUMBER  
      static int MIN_WEIGHT_PERCENT_FIELD_NUMBER  
      static int SLOW_START_WINDOW_FIELD_NUMBER  

      • Fields inherited from class com.google.protobuf.GeneratedMessageV3

        alwaysUseFieldBuilders, unknownFields

      • Fields inherited from class com.google.protobuf.AbstractMessage

        memoizedSize

      • Fields inherited from class com.google.protobuf.AbstractMessageLite

        memoizedHashCode

    • Field Detail

      • SLOW_START_WINDOW_FIELD_NUMBER

        public static final int SLOW_START_WINDOW_FIELD_NUMBER
        See Also:
        Constant Field Values

      • AGGRESSION_FIELD_NUMBER

        public static final int AGGRESSION_FIELD_NUMBER
        See Also:
        Constant Field Values

      • MIN_WEIGHT_PERCENT_FIELD_NUMBER

        public static final int MIN_WEIGHT_PERCENT_FIELD_NUMBER
        See Also:
        Constant Field Values

    • Method Detail

      • newInstance

        protected Object newInstance​(com.google.protobuf.GeneratedMessageV3.UnusedPrivateParameter unused)
        Overrides:
        newInstance in class com.google.protobuf.GeneratedMessageV3

      • getUnknownFields

        public final com.google.protobuf.UnknownFieldSet getUnknownFields()
        Specified by:
        getUnknownFields in interface com.google.protobuf.MessageOrBuilder
        Overrides:
        getUnknownFields in class com.google.protobuf.GeneratedMessageV3

      • getDescriptor

        public static final com.google.protobuf.Descriptors.Descriptor getDescriptor()

      • internalGetFieldAccessorTable

        protected com.google.protobuf.GeneratedMessageV3.FieldAccessorTable internalGetFieldAccessorTable()
        Specified by:
        internalGetFieldAccessorTable in class com.google.protobuf.GeneratedMessageV3

      • hasSlowStartWindow

        public boolean hasSlowStartWindow()
         Represents the size of slow start window.
 If set, the newly created host remains in slow start mode starting from its creation time
 for the duration of slow start window.
        .google.protobuf.Duration slow_start_window = 1;
        Specified by:
        hasSlowStartWindow in interface SlowStartConfigOrBuilder
        Returns:
        Whether the slowStartWindow field is set.

      • getSlowStartWindow

        public com.google.protobuf.Duration getSlowStartWindow()
         Represents the size of slow start window.
 If set, the newly created host remains in slow start mode starting from its creation time
 for the duration of slow start window.
        .google.protobuf.Duration slow_start_window = 1;
        Specified by:
        getSlowStartWindow in interface SlowStartConfigOrBuilder
        Returns:
        The slowStartWindow.

      • getSlowStartWindowOrBuilder

        public com.google.protobuf.DurationOrBuilder getSlowStartWindowOrBuilder()
         Represents the size of slow start window.
 If set, the newly created host remains in slow start mode starting from its creation time
 for the duration of slow start window.
        .google.protobuf.Duration slow_start_window = 1;
        Specified by:
        getSlowStartWindowOrBuilder in interface SlowStartConfigOrBuilder

      • hasAggression

        public boolean hasAggression()
         This parameter controls the speed of traffic increase over the slow start window. Defaults to 1.0,
 so that endpoint would get linearly increasing amount of traffic.
 When increasing the value for this parameter, the speed of traffic ramp-up increases non-linearly.
 The value of aggression parameter should be greater than 0.0.
 By tuning the parameter, is possible to achieve polynomial or exponential shape of ramp-up curve.
 During slow start window, effective weight of an endpoint would be scaled with time factor and aggression:
 ``new_weight = weight * max(min_weight_percent, time_factor ^ (1 / aggression))``,
 where ``time_factor=(time_since_start_seconds / slow_start_time_seconds)``.
 As time progresses, more and more traffic would be sent to endpoint, which is in slow start window.
 Once host exits slow start, time_factor and aggression no longer affect its weight.
        .envoy.config.core.v3.RuntimeDouble aggression = 2;
        Specified by:
        hasAggression in interface SlowStartConfigOrBuilder
        Returns:
        Whether the aggression field is set.

      • getAggression

        public RuntimeDouble getAggression()
         This parameter controls the speed of traffic increase over the slow start window. Defaults to 1.0,
 so that endpoint would get linearly increasing amount of traffic.
 When increasing the value for this parameter, the speed of traffic ramp-up increases non-linearly.
 The value of aggression parameter should be greater than 0.0.
 By tuning the parameter, is possible to achieve polynomial or exponential shape of ramp-up curve.
 During slow start window, effective weight of an endpoint would be scaled with time factor and aggression:
 ``new_weight = weight * max(min_weight_percent, time_factor ^ (1 / aggression))``,
 where ``time_factor=(time_since_start_seconds / slow_start_time_seconds)``.
 As time progresses, more and more traffic would be sent to endpoint, which is in slow start window.
 Once host exits slow start, time_factor and aggression no longer affect its weight.
        .envoy.config.core.v3.RuntimeDouble aggression = 2;
        Specified by:
        getAggression in interface SlowStartConfigOrBuilder
        Returns:
        The aggression.

      • getAggressionOrBuilder

        public RuntimeDoubleOrBuilder getAggressionOrBuilder()
         This parameter controls the speed of traffic increase over the slow start window. Defaults to 1.0,
 so that endpoint would get linearly increasing amount of traffic.
 When increasing the value for this parameter, the speed of traffic ramp-up increases non-linearly.
 The value of aggression parameter should be greater than 0.0.
 By tuning the parameter, is possible to achieve polynomial or exponential shape of ramp-up curve.
 During slow start window, effective weight of an endpoint would be scaled with time factor and aggression:
 ``new_weight = weight * max(min_weight_percent, time_factor ^ (1 / aggression))``,
 where ``time_factor=(time_since_start_seconds / slow_start_time_seconds)``.
 As time progresses, more and more traffic would be sent to endpoint, which is in slow start window.
 Once host exits slow start, time_factor and aggression no longer affect its weight.
        .envoy.config.core.v3.RuntimeDouble aggression = 2;
        Specified by:
        getAggressionOrBuilder in interface SlowStartConfigOrBuilder

      • hasMinWeightPercent

        public boolean hasMinWeightPercent()
         Configures the minimum percentage of origin weight that avoids too small new weight,
 which may cause endpoints in slow start mode receive no traffic in slow start window.
 If not specified, the default is 10%.
        .envoy.type.v3.Percent min_weight_percent = 3;
        Specified by:
        hasMinWeightPercent in interface SlowStartConfigOrBuilder
        Returns:
        Whether the minWeightPercent field is set.

      • getMinWeightPercent

        public Percent getMinWeightPercent()
         Configures the minimum percentage of origin weight that avoids too small new weight,
 which may cause endpoints in slow start mode receive no traffic in slow start window.
 If not specified, the default is 10%.
        .envoy.type.v3.Percent min_weight_percent = 3;
        Specified by:
        getMinWeightPercent in interface SlowStartConfigOrBuilder
        Returns:
        The minWeightPercent.

      • getMinWeightPercentOrBuilder

        public PercentOrBuilder getMinWeightPercentOrBuilder()
         Configures the minimum percentage of origin weight that avoids too small new weight,
 which may cause endpoints in slow start mode receive no traffic in slow start window.
 If not specified, the default is 10%.
        .envoy.type.v3.Percent min_weight_percent = 3;
        Specified by:
        getMinWeightPercentOrBuilder in interface SlowStartConfigOrBuilder

      • isInitialized

        public final boolean isInitialized()
        Specified by:
        isInitialized in interface com.google.protobuf.MessageLiteOrBuilder
        Overrides:
        isInitialized in class com.google.protobuf.GeneratedMessageV3

      • writeTo

        public void writeTo​(com.google.protobuf.CodedOutputStream output)
             throws IOException
        Specified by:
        writeTo in interface com.google.protobuf.MessageLite
        Overrides:
        writeTo in class com.google.protobuf.GeneratedMessageV3
        Throws:
        IOException

      • getSerializedSize

        public int getSerializedSize()
        Specified by:
        getSerializedSize in interface com.google.protobuf.MessageLite
        Overrides:
        getSerializedSize in class com.google.protobuf.GeneratedMessageV3

      • equals

        public boolean equals​(Object obj)
        Specified by:
        equals in interface com.google.protobuf.Message
        Overrides:
        equals in class com.google.protobuf.AbstractMessage

      • hashCode

        public int hashCode()
        Specified by:
        hashCode in interface com.google.protobuf.Message
        Overrides:
        hashCode in class com.google.protobuf.AbstractMessage

      • parseFrom

        public static SlowStartConfig parseFrom​(ByteBuffer data)
                                 throws com.google.protobuf.InvalidProtocolBufferException
        Throws:
        com.google.protobuf.InvalidProtocolBufferException

      • parseFrom

        public static SlowStartConfig parseFrom​(ByteBuffer data,
                                        com.google.protobuf.ExtensionRegistryLite extensionRegistry)
                                 throws com.google.protobuf.InvalidProtocolBufferException
        Throws:
        com.google.protobuf.InvalidProtocolBufferException

      • parseFrom

        public static SlowStartConfig parseFrom​(com.google.protobuf.ByteString data)
                                 throws com.google.protobuf.InvalidProtocolBufferException
        Throws:
        com.google.protobuf.InvalidProtocolBufferException

      • parseFrom

        public static SlowStartConfig parseFrom​(com.google.protobuf.ByteString data,
                                        com.google.protobuf.ExtensionRegistryLite extensionRegistry)
                                 throws com.google.protobuf.InvalidProtocolBufferException
        Throws:
        com.google.protobuf.InvalidProtocolBufferException

      • parseFrom

        public static SlowStartConfig parseFrom​(byte[] data)
                                 throws com.google.protobuf.InvalidProtocolBufferException
        Throws:
        com.google.protobuf.InvalidProtocolBufferException

      • parseFrom

        public static SlowStartConfig parseFrom​(byte[] data,
                                        com.google.protobuf.ExtensionRegistryLite extensionRegistry)
                                 throws com.google.protobuf.InvalidProtocolBufferException
        Throws:
        com.google.protobuf.InvalidProtocolBufferException

      • parseFrom

        public static SlowStartConfig parseFrom​(com.google.protobuf.CodedInputStream input,
                                        com.google.protobuf.ExtensionRegistryLite extensionRegistry)
                                 throws IOException
        Throws:
        IOException

      • newBuilderForType

        public SlowStartConfig.Builder newBuilderForType()
        Specified by:
        newBuilderForType in interface com.google.protobuf.Message
        Specified by:
        newBuilderForType in interface com.google.protobuf.MessageLite

      • toBuilder

        public SlowStartConfig.Builder toBuilder()
        Specified by:
        toBuilder in interface com.google.protobuf.Message
        Specified by:
        toBuilder in interface com.google.protobuf.MessageLite

      • newBuilderForType

        protected SlowStartConfig.Builder newBuilderForType​(com.google.protobuf.GeneratedMessageV3.BuilderParent parent)
        Specified by:
        newBuilderForType in class com.google.protobuf.GeneratedMessageV3

      • parser

        public static com.google.protobuf.Parser<SlowStartConfig> parser()

      • getParserForType

        public com.google.protobuf.Parser<SlowStartConfig> getParserForType()
        Specified by:
        getParserForType in interface com.google.protobuf.Message
        Specified by:
        getParserForType in interface com.google.protobuf.MessageLite
        Overrides:
        getParserForType in class com.google.protobuf.GeneratedMessageV3

      • getDefaultInstanceForType

        public SlowStartConfig getDefaultInstanceForType()
        Specified by:
        getDefaultInstanceForType in interface com.google.protobuf.MessageLiteOrBuilder
        Specified by:
        getDefaultInstanceForType in interface com.google.protobuf.MessageOrBuilder