Class OutlierDetection (1.46.0)

public final class OutlierDetection extends GeneratedMessageV3 implements OutlierDetectionOrBuilder

Settings controlling the eviction of unhealthy hosts from the load balancing pool for the backend service.

Protobuf type google.cloud.compute.v1.OutlierDetection

Static Fields

BASE_EJECTION_TIME_FIELD_NUMBER

public static final int BASE_EJECTION_TIME_FIELD_NUMBER
Field Value
TypeDescription
int

CONSECUTIVE_ERRORS_FIELD_NUMBER

public static final int CONSECUTIVE_ERRORS_FIELD_NUMBER
Field Value
TypeDescription
int

CONSECUTIVE_GATEWAY_FAILURE_FIELD_NUMBER

public static final int CONSECUTIVE_GATEWAY_FAILURE_FIELD_NUMBER
Field Value
TypeDescription
int

ENFORCING_CONSECUTIVE_ERRORS_FIELD_NUMBER

public static final int ENFORCING_CONSECUTIVE_ERRORS_FIELD_NUMBER
Field Value
TypeDescription
int

ENFORCING_CONSECUTIVE_GATEWAY_FAILURE_FIELD_NUMBER

public static final int ENFORCING_CONSECUTIVE_GATEWAY_FAILURE_FIELD_NUMBER
Field Value
TypeDescription
int

ENFORCING_SUCCESS_RATE_FIELD_NUMBER

public static final int ENFORCING_SUCCESS_RATE_FIELD_NUMBER
Field Value
TypeDescription
int

INTERVAL_FIELD_NUMBER

public static final int INTERVAL_FIELD_NUMBER
Field Value
TypeDescription
int

MAX_EJECTION_PERCENT_FIELD_NUMBER

public static final int MAX_EJECTION_PERCENT_FIELD_NUMBER
Field Value
TypeDescription
int

SUCCESS_RATE_MINIMUM_HOSTS_FIELD_NUMBER

public static final int SUCCESS_RATE_MINIMUM_HOSTS_FIELD_NUMBER
Field Value
TypeDescription
int

SUCCESS_RATE_REQUEST_VOLUME_FIELD_NUMBER

public static final int SUCCESS_RATE_REQUEST_VOLUME_FIELD_NUMBER
Field Value
TypeDescription
int

SUCCESS_RATE_STDEV_FACTOR_FIELD_NUMBER

public static final int SUCCESS_RATE_STDEV_FACTOR_FIELD_NUMBER
Field Value
TypeDescription
int

Static Methods

getDefaultInstance()

public static OutlierDetection getDefaultInstance()
Returns
TypeDescription
OutlierDetection

getDescriptor()

public static final Descriptors.Descriptor getDescriptor()
Returns
TypeDescription
Descriptor

newBuilder()

public static OutlierDetection.Builder newBuilder()
Returns
TypeDescription
OutlierDetection.Builder

newBuilder(OutlierDetection prototype)

public static OutlierDetection.Builder newBuilder(OutlierDetection prototype)
Parameter
NameDescription
prototypeOutlierDetection
Returns
TypeDescription
OutlierDetection.Builder

parseDelimitedFrom(InputStream input)

public static OutlierDetection parseDelimitedFrom(InputStream input)
Parameter
NameDescription
inputInputStream
Returns
TypeDescription
OutlierDetection
Exceptions
TypeDescription
IOException

parseDelimitedFrom(InputStream input, ExtensionRegistryLite extensionRegistry)

public static OutlierDetection parseDelimitedFrom(InputStream input, ExtensionRegistryLite extensionRegistry)
Parameters
NameDescription
inputInputStream
extensionRegistryExtensionRegistryLite
Returns
TypeDescription
OutlierDetection
Exceptions
TypeDescription
IOException

parseFrom(byte[] data)

public static OutlierDetection parseFrom(byte[] data)
Parameter
NameDescription
databyte[]
Returns
TypeDescription
OutlierDetection
Exceptions
TypeDescription
InvalidProtocolBufferException

parseFrom(byte[] data, ExtensionRegistryLite extensionRegistry)

public static OutlierDetection parseFrom(byte[] data, ExtensionRegistryLite extensionRegistry)
Parameters
NameDescription
databyte[]
extensionRegistryExtensionRegistryLite
Returns
TypeDescription
OutlierDetection
Exceptions
TypeDescription
InvalidProtocolBufferException

parseFrom(ByteString data)

public static OutlierDetection parseFrom(ByteString data)
Parameter
NameDescription
dataByteString
Returns
TypeDescription
OutlierDetection
Exceptions
TypeDescription
InvalidProtocolBufferException

parseFrom(ByteString data, ExtensionRegistryLite extensionRegistry)

public static OutlierDetection parseFrom(ByteString data, ExtensionRegistryLite extensionRegistry)
Parameters
NameDescription
dataByteString
extensionRegistryExtensionRegistryLite
Returns
TypeDescription
OutlierDetection
Exceptions
TypeDescription
InvalidProtocolBufferException

parseFrom(CodedInputStream input)

public static OutlierDetection parseFrom(CodedInputStream input)
Parameter
NameDescription
inputCodedInputStream
Returns
TypeDescription
OutlierDetection
Exceptions
TypeDescription
IOException

parseFrom(CodedInputStream input, ExtensionRegistryLite extensionRegistry)

public static OutlierDetection parseFrom(CodedInputStream input, ExtensionRegistryLite extensionRegistry)
Parameters
NameDescription
inputCodedInputStream
extensionRegistryExtensionRegistryLite
Returns
TypeDescription
OutlierDetection
Exceptions
TypeDescription
IOException

parseFrom(InputStream input)

public static OutlierDetection parseFrom(InputStream input)
Parameter
NameDescription
inputInputStream
Returns
TypeDescription
OutlierDetection
Exceptions
TypeDescription
IOException

parseFrom(InputStream input, ExtensionRegistryLite extensionRegistry)

public static OutlierDetection parseFrom(InputStream input, ExtensionRegistryLite extensionRegistry)
Parameters
NameDescription
inputInputStream
extensionRegistryExtensionRegistryLite
Returns
TypeDescription
OutlierDetection
Exceptions
TypeDescription
IOException

parseFrom(ByteBuffer data)

public static OutlierDetection parseFrom(ByteBuffer data)
Parameter
NameDescription
dataByteBuffer
Returns
TypeDescription
OutlierDetection
Exceptions
TypeDescription
InvalidProtocolBufferException

parseFrom(ByteBuffer data, ExtensionRegistryLite extensionRegistry)

public static OutlierDetection parseFrom(ByteBuffer data, ExtensionRegistryLite extensionRegistry)
Parameters
NameDescription
dataByteBuffer
extensionRegistryExtensionRegistryLite
Returns
TypeDescription
OutlierDetection
Exceptions
TypeDescription
InvalidProtocolBufferException

parser()

public static Parser<OutlierDetection> parser()
Returns
TypeDescription
Parser<OutlierDetection>

Methods

equals(Object obj)

public boolean equals(Object obj)
Parameter
NameDescription
objObject
Returns
TypeDescription
boolean
Overrides

getBaseEjectionTime()

public Duration getBaseEjectionTime()

The base time that a backend endpoint is ejected for. Defaults to 30000ms or 30s. After a backend endpoint is returned back to the load balancing pool, it can be ejected again in another ejection analysis. Thus, the total ejection time is equal to the base ejection time multiplied by the number of times the backend endpoint has been ejected. Defaults to 30000ms or 30s.

optional .google.cloud.compute.v1.Duration base_ejection_time = 80997255;

Returns
TypeDescription
Duration

The baseEjectionTime.

getBaseEjectionTimeOrBuilder()

public DurationOrBuilder getBaseEjectionTimeOrBuilder()

The base time that a backend endpoint is ejected for. Defaults to 30000ms or 30s. After a backend endpoint is returned back to the load balancing pool, it can be ejected again in another ejection analysis. Thus, the total ejection time is equal to the base ejection time multiplied by the number of times the backend endpoint has been ejected. Defaults to 30000ms or 30s.

optional .google.cloud.compute.v1.Duration base_ejection_time = 80997255;

Returns
TypeDescription
DurationOrBuilder

getConsecutiveErrors()

public int getConsecutiveErrors()

Number of consecutive errors before a backend endpoint is ejected from the load balancing pool. When the backend endpoint is accessed over HTTP, a 5xx return code qualifies as an error. Defaults to 5.

optional int32 consecutive_errors = 387193248;

Returns
TypeDescription
int

The consecutiveErrors.

getConsecutiveGatewayFailure()

public int getConsecutiveGatewayFailure()

The number of consecutive gateway failures (502, 503, 504 status or connection errors that are mapped to one of those status codes) before a consecutive gateway failure ejection occurs. Defaults to 3.

optional int32 consecutive_gateway_failure = 417504250;

Returns
TypeDescription
int

The consecutiveGatewayFailure.

getDefaultInstanceForType()

public OutlierDetection getDefaultInstanceForType()
Returns
TypeDescription
OutlierDetection

getEnforcingConsecutiveErrors()

public int getEnforcingConsecutiveErrors()

The percentage chance that a backend endpoint will be ejected when an outlier status is detected through consecutive 5xx. This setting can be used to disable ejection or to ramp it up slowly. Defaults to 0.

optional int32 enforcing_consecutive_errors = 213133760;

Returns
TypeDescription
int

The enforcingConsecutiveErrors.

getEnforcingConsecutiveGatewayFailure()

public int getEnforcingConsecutiveGatewayFailure()

The percentage chance that a backend endpoint will be ejected when an outlier status is detected through consecutive gateway failures. This setting can be used to disable ejection or to ramp it up slowly. Defaults to 100.

optional int32 enforcing_consecutive_gateway_failure = 394440666;

Returns
TypeDescription
int

The enforcingConsecutiveGatewayFailure.

getEnforcingSuccessRate()

public int getEnforcingSuccessRate()

The percentage chance that a backend endpoint will be ejected when an outlier status is detected through success rate statistics. This setting can be used to disable ejection or to ramp it up slowly. Defaults to 100. Not supported when the backend service uses Serverless NEG.

optional int32 enforcing_success_rate = 194508732;

Returns
TypeDescription
int

The enforcingSuccessRate.

getInterval()

public Duration getInterval()

Time interval between ejection analysis sweeps. This can result in both new ejections and backend endpoints being returned to service. The interval is equal to the number of seconds as defined in outlierDetection.interval.seconds plus the number of nanoseconds as defined in outlierDetection.interval.nanos. Defaults to 1 second.

optional .google.cloud.compute.v1.Duration interval = 33547461;

Returns
TypeDescription
Duration

The interval.

getIntervalOrBuilder()

public DurationOrBuilder getIntervalOrBuilder()

Time interval between ejection analysis sweeps. This can result in both new ejections and backend endpoints being returned to service. The interval is equal to the number of seconds as defined in outlierDetection.interval.seconds plus the number of nanoseconds as defined in outlierDetection.interval.nanos. Defaults to 1 second.

optional .google.cloud.compute.v1.Duration interval = 33547461;

Returns
TypeDescription
DurationOrBuilder

getMaxEjectionPercent()

public int getMaxEjectionPercent()

Maximum percentage of backend endpoints in the load balancing pool for the backend service that can be ejected if the ejection conditions are met. Defaults to 50%.

optional int32 max_ejection_percent = 18436888;

Returns
TypeDescription
int

The maxEjectionPercent.

getParserForType()

public Parser<OutlierDetection> getParserForType()
Returns
TypeDescription
Parser<OutlierDetection>
Overrides

getSerializedSize()

public int getSerializedSize()
Returns
TypeDescription
int
Overrides

getSuccessRateMinimumHosts()

public int getSuccessRateMinimumHosts()

The number of backend endpoints in the load balancing pool that must have enough request volume to detect success rate outliers. If the number of backend endpoints is fewer than this setting, outlier detection via success rate statistics is not performed for any backend endpoint in the load balancing pool. Defaults to 5. Not supported when the backend service uses Serverless NEG.

optional int32 success_rate_minimum_hosts = 525766903;

Returns
TypeDescription
int

The successRateMinimumHosts.

getSuccessRateRequestVolume()

public int getSuccessRateRequestVolume()

The minimum number of total requests that must be collected in one interval (as defined by the interval duration above) to include this backend endpoint in success rate based outlier detection. If the volume is lower than this setting, outlier detection via success rate statistics is not performed for that backend endpoint. Defaults to 100. Not supported when the backend service uses Serverless NEG.

optional int32 success_rate_request_volume = 281425357;

Returns
TypeDescription
int

The successRateRequestVolume.

getSuccessRateStdevFactor()

public int getSuccessRateStdevFactor()

This factor is used to determine the ejection threshold for success rate outlier ejection. The ejection threshold is the difference between the mean success rate, and the product of this factor and the standard deviation of the mean success rate: mean - (stdev * successRateStdevFactor). This factor is divided by a thousand to get a double. That is, if the desired factor is 1.9, the runtime value should be 1900. Defaults to 1900. Not supported when the backend service uses Serverless NEG.

optional int32 success_rate_stdev_factor = 174735773;

Returns
TypeDescription
int

The successRateStdevFactor.

hasBaseEjectionTime()

public boolean hasBaseEjectionTime()

The base time that a backend endpoint is ejected for. Defaults to 30000ms or 30s. After a backend endpoint is returned back to the load balancing pool, it can be ejected again in another ejection analysis. Thus, the total ejection time is equal to the base ejection time multiplied by the number of times the backend endpoint has been ejected. Defaults to 30000ms or 30s.

optional .google.cloud.compute.v1.Duration base_ejection_time = 80997255;

Returns
TypeDescription
boolean

Whether the baseEjectionTime field is set.

hasConsecutiveErrors()

public boolean hasConsecutiveErrors()

Number of consecutive errors before a backend endpoint is ejected from the load balancing pool. When the backend endpoint is accessed over HTTP, a 5xx return code qualifies as an error. Defaults to 5.

optional int32 consecutive_errors = 387193248;

Returns
TypeDescription
boolean

Whether the consecutiveErrors field is set.

hasConsecutiveGatewayFailure()

public boolean hasConsecutiveGatewayFailure()

The number of consecutive gateway failures (502, 503, 504 status or connection errors that are mapped to one of those status codes) before a consecutive gateway failure ejection occurs. Defaults to 3.

optional int32 consecutive_gateway_failure = 417504250;

Returns
TypeDescription
boolean

Whether the consecutiveGatewayFailure field is set.

hasEnforcingConsecutiveErrors()

public boolean hasEnforcingConsecutiveErrors()

The percentage chance that a backend endpoint will be ejected when an outlier status is detected through consecutive 5xx. This setting can be used to disable ejection or to ramp it up slowly. Defaults to 0.

optional int32 enforcing_consecutive_errors = 213133760;

Returns
TypeDescription
boolean

Whether the enforcingConsecutiveErrors field is set.

hasEnforcingConsecutiveGatewayFailure()

public boolean hasEnforcingConsecutiveGatewayFailure()

The percentage chance that a backend endpoint will be ejected when an outlier status is detected through consecutive gateway failures. This setting can be used to disable ejection or to ramp it up slowly. Defaults to 100.

optional int32 enforcing_consecutive_gateway_failure = 394440666;

Returns
TypeDescription
boolean

Whether the enforcingConsecutiveGatewayFailure field is set.

hasEnforcingSuccessRate()

public boolean hasEnforcingSuccessRate()

The percentage chance that a backend endpoint will be ejected when an outlier status is detected through success rate statistics. This setting can be used to disable ejection or to ramp it up slowly. Defaults to 100. Not supported when the backend service uses Serverless NEG.

optional int32 enforcing_success_rate = 194508732;

Returns
TypeDescription
boolean

Whether the enforcingSuccessRate field is set.

hasInterval()

public boolean hasInterval()

Time interval between ejection analysis sweeps. This can result in both new ejections and backend endpoints being returned to service. The interval is equal to the number of seconds as defined in outlierDetection.interval.seconds plus the number of nanoseconds as defined in outlierDetection.interval.nanos. Defaults to 1 second.

optional .google.cloud.compute.v1.Duration interval = 33547461;

Returns
TypeDescription
boolean

Whether the interval field is set.

hasMaxEjectionPercent()

public boolean hasMaxEjectionPercent()

Maximum percentage of backend endpoints in the load balancing pool for the backend service that can be ejected if the ejection conditions are met. Defaults to 50%.

optional int32 max_ejection_percent = 18436888;

Returns
TypeDescription
boolean

Whether the maxEjectionPercent field is set.

hasSuccessRateMinimumHosts()

public boolean hasSuccessRateMinimumHosts()

The number of backend endpoints in the load balancing pool that must have enough request volume to detect success rate outliers. If the number of backend endpoints is fewer than this setting, outlier detection via success rate statistics is not performed for any backend endpoint in the load balancing pool. Defaults to 5. Not supported when the backend service uses Serverless NEG.

optional int32 success_rate_minimum_hosts = 525766903;

Returns
TypeDescription
boolean

Whether the successRateMinimumHosts field is set.

hasSuccessRateRequestVolume()

public boolean hasSuccessRateRequestVolume()

The minimum number of total requests that must be collected in one interval (as defined by the interval duration above) to include this backend endpoint in success rate based outlier detection. If the volume is lower than this setting, outlier detection via success rate statistics is not performed for that backend endpoint. Defaults to 100. Not supported when the backend service uses Serverless NEG.

optional int32 success_rate_request_volume = 281425357;

Returns
TypeDescription
boolean

Whether the successRateRequestVolume field is set.

hasSuccessRateStdevFactor()

public boolean hasSuccessRateStdevFactor()

This factor is used to determine the ejection threshold for success rate outlier ejection. The ejection threshold is the difference between the mean success rate, and the product of this factor and the standard deviation of the mean success rate: mean - (stdev * successRateStdevFactor). This factor is divided by a thousand to get a double. That is, if the desired factor is 1.9, the runtime value should be 1900. Defaults to 1900. Not supported when the backend service uses Serverless NEG.

optional int32 success_rate_stdev_factor = 174735773;

Returns
TypeDescription
boolean

Whether the successRateStdevFactor field is set.

hashCode()

public int hashCode()
Returns
TypeDescription
int
Overrides

internalGetFieldAccessorTable()

protected GeneratedMessageV3.FieldAccessorTable internalGetFieldAccessorTable()
Returns
TypeDescription
FieldAccessorTable
Overrides

isInitialized()

public final boolean isInitialized()
Returns
TypeDescription
boolean
Overrides

newBuilderForType()

public OutlierDetection.Builder newBuilderForType()
Returns
TypeDescription
OutlierDetection.Builder

newBuilderForType(GeneratedMessageV3.BuilderParent parent)

protected OutlierDetection.Builder newBuilderForType(GeneratedMessageV3.BuilderParent parent)
Parameter
NameDescription
parentBuilderParent
Returns
TypeDescription
OutlierDetection.Builder
Overrides

newInstance(GeneratedMessageV3.UnusedPrivateParameter unused)

protected Object newInstance(GeneratedMessageV3.UnusedPrivateParameter unused)
Parameter
NameDescription
unusedUnusedPrivateParameter
Returns
TypeDescription
Object
Overrides

toBuilder()

public OutlierDetection.Builder toBuilder()
Returns
TypeDescription
OutlierDetection.Builder

writeTo(CodedOutputStream output)

public void writeTo(CodedOutputStream output)
Parameter
NameDescription
outputCodedOutputStream
Overrides
Exceptions
TypeDescription
IOException