Skip to content

Commit

Permalink
Health checks (#1114)
Browse files Browse the repository at this point in the history
* health checks
* generated code
* finished first round of translator code
* finished unit tests
* grpc health checks work
* changelog
* merge master
* fixed formatting of changelog
* grpc health checks work properly
* generated code
* some reorg and fixed go version issues
* added envoy protos
* running proto validate on the health check fields
* validating outlier detection config
* now e2e validatin health checks and outlier detection
* generated code
* merge with master
* update changelog
* Merge branch 'master' of github.com:solo-io/gloo into health-checks
* added a readme, and fixed nit
  • Loading branch information
EItanya authored and soloio-bulldozer[bot] committed Sep 6, 2019
1 parent a97a5ce commit ad45e01
Show file tree
Hide file tree
Showing 43 changed files with 3,652 additions and 352 deletions.
11 changes: 7 additions & 4 deletions Gopkg.lock

Some generated files are not rendered by default. Learn more about how customized files appear on GitHub.

5 changes: 5 additions & 0 deletions Gopkg.toml
Original file line number Diff line number Diff line change
Expand Up @@ -90,6 +90,11 @@
name = "golang.org/x/net"
revision = "aaf60122140d3fcf75376d319f0554393160eb50"

# added to support knative v0.8.0
[[override]]
name = "golang.org/x/xerrors"
revision = "a985d3407aa71f30cf86696ee0a2f409709f22e1"

[[override]]
name = "k8s.io/klog"
revision = "9cbb78b20423182f9e5b2a214dd255f5e117d2d1"
Expand Down
4 changes: 4 additions & 0 deletions changelog/v0.18.36/health-checks.yaml
Original file line number Diff line number Diff line change
@@ -0,0 +1,4 @@
changelog:
- type: NEW_FEATURE
description: Add support for envoy health checks
issueLink: https://github.com/solo-io/gloo/issues/1113
Original file line number Diff line number Diff line change
@@ -0,0 +1,75 @@

---
title: "outlier_detection.proto"
weight: 5
---

<!-- Code generated by solo-kit. DO NOT EDIT. -->


### Package: `envoy.api.v2.cluster`
#### Types:


- [OutlierDetection](#outlierdetection)




##### Source File: [github.com/solo-io/gloo/projects/gloo/api/external/envoy/api/v2/cluster/outlier_detection.proto](https://github.com/solo-io/gloo/blob/master/projects/gloo/api/external/envoy/api/v2/cluster/outlier_detection.proto)





---
### OutlierDetection


See the :ref:`architecture overview <arch_overview_outlier_detection>` for
more information on outlier detection.

```yaml
"consecutive5xx": .google.protobuf.UInt32Value
"interval": .google.protobuf.Duration
"baseEjectionTime": .google.protobuf.Duration
"maxEjectionPercent": .google.protobuf.UInt32Value
"enforcingConsecutive5xx": .google.protobuf.UInt32Value
"enforcingSuccessRate": .google.protobuf.UInt32Value
"successRateMinimumHosts": .google.protobuf.UInt32Value
"successRateRequestVolume": .google.protobuf.UInt32Value
"successRateStdevFactor": .google.protobuf.UInt32Value
"consecutiveGatewayFailure": .google.protobuf.UInt32Value
"enforcingConsecutiveGatewayFailure": .google.protobuf.UInt32Value
"splitExternalLocalOriginErrors": bool
"consecutiveLocalOriginFailure": .google.protobuf.UInt32Value
"enforcingConsecutiveLocalOriginFailure": .google.protobuf.UInt32Value
"enforcingLocalOriginSuccessRate": .google.protobuf.UInt32Value

```
| Field | Type | Description | Default |
| ----- | ---- | ----------- |----------- |
| `consecutive5xx` | [.google.protobuf.UInt32Value](https://developers.google.com/protocol-buffers/docs/reference/csharp/class/google/protobuf/well-known-types/u-int-32-value) | The number of consecutive 5xx responses or local origin errors that are mapped to 5xx error codes before a consecutive 5xx ejection occurs. Defaults to 5. | |
| `interval` | [.google.protobuf.Duration](https://developers.google.com/protocol-buffers/docs/reference/csharp/class/google/protobuf/well-known-types/duration) | The time interval between ejection analysis sweeps. This can result in both new ejections as well as hosts being returned to service. Defaults to 10000ms or 10s. | |
| `baseEjectionTime` | [.google.protobuf.Duration](https://developers.google.com/protocol-buffers/docs/reference/csharp/class/google/protobuf/well-known-types/duration) | The base time that a host is ejected for. The real time is equal to the base time multiplied by the number of times the host has been ejected. Defaults to 30000ms or 30s. | |
| `maxEjectionPercent` | [.google.protobuf.UInt32Value](https://developers.google.com/protocol-buffers/docs/reference/csharp/class/google/protobuf/well-known-types/u-int-32-value) | The maximum % of an upstream cluster that can be ejected due to outlier detection. Defaults to 10% but will eject at least one host regardless of the value. | |
| `enforcingConsecutive5xx` | [.google.protobuf.UInt32Value](https://developers.google.com/protocol-buffers/docs/reference/csharp/class/google/protobuf/well-known-types/u-int-32-value) | The % chance that a host will be actually 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 100. | |
| `enforcingSuccessRate` | [.google.protobuf.UInt32Value](https://developers.google.com/protocol-buffers/docs/reference/csharp/class/google/protobuf/well-known-types/u-int-32-value) | The % chance that a host will be actually 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. | |
| `successRateMinimumHosts` | [.google.protobuf.UInt32Value](https://developers.google.com/protocol-buffers/docs/reference/csharp/class/google/protobuf/well-known-types/u-int-32-value) | The number of hosts in a cluster that must have enough request volume to detect success rate outliers. If the number of hosts is less than this setting, outlier detection via success rate statistics is not performed for any host in the cluster. Defaults to 5. | |
| `successRateRequestVolume` | [.google.protobuf.UInt32Value](https://developers.google.com/protocol-buffers/docs/reference/csharp/class/google/protobuf/well-known-types/u-int-32-value) | The minimum number of total requests that must be collected in one interval (as defined by the interval duration above) to include this host 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 host. Defaults to 100. | |
| `successRateStdevFactor` | [.google.protobuf.UInt32Value](https://developers.google.com/protocol-buffers/docs/reference/csharp/class/google/protobuf/well-known-types/u-int-32-value) | 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 * success_rate_stdev_factor). 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. | |
| `consecutiveGatewayFailure` | [.google.protobuf.UInt32Value](https://developers.google.com/protocol-buffers/docs/reference/csharp/class/google/protobuf/well-known-types/u-int-32-value) | The number of consecutive gateway failures (502, 503, 504 status codes) before a consecutive gateway failure ejection occurs. Defaults to 5. | |
| `enforcingConsecutiveGatewayFailure` | [.google.protobuf.UInt32Value](https://developers.google.com/protocol-buffers/docs/reference/csharp/class/google/protobuf/well-known-types/u-int-32-value) | The % chance that a host will be actually 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 0. | |
| `splitExternalLocalOriginErrors` | `bool` | Determines whether to distinguish local origin failures from external errors. If set to true the following configuration parameters are taken into account: :ref:`consecutive_local_origin_failure<envoy_api_field_cluster.OutlierDetection.consecutive_local_origin_failure>`, :ref:`enforcing_consecutive_local_origin_failure<envoy_api_field_cluster.OutlierDetection.enforcing_consecutive_local_origin_failure>` and :ref:`enforcing_local_origin_success_rate<envoy_api_field_cluster.OutlierDetection.enforcing_local_origin_success_rate>`. Defaults to false. | |
| `consecutiveLocalOriginFailure` | [.google.protobuf.UInt32Value](https://developers.google.com/protocol-buffers/docs/reference/csharp/class/google/protobuf/well-known-types/u-int-32-value) | The number of consecutive locally originated failures before ejection occurs. Defaults to 5. Parameter takes effect only when :ref:`split_external_local_origin_errors<envoy_api_field_cluster.OutlierDetection.split_external_local_origin_errors>` is set to true. | |
| `enforcingConsecutiveLocalOriginFailure` | [.google.protobuf.UInt32Value](https://developers.google.com/protocol-buffers/docs/reference/csharp/class/google/protobuf/well-known-types/u-int-32-value) | The % chance that a host will be actually ejected when an outlier status is detected through consecutive locally originated failures. This setting can be used to disable ejection or to ramp it up slowly. Defaults to 100. Parameter takes effect only when :ref:`split_external_local_origin_errors<envoy_api_field_cluster.OutlierDetection.split_external_local_origin_errors>` is set to true. | |
| `enforcingLocalOriginSuccessRate` | [.google.protobuf.UInt32Value](https://developers.google.com/protocol-buffers/docs/reference/csharp/class/google/protobuf/well-known-types/u-int-32-value) | The % chance that a host will be actually ejected when an outlier status is detected through success rate statistics for locally originated errors. This setting can be used to disable ejection or to ramp it up slowly. Defaults to 100. Parameter takes effect only when :ref:`split_external_local_origin_errors<envoy_api_field_cluster.OutlierDetection.split_external_local_origin_errors>` is set to true. | |





<!-- Start of HubSpot Embed Code -->
<script type="text/javascript" id="hs-script-loader" async defer src="//js.hs-scripts.com/5130874.js"></script>
<!-- End of HubSpot Embed Code -->
Loading

0 comments on commit ad45e01

Please sign in to comment.