public static final class RouteAction.RequestMirrorPolicy.Builder extends com.google.protobuf.GeneratedMessageV3.Builder<RouteAction.RequestMirrorPolicy.Builder> implements RouteAction.RequestMirrorPolicyOrBuilder
The router is capable of shadowing traffic from one cluster to another. The current implementation is "fire and forget," meaning Envoy will not wait for the shadow cluster to respond before returning the response from the primary cluster. All normal statistics are collected for the shadow cluster making this feature useful for testing. During shadowing, the host/authority header is altered such that *-shadow* is appended. This is useful for logging. For example, *cluster1* becomes *cluster1-shadow*. .. note:: Shadowing will not be triggered if the primary cluster does not exist.Protobuf type
envoy.config.route.v4alpha.RouteAction.RequestMirrorPolicy| Modifier and Type | Method and Description |
|---|---|
RouteAction.RequestMirrorPolicy.Builder |
addRepeatedField(com.google.protobuf.Descriptors.FieldDescriptor field,
Object value) |
RouteAction.RequestMirrorPolicy |
build() |
RouteAction.RequestMirrorPolicy |
buildPartial() |
RouteAction.RequestMirrorPolicy.Builder |
clear() |
RouteAction.RequestMirrorPolicy.Builder |
clearCluster()
Specifies the cluster that requests will be mirrored to.
|
RouteAction.RequestMirrorPolicy.Builder |
clearField(com.google.protobuf.Descriptors.FieldDescriptor field) |
RouteAction.RequestMirrorPolicy.Builder |
clearOneof(com.google.protobuf.Descriptors.OneofDescriptor oneof) |
RouteAction.RequestMirrorPolicy.Builder |
clearRuntimeFraction()
If not specified, all requests to the target cluster will be mirrored.
|
RouteAction.RequestMirrorPolicy.Builder |
clearTraceSampled()
Determines if the trace span should be sampled.
|
RouteAction.RequestMirrorPolicy.Builder |
clone() |
String |
getCluster()
Specifies the cluster that requests will be mirrored to.
|
com.google.protobuf.ByteString |
getClusterBytes()
Specifies the cluster that requests will be mirrored to.
|
RouteAction.RequestMirrorPolicy |
getDefaultInstanceForType() |
static com.google.protobuf.Descriptors.Descriptor |
getDescriptor() |
com.google.protobuf.Descriptors.Descriptor |
getDescriptorForType() |
RuntimeFractionalPercent |
getRuntimeFraction()
If not specified, all requests to the target cluster will be mirrored.
|
RuntimeFractionalPercent.Builder |
getRuntimeFractionBuilder()
If not specified, all requests to the target cluster will be mirrored.
|
RuntimeFractionalPercentOrBuilder |
getRuntimeFractionOrBuilder()
If not specified, all requests to the target cluster will be mirrored.
|
com.google.protobuf.BoolValue |
getTraceSampled()
Determines if the trace span should be sampled.
|
com.google.protobuf.BoolValue.Builder |
getTraceSampledBuilder()
Determines if the trace span should be sampled.
|
com.google.protobuf.BoolValueOrBuilder |
getTraceSampledOrBuilder()
Determines if the trace span should be sampled.
|
boolean |
hasRuntimeFraction()
If not specified, all requests to the target cluster will be mirrored.
|
boolean |
hasTraceSampled()
Determines if the trace span should be sampled.
|
protected com.google.protobuf.GeneratedMessageV3.FieldAccessorTable |
internalGetFieldAccessorTable() |
boolean |
isInitialized() |
RouteAction.RequestMirrorPolicy.Builder |
mergeFrom(com.google.protobuf.CodedInputStream input,
com.google.protobuf.ExtensionRegistryLite extensionRegistry) |
RouteAction.RequestMirrorPolicy.Builder |
mergeFrom(com.google.protobuf.Message other) |
RouteAction.RequestMirrorPolicy.Builder |
mergeFrom(RouteAction.RequestMirrorPolicy other) |
RouteAction.RequestMirrorPolicy.Builder |
mergeRuntimeFraction(RuntimeFractionalPercent value)
If not specified, all requests to the target cluster will be mirrored.
|
RouteAction.RequestMirrorPolicy.Builder |
mergeTraceSampled(com.google.protobuf.BoolValue value)
Determines if the trace span should be sampled.
|
RouteAction.RequestMirrorPolicy.Builder |
mergeUnknownFields(com.google.protobuf.UnknownFieldSet unknownFields) |
RouteAction.RequestMirrorPolicy.Builder |
setCluster(String value)
Specifies the cluster that requests will be mirrored to.
|
RouteAction.RequestMirrorPolicy.Builder |
setClusterBytes(com.google.protobuf.ByteString value)
Specifies the cluster that requests will be mirrored to.
|
RouteAction.RequestMirrorPolicy.Builder |
setField(com.google.protobuf.Descriptors.FieldDescriptor field,
Object value) |
RouteAction.RequestMirrorPolicy.Builder |
setRepeatedField(com.google.protobuf.Descriptors.FieldDescriptor field,
int index,
Object value) |
RouteAction.RequestMirrorPolicy.Builder |
setRuntimeFraction(RuntimeFractionalPercent.Builder builderForValue)
If not specified, all requests to the target cluster will be mirrored.
|
RouteAction.RequestMirrorPolicy.Builder |
setRuntimeFraction(RuntimeFractionalPercent value)
If not specified, all requests to the target cluster will be mirrored.
|
RouteAction.RequestMirrorPolicy.Builder |
setTraceSampled(com.google.protobuf.BoolValue.Builder builderForValue)
Determines if the trace span should be sampled.
|
RouteAction.RequestMirrorPolicy.Builder |
setTraceSampled(com.google.protobuf.BoolValue value)
Determines if the trace span should be sampled.
|
RouteAction.RequestMirrorPolicy.Builder |
setUnknownFields(com.google.protobuf.UnknownFieldSet unknownFields) |
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<RouteAction.RequestMirrorPolicy.Builder>public RouteAction.RequestMirrorPolicy.Builder clear()
clear in interface com.google.protobuf.Message.Builderclear in interface com.google.protobuf.MessageLite.Builderclear in class com.google.protobuf.GeneratedMessageV3.Builder<RouteAction.RequestMirrorPolicy.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<RouteAction.RequestMirrorPolicy.Builder>public RouteAction.RequestMirrorPolicy getDefaultInstanceForType()
getDefaultInstanceForType in interface com.google.protobuf.MessageLiteOrBuildergetDefaultInstanceForType in interface com.google.protobuf.MessageOrBuilderpublic RouteAction.RequestMirrorPolicy build()
build in interface com.google.protobuf.Message.Builderbuild in interface com.google.protobuf.MessageLite.Builderpublic RouteAction.RequestMirrorPolicy buildPartial()
buildPartial in interface com.google.protobuf.Message.BuilderbuildPartial in interface com.google.protobuf.MessageLite.Builderpublic RouteAction.RequestMirrorPolicy.Builder clone()
clone in interface com.google.protobuf.Message.Builderclone in interface com.google.protobuf.MessageLite.Builderclone in class com.google.protobuf.GeneratedMessageV3.Builder<RouteAction.RequestMirrorPolicy.Builder>public RouteAction.RequestMirrorPolicy.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<RouteAction.RequestMirrorPolicy.Builder>public RouteAction.RequestMirrorPolicy.Builder clearField(com.google.protobuf.Descriptors.FieldDescriptor field)
clearField in interface com.google.protobuf.Message.BuilderclearField in class com.google.protobuf.GeneratedMessageV3.Builder<RouteAction.RequestMirrorPolicy.Builder>public RouteAction.RequestMirrorPolicy.Builder clearOneof(com.google.protobuf.Descriptors.OneofDescriptor oneof)
clearOneof in interface com.google.protobuf.Message.BuilderclearOneof in class com.google.protobuf.GeneratedMessageV3.Builder<RouteAction.RequestMirrorPolicy.Builder>public RouteAction.RequestMirrorPolicy.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<RouteAction.RequestMirrorPolicy.Builder>public RouteAction.RequestMirrorPolicy.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<RouteAction.RequestMirrorPolicy.Builder>public RouteAction.RequestMirrorPolicy.Builder mergeFrom(com.google.protobuf.Message other)
mergeFrom in interface com.google.protobuf.Message.BuildermergeFrom in class com.google.protobuf.AbstractMessage.Builder<RouteAction.RequestMirrorPolicy.Builder>public RouteAction.RequestMirrorPolicy.Builder mergeFrom(RouteAction.RequestMirrorPolicy other)
public final boolean isInitialized()
isInitialized in interface com.google.protobuf.MessageLiteOrBuilderisInitialized in class com.google.protobuf.GeneratedMessageV3.Builder<RouteAction.RequestMirrorPolicy.Builder>public RouteAction.RequestMirrorPolicy.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<RouteAction.RequestMirrorPolicy.Builder>IOExceptionpublic String getCluster()
Specifies the cluster that requests will be mirrored to. The cluster must exist in the cluster manager configuration.
string cluster = 1 [(.validate.rules) = { ... }getCluster in interface RouteAction.RequestMirrorPolicyOrBuilderpublic com.google.protobuf.ByteString getClusterBytes()
Specifies the cluster that requests will be mirrored to. The cluster must exist in the cluster manager configuration.
string cluster = 1 [(.validate.rules) = { ... }getClusterBytes in interface RouteAction.RequestMirrorPolicyOrBuilderpublic RouteAction.RequestMirrorPolicy.Builder setCluster(String value)
Specifies the cluster that requests will be mirrored to. The cluster must exist in the cluster manager configuration.
string cluster = 1 [(.validate.rules) = { ... }public RouteAction.RequestMirrorPolicy.Builder clearCluster()
Specifies the cluster that requests will be mirrored to. The cluster must exist in the cluster manager configuration.
string cluster = 1 [(.validate.rules) = { ... }public RouteAction.RequestMirrorPolicy.Builder setClusterBytes(com.google.protobuf.ByteString value)
Specifies the cluster that requests will be mirrored to. The cluster must exist in the cluster manager configuration.
string cluster = 1 [(.validate.rules) = { ... }public boolean hasRuntimeFraction()
If not specified, all requests to the target cluster will be mirrored. If specified, this field takes precedence over the `runtime_key` field and requests must also fall under the percentage of matches indicated by this field. For some fraction N/D, a random number in the range [0,D) is selected. If the number is <= the value of the numerator N, or if the key is not present, the default value, the request will be mirrored.
.envoy.config.core.v4alpha.RuntimeFractionalPercent runtime_fraction = 3;hasRuntimeFraction in interface RouteAction.RequestMirrorPolicyOrBuilderpublic RuntimeFractionalPercent getRuntimeFraction()
If not specified, all requests to the target cluster will be mirrored. If specified, this field takes precedence over the `runtime_key` field and requests must also fall under the percentage of matches indicated by this field. For some fraction N/D, a random number in the range [0,D) is selected. If the number is <= the value of the numerator N, or if the key is not present, the default value, the request will be mirrored.
.envoy.config.core.v4alpha.RuntimeFractionalPercent runtime_fraction = 3;getRuntimeFraction in interface RouteAction.RequestMirrorPolicyOrBuilderpublic RouteAction.RequestMirrorPolicy.Builder setRuntimeFraction(RuntimeFractionalPercent value)
If not specified, all requests to the target cluster will be mirrored. If specified, this field takes precedence over the `runtime_key` field and requests must also fall under the percentage of matches indicated by this field. For some fraction N/D, a random number in the range [0,D) is selected. If the number is <= the value of the numerator N, or if the key is not present, the default value, the request will be mirrored.
.envoy.config.core.v4alpha.RuntimeFractionalPercent runtime_fraction = 3;public RouteAction.RequestMirrorPolicy.Builder setRuntimeFraction(RuntimeFractionalPercent.Builder builderForValue)
If not specified, all requests to the target cluster will be mirrored. If specified, this field takes precedence over the `runtime_key` field and requests must also fall under the percentage of matches indicated by this field. For some fraction N/D, a random number in the range [0,D) is selected. If the number is <= the value of the numerator N, or if the key is not present, the default value, the request will be mirrored.
.envoy.config.core.v4alpha.RuntimeFractionalPercent runtime_fraction = 3;public RouteAction.RequestMirrorPolicy.Builder mergeRuntimeFraction(RuntimeFractionalPercent value)
If not specified, all requests to the target cluster will be mirrored. If specified, this field takes precedence over the `runtime_key` field and requests must also fall under the percentage of matches indicated by this field. For some fraction N/D, a random number in the range [0,D) is selected. If the number is <= the value of the numerator N, or if the key is not present, the default value, the request will be mirrored.
.envoy.config.core.v4alpha.RuntimeFractionalPercent runtime_fraction = 3;public RouteAction.RequestMirrorPolicy.Builder clearRuntimeFraction()
If not specified, all requests to the target cluster will be mirrored. If specified, this field takes precedence over the `runtime_key` field and requests must also fall under the percentage of matches indicated by this field. For some fraction N/D, a random number in the range [0,D) is selected. If the number is <= the value of the numerator N, or if the key is not present, the default value, the request will be mirrored.
.envoy.config.core.v4alpha.RuntimeFractionalPercent runtime_fraction = 3;public RuntimeFractionalPercent.Builder getRuntimeFractionBuilder()
If not specified, all requests to the target cluster will be mirrored. If specified, this field takes precedence over the `runtime_key` field and requests must also fall under the percentage of matches indicated by this field. For some fraction N/D, a random number in the range [0,D) is selected. If the number is <= the value of the numerator N, or if the key is not present, the default value, the request will be mirrored.
.envoy.config.core.v4alpha.RuntimeFractionalPercent runtime_fraction = 3;public RuntimeFractionalPercentOrBuilder getRuntimeFractionOrBuilder()
If not specified, all requests to the target cluster will be mirrored. If specified, this field takes precedence over the `runtime_key` field and requests must also fall under the percentage of matches indicated by this field. For some fraction N/D, a random number in the range [0,D) is selected. If the number is <= the value of the numerator N, or if the key is not present, the default value, the request will be mirrored.
.envoy.config.core.v4alpha.RuntimeFractionalPercent runtime_fraction = 3;getRuntimeFractionOrBuilder in interface RouteAction.RequestMirrorPolicyOrBuilderpublic boolean hasTraceSampled()
Determines if the trace span should be sampled. Defaults to true.
.google.protobuf.BoolValue trace_sampled = 4;hasTraceSampled in interface RouteAction.RequestMirrorPolicyOrBuilderpublic com.google.protobuf.BoolValue getTraceSampled()
Determines if the trace span should be sampled. Defaults to true.
.google.protobuf.BoolValue trace_sampled = 4;getTraceSampled in interface RouteAction.RequestMirrorPolicyOrBuilderpublic RouteAction.RequestMirrorPolicy.Builder setTraceSampled(com.google.protobuf.BoolValue value)
Determines if the trace span should be sampled. Defaults to true.
.google.protobuf.BoolValue trace_sampled = 4;public RouteAction.RequestMirrorPolicy.Builder setTraceSampled(com.google.protobuf.BoolValue.Builder builderForValue)
Determines if the trace span should be sampled. Defaults to true.
.google.protobuf.BoolValue trace_sampled = 4;public RouteAction.RequestMirrorPolicy.Builder mergeTraceSampled(com.google.protobuf.BoolValue value)
Determines if the trace span should be sampled. Defaults to true.
.google.protobuf.BoolValue trace_sampled = 4;public RouteAction.RequestMirrorPolicy.Builder clearTraceSampled()
Determines if the trace span should be sampled. Defaults to true.
.google.protobuf.BoolValue trace_sampled = 4;public com.google.protobuf.BoolValue.Builder getTraceSampledBuilder()
Determines if the trace span should be sampled. Defaults to true.
.google.protobuf.BoolValue trace_sampled = 4;public com.google.protobuf.BoolValueOrBuilder getTraceSampledOrBuilder()
Determines if the trace span should be sampled. Defaults to true.
.google.protobuf.BoolValue trace_sampled = 4;getTraceSampledOrBuilder in interface RouteAction.RequestMirrorPolicyOrBuilderpublic final RouteAction.RequestMirrorPolicy.Builder setUnknownFields(com.google.protobuf.UnknownFieldSet unknownFields)
setUnknownFields in interface com.google.protobuf.Message.BuildersetUnknownFields in class com.google.protobuf.GeneratedMessageV3.Builder<RouteAction.RequestMirrorPolicy.Builder>public final RouteAction.RequestMirrorPolicy.Builder mergeUnknownFields(com.google.protobuf.UnknownFieldSet unknownFields)
mergeUnknownFields in interface com.google.protobuf.Message.BuildermergeUnknownFields in class com.google.protobuf.GeneratedMessageV3.Builder<RouteAction.RequestMirrorPolicy.Builder>Copyright © 2018–2021 The Envoy Project. All rights reserved.