advanced_http

package
v1.18.0-beta4 Latest Latest
Warning

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

 Go to latest Published: Jun 28, 2024 License: Apache-2.0 Imports: 8 Imported by: 0

Documentation

Index

Constants

This section is empty.

Variables

View Source 
var (
	HealthCheckResult_name = map[int32]string{
		0: "healthy",
		1: "degraded",
		2: "unhealthy",
	}
	HealthCheckResult_value = map[string]int32{
		"healthy":   0,
		"degraded":  1,
		"unhealthy": 2,
	}
)

Enum value maps for HealthCheckResult.

View Source 
var File_github_com_solo_io_gloo_projects_gloo_api_external_envoy_extensions_advanced_http_advanced_http_proto protoreflect.FileDescriptor

Functions

This section is empty.

Types

type AdvancedHttp 

type AdvancedHttp struct {

	// Http health check.
	HttpHealthCheck *v3.HealthCheck_HttpHealthCheck `protobuf:"bytes,1,opt,name=http_health_check,json=httpHealthCheck,proto3" json:"http_health_check,omitempty"`
	// If defined, the response health check rules take precedence over the http status
	// settings defined in `http_health_check`
	ResponseAssertions *ResponseAssertions `protobuf:"bytes,2,opt,name=response_assertions,json=responseAssertions,proto3" json:"response_assertions,omitempty"`
	// contains filtered or unexported fields
}

Same as envoy's default HTTP health checker, but with some additions:

  • allows a custom path and method on the health check request per endpoint. The http path to use can be overridden using endpoint metadata. The endpoint-specific path should be in the "io.solo.health_checkers.advanced_http" namespace, under a string value named "path". The same can be done for the method by setting a string value named "method".
  • allows for health check responses to leverage the response body rather than just the http status code returned. The response body can be parsed as json and complex assertions can be made on fields parsed from the json or plaintext response body.

func (*AdvancedHttp) Descriptor deprecated 

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

Deprecated: Use AdvancedHttp.ProtoReflect.Descriptor instead.

func (*AdvancedHttp) GetHttpHealthCheck 

func (x *AdvancedHttp) GetHttpHealthCheck() *v3.HealthCheck_HttpHealthCheck

func (*AdvancedHttp) GetResponseAssertions 

func (x *AdvancedHttp) GetResponseAssertions() *ResponseAssertions

func (*AdvancedHttp) ProtoMessage 

func (*AdvancedHttp) ProtoMessage()

func (*AdvancedHttp) ProtoReflect 

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

func (*AdvancedHttp) Reset 

func (x *AdvancedHttp) Reset()

func (*AdvancedHttp) String 

func (x *AdvancedHttp) String() string

type HealthCheckResult 

type HealthCheckResult int32
const (
	HealthCheckResult_healthy   HealthCheckResult = 0
	HealthCheckResult_degraded  HealthCheckResult = 1
	HealthCheckResult_unhealthy HealthCheckResult = 2
)

func (HealthCheckResult) Descriptor 

func (HealthCheckResult) Descriptor() protoreflect.EnumDescriptor

func (HealthCheckResult) Enum 

func (x HealthCheckResult) Enum() *HealthCheckResult

func (HealthCheckResult) EnumDescriptor deprecated 

func (HealthCheckResult) EnumDescriptor() ([]byte, []int)

Deprecated: Use HealthCheckResult.Descriptor instead.

func (HealthCheckResult) Number 

func (x HealthCheckResult) Number() protoreflect.EnumNumber

func (HealthCheckResult) String 

func (x HealthCheckResult) String() string

func (HealthCheckResult) Type 

func (HealthCheckResult) Type() protoreflect.EnumType

type JsonKey 

type JsonKey struct {

	// The path to retrieve the Value.
	Path []*JsonKey_PathSegment `protobuf:"bytes,2,rep,name=path,proto3" json:"path,omitempty"`
	// contains filtered or unexported fields
}

func (*JsonKey) Descriptor deprecated 

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

Deprecated: Use JsonKey.ProtoReflect.Descriptor instead.

func (*JsonKey) GetPath 

func (x *JsonKey) GetPath() []*JsonKey_PathSegment

func (*JsonKey) ProtoMessage 

func (*JsonKey) ProtoMessage()

func (*JsonKey) ProtoReflect 

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

func (*JsonKey) Reset 

func (x *JsonKey) Reset()

func (*JsonKey) String 

func (x *JsonKey) String() string

type JsonKey_PathSegment 

type JsonKey_PathSegment struct {

	// Types that are assignable to Segment:
	//
	//	*JsonKey_PathSegment_Key
	Segment isJsonKey_PathSegment_Segment `protobuf_oneof:"segment"`
	// contains filtered or unexported fields
}

Specifies the segment in a path to retrieve value.

func (*JsonKey_PathSegment) Descriptor deprecated 

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

Deprecated: Use JsonKey_PathSegment.ProtoReflect.Descriptor instead.

func (*JsonKey_PathSegment) GetKey 

func (x *JsonKey_PathSegment) GetKey() string

func (*JsonKey_PathSegment) GetSegment 

func (m *JsonKey_PathSegment) GetSegment() isJsonKey_PathSegment_Segment

func (*JsonKey_PathSegment) ProtoMessage 

func (*JsonKey_PathSegment) ProtoMessage()

func (*JsonKey_PathSegment) ProtoReflect 

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

func (*JsonKey_PathSegment) Reset 

func (x *JsonKey_PathSegment) Reset()

func (*JsonKey_PathSegment) String 

func (x *JsonKey_PathSegment) String() string

type JsonKey_PathSegment_Key 

type JsonKey_PathSegment_Key struct {
	// If specified, use the key to retrieve the value.
	// If the key is not found, the value defaults to empty string.
	Key string `protobuf:"bytes,1,opt,name=key,proto3,oneof"`
}

type ResponseAssertions 

type ResponseAssertions struct {

	// A bunch of match rules, the first match wins out and short-circuits
	ResponseMatchers []*ResponseMatcher `protobuf:"bytes,1,rep,name=response_matchers,json=responseMatchers,proto3" json:"response_matchers,omitempty"`
	// The default health response if none of the response health checks were matches.
	// If omitted, defaults to healthy.
	// Note for devs: we'd probably prefer this default to unhealthy, but since the
	// version of protoc we're on doesn't support optional scalars without an
	// experimental flag, we cannot have the `no_match_health` field default to
	// unhealthy while the `match_health` field defaults to healthy.
	//
	// As such, we offload this defaulting behavior to the control plane.
	// For more reading, see https://github.com/protocolbuffers/protobuf/issues/1606#issuecomment-618687169
	NoMatchHealth HealthCheckResult `` /* 171-byte string literal not displayed */
	// contains filtered or unexported fields
}

func (*ResponseAssertions) Descriptor deprecated 

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

Deprecated: Use ResponseAssertions.ProtoReflect.Descriptor instead.

func (*ResponseAssertions) GetNoMatchHealth 

func (x *ResponseAssertions) GetNoMatchHealth() HealthCheckResult

func (*ResponseAssertions) GetResponseMatchers 

func (x *ResponseAssertions) GetResponseMatchers() []*ResponseMatcher

func (*ResponseAssertions) ProtoMessage 

func (*ResponseAssertions) ProtoMessage()

func (*ResponseAssertions) ProtoReflect 

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

func (*ResponseAssertions) Reset 

func (x *ResponseAssertions) Reset()

func (*ResponseAssertions) String 

func (x *ResponseAssertions) String() string

type ResponseMatch 

type ResponseMatch struct {

	// Configuration to get the json key.
	// Treats the body as raw text if omitted.
	JsonKey *JsonKey `protobuf:"bytes,1,opt,name=json_key,json=jsonKey,proto3" json:"json_key,omitempty"`
	// If set to true, Envoy will not throw an exception in case the json body parsing
	// fails.
	IgnoreErrorOnParse bool `protobuf:"varint,2,opt,name=ignore_error_on_parse,json=ignoreErrorOnParse,proto3" json:"ignore_error_on_parse,omitempty"`
	// The source of the extraction
	//
	// Types that are assignable to Source:
	//
	//	*ResponseMatch_Header
	//	*ResponseMatch_Body
	Source isResponseMatch_Source `protobuf_oneof:"source"`
	// Only strings matching this regular expression will be considered a match.
	// The most simple value for this field is '.*', which matches the
	// whole source. The field is required.
	Regex string `protobuf:"bytes,5,opt,name=regex,proto3" json:"regex,omitempty"`
	// contains filtered or unexported fields
}

ResponseMatches can be used to extract information from the request/response.

func (*ResponseMatch) Descriptor deprecated 

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

Deprecated: Use ResponseMatch.ProtoReflect.Descriptor instead.

func (*ResponseMatch) GetBody 

func (x *ResponseMatch) GetBody() *empty.Empty

func (*ResponseMatch) GetHeader 

func (x *ResponseMatch) GetHeader() string

func (*ResponseMatch) GetIgnoreErrorOnParse 

func (x *ResponseMatch) GetIgnoreErrorOnParse() bool

func (*ResponseMatch) GetJsonKey 

func (x *ResponseMatch) GetJsonKey() *JsonKey

func (*ResponseMatch) GetRegex 

func (x *ResponseMatch) GetRegex() string

func (*ResponseMatch) GetSource 

func (m *ResponseMatch) GetSource() isResponseMatch_Source

func (*ResponseMatch) ProtoMessage 

func (*ResponseMatch) ProtoMessage()

func (*ResponseMatch) ProtoReflect 

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

func (*ResponseMatch) Reset 

func (x *ResponseMatch) Reset()

func (*ResponseMatch) String 

func (x *ResponseMatch) String() string

type ResponseMatch_Body 

type ResponseMatch_Body struct {
	// Extract information from the request/response body
	Body *empty.Empty `protobuf:"bytes,4,opt,name=body,proto3,oneof"`
}

type ResponseMatch_Header 

type ResponseMatch_Header struct {
	// Extract information from headers
	Header string `protobuf:"bytes,3,opt,name=header,proto3,oneof"`
}

type ResponseMatcher 

type ResponseMatcher struct {

	// Defines the parameters to determine a single match
	ResponseMatch *ResponseMatch `protobuf:"bytes,1,opt,name=response_match,json=responseMatch,proto3" json:"response_match,omitempty"`
	// The health response if this response_match is a match.
	// If omitted, defaults to healthy
	MatchHealth HealthCheckResult `` /* 163-byte string literal not displayed */
	// contains filtered or unexported fields
}

Defines a transformation template.

func (*ResponseMatcher) Descriptor deprecated 

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

Deprecated: Use ResponseMatcher.ProtoReflect.Descriptor instead.

func (*ResponseMatcher) GetMatchHealth 

func (x *ResponseMatcher) GetMatchHealth() HealthCheckResult

func (*ResponseMatcher) GetResponseMatch 

func (x *ResponseMatcher) GetResponseMatch() *ResponseMatch

func (*ResponseMatcher) ProtoMessage 

func (*ResponseMatcher) ProtoMessage()

func (*ResponseMatcher) ProtoReflect 

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

func (*ResponseMatcher) Reset 

func (x *ResponseMatcher) Reset()

func (*ResponseMatcher) String 

func (x *ResponseMatcher) String() string

Source Files

View all Source files

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL
go.dev uses cookies from Google to deliver and enhance the quality of its services and to analyze traffic. Learn more.