envoy_extensions_filters_http_admission_control_v3alpha

package
v0.9.8 Latest Latest
Warning

This package is not in the latest version of its module.

Go to latest
Published: Jun 18, 2021 License: Apache-2.0 Imports: 24 Imported by: 0

Documentation

Index

Constants

This section is empty.

Variables

View Source
var File_envoy_extensions_filters_http_admission_control_v3alpha_admission_control_proto protoreflect.FileDescriptor

Functions

This section is empty.

Types

type AdmissionControl

type AdmissionControl struct {

	// If set to false, the admission control filter will operate as a pass-through filter. If the
	// message is unspecified, the filter will be enabled.
	Enabled *v3.RuntimeFeatureFlag `protobuf:"bytes,1,opt,name=enabled,proto3" json:"enabled,omitempty"`
	// Defines how a request is considered a success/failure.
	//
	// Types that are assignable to EvaluationCriteria:
	//	*AdmissionControl_SuccessCriteria_
	EvaluationCriteria isAdmissionControl_EvaluationCriteria `protobuf_oneof:"evaluation_criteria"`
	// The sliding time window over which the success rate is calculated. The window is rounded to the
	// nearest second. Defaults to 30s.
	SamplingWindow *duration.Duration `protobuf:"bytes,3,opt,name=sampling_window,json=samplingWindow,proto3" json:"sampling_window,omitempty"`
	// Rejection probability is defined by the formula::
	//
	//     max(0, (rq_count -  rq_success_count / sr_threshold) / (rq_count + 1)) ^ (1 / aggression)
	//
	// The aggression dictates how heavily the admission controller will throttle requests upon SR
	// dropping at or below the threshold. A value of 1 will result in a linear increase in
	// rejection probability as SR drops. Any values less than 1.0, will be set to 1.0. If the
	// message is unspecified, the aggression is 1.0. See `the admission control documentation
	// <https://www.envoyproxy.io/docs/envoy/latest/configuration/http/http_filters/admission_control_filter.html>`_
	// for a diagram illustrating this.
	Aggression *v3.RuntimeDouble `protobuf:"bytes,4,opt,name=aggression,proto3" json:"aggression,omitempty"`
	// Dictates the success rate at which the rejection probability is non-zero. As success rate drops
	// below this threshold, rejection probability will increase. Any success rate above the threshold
	// results in a rejection probability of 0. Defaults to 95%.
	SrThreshold *v3.RuntimePercent `protobuf:"bytes,5,opt,name=sr_threshold,json=srThreshold,proto3" json:"sr_threshold,omitempty"`
	// contains filtered or unexported fields
}

[#next-free-field: 6]

func (*AdmissionControl) Descriptor deprecated

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

Deprecated: Use AdmissionControl.ProtoReflect.Descriptor instead.

func (*AdmissionControl) GetAggression

func (x *AdmissionControl) GetAggression() *v3.RuntimeDouble

func (*AdmissionControl) GetEnabled

func (x *AdmissionControl) GetEnabled() *v3.RuntimeFeatureFlag

func (*AdmissionControl) GetEvaluationCriteria

func (m *AdmissionControl) GetEvaluationCriteria() isAdmissionControl_EvaluationCriteria

func (*AdmissionControl) GetSamplingWindow

func (x *AdmissionControl) GetSamplingWindow() *duration.Duration

func (*AdmissionControl) GetSrThreshold

func (x *AdmissionControl) GetSrThreshold() *v3.RuntimePercent

func (*AdmissionControl) GetSuccessCriteria

func (x *AdmissionControl) GetSuccessCriteria() *AdmissionControl_SuccessCriteria

func (*AdmissionControl) ProtoMessage

func (*AdmissionControl) ProtoMessage()

func (*AdmissionControl) ProtoReflect

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

func (*AdmissionControl) Reset

func (x *AdmissionControl) Reset()

func (*AdmissionControl) String

func (x *AdmissionControl) String() string

func (*AdmissionControl) Validate

func (m *AdmissionControl) Validate() error

Validate checks the field values on AdmissionControl with the rules defined in the proto definition for this message. If any rules are violated, an error is returned.

type AdmissionControlValidationError

type AdmissionControlValidationError struct {
	// contains filtered or unexported fields
}

AdmissionControlValidationError is the validation error returned by AdmissionControl.Validate if the designated constraints aren't met.

func (AdmissionControlValidationError) Cause

Cause function returns cause value.

func (AdmissionControlValidationError) Error

Error satisfies the builtin error interface

func (AdmissionControlValidationError) ErrorName

ErrorName returns error name.

func (AdmissionControlValidationError) Field

Field function returns field value.

func (AdmissionControlValidationError) Key

Key function returns key value.

func (AdmissionControlValidationError) Reason

Reason function returns reason value.

type AdmissionControl_SuccessCriteria

type AdmissionControl_SuccessCriteria struct {

	// If HTTP criteria are unspecified, all HTTP status codes below 500 are treated as successful
	// responses.
	//
	// .. note::
	//
	//    The default HTTP codes considered successful by the admission controller are done so due
	//    to the unlikelihood that sending fewer requests would change their behavior (for example:
	//    redirects, unauthorized access, or bad requests won't be alleviated by sending less
	//    traffic).
	HttpCriteria *AdmissionControl_SuccessCriteria_HttpCriteria `protobuf:"bytes,1,opt,name=http_criteria,json=httpCriteria,proto3" json:"http_criteria,omitempty"`
	// GRPC status codes to consider as request successes. If unspecified, defaults to: Ok,
	// Cancelled, Unknown, InvalidArgument, NotFound, AlreadyExists, Unauthenticated,
	// FailedPrecondition, OutOfRange, PermissionDenied, and Unimplemented.
	//
	// .. note::
	//
	//    The default gRPC codes that are considered successful by the admission controller are
	//    chosen because of the unlikelihood that sending fewer requests will change the behavior.
	GrpcCriteria *AdmissionControl_SuccessCriteria_GrpcCriteria `protobuf:"bytes,2,opt,name=grpc_criteria,json=grpcCriteria,proto3" json:"grpc_criteria,omitempty"`
	// contains filtered or unexported fields
}

Default method of specifying what constitutes a successful request. All status codes that indicate a successful request must be explicitly specified if not relying on the default values.

func (*AdmissionControl_SuccessCriteria) Descriptor deprecated

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

Deprecated: Use AdmissionControl_SuccessCriteria.ProtoReflect.Descriptor instead.

func (*AdmissionControl_SuccessCriteria) GetGrpcCriteria

func (*AdmissionControl_SuccessCriteria) GetHttpCriteria

func (*AdmissionControl_SuccessCriteria) ProtoMessage

func (*AdmissionControl_SuccessCriteria) ProtoMessage()

func (*AdmissionControl_SuccessCriteria) ProtoReflect

func (*AdmissionControl_SuccessCriteria) Reset

func (*AdmissionControl_SuccessCriteria) String

func (*AdmissionControl_SuccessCriteria) Validate

Validate checks the field values on AdmissionControl_SuccessCriteria with the rules defined in the proto definition for this message. If any rules are violated, an error is returned.

type AdmissionControl_SuccessCriteriaValidationError

type AdmissionControl_SuccessCriteriaValidationError struct {
	// contains filtered or unexported fields
}

AdmissionControl_SuccessCriteriaValidationError is the validation error returned by AdmissionControl_SuccessCriteria.Validate if the designated constraints aren't met.

func (AdmissionControl_SuccessCriteriaValidationError) Cause

Cause function returns cause value.

func (AdmissionControl_SuccessCriteriaValidationError) Error

Error satisfies the builtin error interface

func (AdmissionControl_SuccessCriteriaValidationError) ErrorName

ErrorName returns error name.

func (AdmissionControl_SuccessCriteriaValidationError) Field

Field function returns field value.

func (AdmissionControl_SuccessCriteriaValidationError) Key

Key function returns key value.

func (AdmissionControl_SuccessCriteriaValidationError) Reason

Reason function returns reason value.

type AdmissionControl_SuccessCriteria_

type AdmissionControl_SuccessCriteria_ struct {
	SuccessCriteria *AdmissionControl_SuccessCriteria `protobuf:"bytes,2,opt,name=success_criteria,json=successCriteria,proto3,oneof"`
}

type AdmissionControl_SuccessCriteria_GrpcCriteria

type AdmissionControl_SuccessCriteria_GrpcCriteria struct {

	// Status codes that constitute a successful request.
	// Mappings can be found at: https://github.com/grpc/grpc/blob/master/doc/statuscodes.md.
	GrpcSuccessStatus []uint32 `protobuf:"varint,1,rep,packed,name=grpc_success_status,json=grpcSuccessStatus,proto3" json:"grpc_success_status,omitempty"`
	// contains filtered or unexported fields
}

func (*AdmissionControl_SuccessCriteria_GrpcCriteria) Descriptor deprecated

Deprecated: Use AdmissionControl_SuccessCriteria_GrpcCriteria.ProtoReflect.Descriptor instead.

func (*AdmissionControl_SuccessCriteria_GrpcCriteria) GetGrpcSuccessStatus

func (x *AdmissionControl_SuccessCriteria_GrpcCriteria) GetGrpcSuccessStatus() []uint32

func (*AdmissionControl_SuccessCriteria_GrpcCriteria) ProtoMessage

func (*AdmissionControl_SuccessCriteria_GrpcCriteria) ProtoReflect

func (*AdmissionControl_SuccessCriteria_GrpcCriteria) Reset

func (*AdmissionControl_SuccessCriteria_GrpcCriteria) String

func (*AdmissionControl_SuccessCriteria_GrpcCriteria) Validate

Validate checks the field values on AdmissionControl_SuccessCriteria_GrpcCriteria with the rules defined in the proto definition for this message. If any rules are violated, an error is returned.

type AdmissionControl_SuccessCriteria_GrpcCriteriaValidationError

type AdmissionControl_SuccessCriteria_GrpcCriteriaValidationError struct {
	// contains filtered or unexported fields
}

AdmissionControl_SuccessCriteria_GrpcCriteriaValidationError is the validation error returned by AdmissionControl_SuccessCriteria_GrpcCriteria.Validate if the designated constraints aren't met.

func (AdmissionControl_SuccessCriteria_GrpcCriteriaValidationError) Cause

Cause function returns cause value.

func (AdmissionControl_SuccessCriteria_GrpcCriteriaValidationError) Error

Error satisfies the builtin error interface

func (AdmissionControl_SuccessCriteria_GrpcCriteriaValidationError) ErrorName

ErrorName returns error name.

func (AdmissionControl_SuccessCriteria_GrpcCriteriaValidationError) Field

Field function returns field value.

func (AdmissionControl_SuccessCriteria_GrpcCriteriaValidationError) Key

Key function returns key value.

func (AdmissionControl_SuccessCriteria_GrpcCriteriaValidationError) Reason

Reason function returns reason value.

type AdmissionControl_SuccessCriteria_HttpCriteria

type AdmissionControl_SuccessCriteria_HttpCriteria struct {

	// Status code ranges that constitute a successful request. Configurable codes are in the
	// range [100, 600).
	HttpSuccessStatus []*v31.Int32Range `protobuf:"bytes,1,rep,name=http_success_status,json=httpSuccessStatus,proto3" json:"http_success_status,omitempty"`
	// contains filtered or unexported fields
}

func (*AdmissionControl_SuccessCriteria_HttpCriteria) Descriptor deprecated

Deprecated: Use AdmissionControl_SuccessCriteria_HttpCriteria.ProtoReflect.Descriptor instead.

func (*AdmissionControl_SuccessCriteria_HttpCriteria) GetHttpSuccessStatus

func (x *AdmissionControl_SuccessCriteria_HttpCriteria) GetHttpSuccessStatus() []*v31.Int32Range

func (*AdmissionControl_SuccessCriteria_HttpCriteria) ProtoMessage

func (*AdmissionControl_SuccessCriteria_HttpCriteria) ProtoReflect

func (*AdmissionControl_SuccessCriteria_HttpCriteria) Reset

func (*AdmissionControl_SuccessCriteria_HttpCriteria) String

func (*AdmissionControl_SuccessCriteria_HttpCriteria) Validate

Validate checks the field values on AdmissionControl_SuccessCriteria_HttpCriteria with the rules defined in the proto definition for this message. If any rules are violated, an error is returned.

type AdmissionControl_SuccessCriteria_HttpCriteriaValidationError

type AdmissionControl_SuccessCriteria_HttpCriteriaValidationError struct {
	// contains filtered or unexported fields
}

AdmissionControl_SuccessCriteria_HttpCriteriaValidationError is the validation error returned by AdmissionControl_SuccessCriteria_HttpCriteria.Validate if the designated constraints aren't met.

func (AdmissionControl_SuccessCriteria_HttpCriteriaValidationError) Cause

Cause function returns cause value.

func (AdmissionControl_SuccessCriteria_HttpCriteriaValidationError) Error

Error satisfies the builtin error interface

func (AdmissionControl_SuccessCriteria_HttpCriteriaValidationError) ErrorName

ErrorName returns error name.

func (AdmissionControl_SuccessCriteria_HttpCriteriaValidationError) Field

Field function returns field value.

func (AdmissionControl_SuccessCriteria_HttpCriteriaValidationError) Key

Key function returns key value.

func (AdmissionControl_SuccessCriteria_HttpCriteriaValidationError) Reason

Reason function returns reason value.

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL