.. _envoy_v3_api_file_envoy/data/cluster/v3/outlier_detection_event.proto: Outlier detection logging events ================================ :ref:`Outlier detection logging `. .. _envoy_v3_api_msg_data.cluster.v3.OutlierDetectionEvent: data.cluster.v3.OutlierDetectionEvent ------------------------------------- `[data.cluster.v3.OutlierDetectionEvent proto] `_ .. code-block:: json { "type": "...", "timestamp": "{...}", "secs_since_last_action": "{...}", "cluster_name": "...", "upstream_url": "...", "action": "...", "num_ejections": "...", "enforced": "...", "eject_success_rate_event": "{...}", "eject_consecutive_event": "{...}", "eject_failure_percentage_event": "{...}" } .. _envoy_v3_api_field_data.cluster.v3.OutlierDetectionEvent.type: type (:ref:`data.cluster.v3.OutlierEjectionType `) In case of eject represents type of ejection that took place. .. _envoy_v3_api_field_data.cluster.v3.OutlierDetectionEvent.timestamp: timestamp (`Timestamp `_) Timestamp for event. .. _envoy_v3_api_field_data.cluster.v3.OutlierDetectionEvent.secs_since_last_action: secs_since_last_action (`UInt64Value `_) The time in seconds since the last action (either an ejection or unejection) took place. .. _envoy_v3_api_field_data.cluster.v3.OutlierDetectionEvent.cluster_name: cluster_name (`string `_, *REQUIRED*) The :ref:`cluster ` that owns the ejected host. .. _envoy_v3_api_field_data.cluster.v3.OutlierDetectionEvent.upstream_url: upstream_url (`string `_, *REQUIRED*) The URL of the ejected host. E.g., ``tcp://1.2.3.4:80``. .. _envoy_v3_api_field_data.cluster.v3.OutlierDetectionEvent.action: action (:ref:`data.cluster.v3.Action `) The action that took place. .. _envoy_v3_api_field_data.cluster.v3.OutlierDetectionEvent.num_ejections: num_ejections (`uint32 `_) If ``action`` is ``eject``, specifies the number of times the host has been ejected (local to that Envoy and gets reset if the host gets removed from the upstream cluster for any reason and then re-added). .. _envoy_v3_api_field_data.cluster.v3.OutlierDetectionEvent.enforced: enforced (`bool `_) If ``action`` is ``eject``, specifies if the ejection was enforced. ``true`` means the host was ejected. ``false`` means the event was logged but the host was not actually ejected. .. _envoy_v3_api_field_data.cluster.v3.OutlierDetectionEvent.eject_success_rate_event: eject_success_rate_event (:ref:`data.cluster.v3.OutlierEjectSuccessRate `) Precisely one of :ref:`eject_success_rate_event `, :ref:`eject_consecutive_event `, :ref:`eject_failure_percentage_event ` must be set. .. _envoy_v3_api_field_data.cluster.v3.OutlierDetectionEvent.eject_consecutive_event: eject_consecutive_event (:ref:`data.cluster.v3.OutlierEjectConsecutive `) Precisely one of :ref:`eject_success_rate_event `, :ref:`eject_consecutive_event `, :ref:`eject_failure_percentage_event ` must be set. .. _envoy_v3_api_field_data.cluster.v3.OutlierDetectionEvent.eject_failure_percentage_event: eject_failure_percentage_event (:ref:`data.cluster.v3.OutlierEjectFailurePercentage `) Precisely one of :ref:`eject_success_rate_event `, :ref:`eject_consecutive_event `, :ref:`eject_failure_percentage_event ` must be set. .. _envoy_v3_api_msg_data.cluster.v3.OutlierEjectSuccessRate: data.cluster.v3.OutlierEjectSuccessRate --------------------------------------- `[data.cluster.v3.OutlierEjectSuccessRate proto] `_ .. code-block:: json { "host_success_rate": "...", "cluster_average_success_rate": "...", "cluster_success_rate_ejection_threshold": "..." } .. _envoy_v3_api_field_data.cluster.v3.OutlierEjectSuccessRate.host_success_rate: host_success_rate (`uint32 `_) Host’s success rate at the time of the ejection event on a 0-100 range. .. _envoy_v3_api_field_data.cluster.v3.OutlierEjectSuccessRate.cluster_average_success_rate: cluster_average_success_rate (`uint32 `_) Average success rate of the hosts in the cluster at the time of the ejection event on a 0-100 range. .. _envoy_v3_api_field_data.cluster.v3.OutlierEjectSuccessRate.cluster_success_rate_ejection_threshold: cluster_success_rate_ejection_threshold (`uint32 `_) Success rate ejection threshold at the time of the ejection event. .. _envoy_v3_api_msg_data.cluster.v3.OutlierEjectConsecutive: data.cluster.v3.OutlierEjectConsecutive --------------------------------------- `[data.cluster.v3.OutlierEjectConsecutive proto] `_ .. code-block:: json {} .. _envoy_v3_api_msg_data.cluster.v3.OutlierEjectFailurePercentage: data.cluster.v3.OutlierEjectFailurePercentage --------------------------------------------- `[data.cluster.v3.OutlierEjectFailurePercentage proto] `_ .. code-block:: json { "host_success_rate": "..." } .. _envoy_v3_api_field_data.cluster.v3.OutlierEjectFailurePercentage.host_success_rate: host_success_rate (`uint32 `_) Host's success rate at the time of the ejection event on a 0-100 range. .. _envoy_v3_api_enum_data.cluster.v3.OutlierEjectionType: Enum data.cluster.v3.OutlierEjectionType ---------------------------------------- `[data.cluster.v3.OutlierEjectionType proto] `_ Type of ejection that took place .. _envoy_v3_api_enum_value_data.cluster.v3.OutlierEjectionType.CONSECUTIVE_5XX: CONSECUTIVE_5XX *(DEFAULT)* ⁣In case upstream host returns certain number of consecutive 5xx. If :ref:`outlier_detection.split_external_local_origin_errors` is *false*, all type of errors are treated as HTTP 5xx errors. See :ref:`Cluster outlier detection ` documentation for details. .. _envoy_v3_api_enum_value_data.cluster.v3.OutlierEjectionType.CONSECUTIVE_GATEWAY_FAILURE: CONSECUTIVE_GATEWAY_FAILURE ⁣In case upstream host returns certain number of consecutive gateway errors .. _envoy_v3_api_enum_value_data.cluster.v3.OutlierEjectionType.SUCCESS_RATE: SUCCESS_RATE ⁣Runs over aggregated success rate statistics from every host in cluster and selects hosts for which ratio of successful replies deviates from other hosts in the cluster. If :ref:`outlier_detection.split_external_local_origin_errors` is *false*, all errors (externally and locally generated) are used to calculate success rate statistics. See :ref:`Cluster outlier detection ` documentation for details. .. _envoy_v3_api_enum_value_data.cluster.v3.OutlierEjectionType.CONSECUTIVE_LOCAL_ORIGIN_FAILURE: CONSECUTIVE_LOCAL_ORIGIN_FAILURE ⁣Consecutive local origin failures: Connection failures, resets, timeouts, etc This type of ejection happens only when :ref:`outlier_detection.split_external_local_origin_errors` is set to *true*. See :ref:`Cluster outlier detection ` documentation for .. _envoy_v3_api_enum_value_data.cluster.v3.OutlierEjectionType.SUCCESS_RATE_LOCAL_ORIGIN: SUCCESS_RATE_LOCAL_ORIGIN ⁣Runs over aggregated success rate statistics for local origin failures for all hosts in the cluster and selects hosts for which success rate deviates from other hosts in the cluster. This type of ejection happens only when :ref:`outlier_detection.split_external_local_origin_errors` is set to *true*. See :ref:`Cluster outlier detection ` documentation for .. _envoy_v3_api_enum_value_data.cluster.v3.OutlierEjectionType.FAILURE_PERCENTAGE: FAILURE_PERCENTAGE ⁣Runs over aggregated success rate statistics from every host in cluster and selects hosts for which ratio of failed replies is above configured value. .. _envoy_v3_api_enum_value_data.cluster.v3.OutlierEjectionType.FAILURE_PERCENTAGE_LOCAL_ORIGIN: FAILURE_PERCENTAGE_LOCAL_ORIGIN ⁣Runs over aggregated success rate statistics for local origin failures from every host in cluster and selects hosts for which ratio of failed replies is above configured value. .. _envoy_v3_api_enum_data.cluster.v3.Action: Enum data.cluster.v3.Action --------------------------- `[data.cluster.v3.Action proto] `_ Represents possible action applied to upstream host .. _envoy_v3_api_enum_value_data.cluster.v3.Action.EJECT: EJECT *(DEFAULT)* ⁣In case host was excluded from service .. _envoy_v3_api_enum_value_data.cluster.v3.Action.UNEJECT: UNEJECT ⁣In case host was brought back into service