55 lines
4.2 KiB
Markdown
55 lines
4.2 KiB
Markdown
|
# Envoy: outlier detection
|
|||
|
|
|
|||
|
|
[К материалам семинара](../readme.md)
|
|||
|
|
|
|||
|
|
В стенде работают Envoy и два бэкенда. Первый возвращает успешный ответ на `/`, второй с вероятностью 0.8 возвращает HTTP 500. Envoy наблюдает результаты обычных запросов и временно исключает проблемный бэкенд из балансировки. Это пассивное обнаружение: отдельные запросы проверки здоровья здесь не настроены.
|
|||
|
|
|
|||
|
|
## Запуск и наблюдение
|
|||
|
|
|
|||
|
|
Нужны Docker и Docker Compose. Выполните из этой директории:
|
|||
|
|
|
|||
|
|
```shell
|
|||
|
|
docker compose up --build -d
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
После запуска приложений несколько раз отправьте запрос через прокси и сравните с прямыми запросами:
|
|||
|
|
|
|||
|
|
```shell
|
|||
|
|
curl -i http://localhost:8080/
|
|||
|
|
curl -i http://localhost:9001/
|
|||
|
|
curl -i http://localhost:9002/
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
В PowerShell вместо `curl` используйте `curl.exe`. Ответы содержат версию бэкенда (`v1` или `v2`). Для опыта достаточно пути `/`; путь `/kittens` дополнительно обращается к внешнему API.
|
|||
|
|
|
|||
|
|
При повторных запросах через Envoy проблемный бэкенд временно исключается, а затем снова допускается к трафику. Прямые запросы к порту 9002 позволяют видеть, что процесс продолжает работать и возвращать ответы, в том числе ошибки. Последовательность случайна: по одному успешному ответу или короткой серии нельзя заключить, что бэкенд исключён.
|
|||
|
|
|
|||
|
|
## Что означают настройки
|
|||
|
|
|
|||
|
|
В [конфигурации Envoy](envoy.yaml) задано:
|
|||
|
|
|
|||
|
|
```yaml
|
|||
|
|
outlier_detection:
|
|||
|
|
consecutive_5xx: 2
|
|||
|
|
interval: "5s"
|
|||
|
|
base_ejection_time: "10s"
|
|||
|
|
max_ejection_percent: 100
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
- `consecutive_5xx`: исключение после двух последовательных ответов 5xx **от одного бэкенда**, наблюдаемых Envoy. Это не любые две ошибки во всём потоке запросов.
|
|||
|
|
- `interval`: период фонового анализа и проверки возврата исключённых бэкендов. Достижение порога последовательных ошибок обрабатывается при запросах, без ожидания следующего такого интервала.
|
|||
|
|
- `base_ejection_time`: базовая длительность исключения. При повторных исключениях срок может расти; возврат не гарантирован ровно через 10 секунд.
|
|||
|
|
- `max_ejection_percent`: разрешённая доля исключённых бэкендов. Значение 100 позволяет исключить все; это настройка данного учебного примера.
|
|||
|
|
|
|||
|
|
Исключение меняет маршрутизацию в данном прокси. Оно не останавливает бэкенд и не доказывает, что тот аварийно завершился. Возврат по таймеру тоже не подтверждает исправление приложения: новый запрос может снова завершиться ошибкой.
|
|||
|
|
|
|||
|
|
Адреса бэкендов заданы в конфигурации. Интеграция с Consul в этом стенде отсутствует.
|
|||
|
|
|
|||
|
|
После работы:
|
|||
|
|
|
|||
|
|
```shell
|
|||
|
|
docker compose down
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
Подробнее: [outlier detection в документации Envoy](https://www.envoyproxy.io/docs/envoy/latest/intro/arch_overview/upstream/outlier), [справочник параметров](https://www.envoyproxy.io/docs/envoy/latest/api-v3/config/cluster/v3/outlier_detection.proto).
|