TDB Documentation portal logo
Помощь
Обновлена 30 июля 2026 г. в 16:49

Балансировка запросов к роутерам через Go-коннектор

В примере демонстрируется работа с повреждённым кластером под нагрузкой. Приложение непрерывно записывает кортежи пачками через все роутеры по очереди. Для записи используется операция replace. Если какой-либо роутер упал, трафик с него переключается на остальные роутеры. Если роутер поднялся, трафик на него возвращается.

Для мониторинга используются:

  • Prometheus — сбор и хранение метрик;
  • Grafana — визуализация метрик.

Содержание:

Пререквизиты

Для выполнения примера требуются:

  • установленный Docker-образ Tarantool DB;

  • приложение Docker compose;

  • Go;

  • исходные файлы примера go_balancer.

Запуск стенда

Для успешного запуска должны быть свободны порты:

  • 3301—3306;
  • 8080—8086.

Перейдите в директорию go_balancer/tt:

cd ./docs/docs/ru/assets/examples/go_balancer/tt

Запустите стенд:

docker compose up -d

Команда развернет стенд, состоящий из:

  • кластера Tarantool DB (два шарда, два хранилища и два роутера);
  • клиентского приложения, подающего нагрузку;
  • средств мониторинга (Prometheus, Grafana).

После запуска должны работать все контейнеры, кроме tarantool-db-init. Также после запуска доступны следующие пользовательские интерфейсы:

Теперь откройте в браузере веб-интерфейс Tarantool DB по адресу http://localhost:8081. Перейдите во вкладку Cluster и проверьте, что отсутствуют ошибки или предупреждения. В течение нескольких секунд после старта кластер еще поднимается, так что могут появиться предупреждения.

После этого перейдите на вкладку Space Explorer и выберите любой узел, например storage1. Проверьте, что на узле есть спейс test.

Панель Grafana

Откройте в Grafana панель Tarantool dashboard. Проверьте, что графики показывают данные за последние 5 минут, а частота обновления равна 5 секундам:

Балансировка запросов к роутерам через Go-коннектор

В панели Tarantool Network activity откройте график Processed requests:

Балансировка запросов к роутерам через Go-коннектор

Выделите роутеры. Есть два способа это сделать:

  • нажмите на название router-1 и, зажав Shift, нажмите на router-2.
  • используйте переключатель сверху, чтобы выбрать роутеры на уровне всего дашборда:

Балансировка запросов к роутерам через Go-коннектор

В панели Tarantool operations statistics откройте график REPLACE space requests. Выберите все узлы, кроме роутеров:

Балансировка запросов к роутерам через Go-коннектор

В панели CRUD module statistics" откройте график REPLACE success requests:

Балансировка запросов к роутерам через Go-коннектор

Увеличение нагрузки

Откройте вторую вкладку терминала. В этой вкладке перейдите в директорию go_balancer/go:

cd ./docs/docs/ru/assets/examples/go_balancer/go

Запустите клиентское приложение:

go run -tags go_tarantool_ssl_disable main.go

Здесь:

  • go_tarantool_ssl_disable — опция, отключающая поддержку TLS. Так как для поддержки TLS требуется установленный OpenSSL 3.x, для простоты в примере поддержка TLS отключена.

На графиках теперь заметно, что нагрузка растет:

  • растет число обработанных запросов на роутерах:

    Балансировка запросов к роутерам через Go-коннектор

  • растет число операций replace в единицу времени:

    Балансировка запросов к роутерам через Go-коннектор

Включите отображение графиков хранилищ и оцените их:

Балансировка запросов к роутерам через Go-коннектор

В веб-интерфейсе Tarantool DB откройте вкладку Space Explorer и проверьте, что в хранилищах появились данные.

Имитация отказа роутера

Чтобы имитировать отказ роутера, в первом терминале выполните команду:

docker compose stop tarantool-router1

Теперь в веб-интерфейсе Tarantool DB во вкладке Cluster узел tarantool-router1 помечается как нездоровый (unhealthy). График запросов изменится так:

Балансировка запросов к роутерам через Go-коннектор

Нагрузка на второй роутер увеличилась вдвое. График для второго роутера выглядит так:

Балансировка запросов к роутерам через Go-коннектор

Роста нагрузки на этом графике нет. График прерывается, так как роутер не работает и метрики с него не поступают. Количество операций replace при этом не изменилось:

Балансировка запросов к роутерам через Go-коннектор

Кол-во операций crud-replace на рабочем роутере возросло:

Балансировка запросов к роутерам через Go-коннектор

Восстановление роутера

Для запуска первого роутера выполните следующую команду:

docker compose start tarantool-router1

В веб-интерфейсе Tarantool DB во вкладке Cluster видно, что узел tarantool-router1 восстановлен. Нагрузка на второй роутер уменьшилась вдвое, появились данные по нагрузке с первого:

Балансировка запросов к роутерам через Go-коннектор

Число операций replace не изменилось:

Балансировка запросов к роутерам через Go-коннектор

Кол-во операций crud-replace на один роутер снизилось:

Балансировка запросов к роутерам через Go-коннектор

Остановка стенда

Для остановки стенда:

  • В первом терминале выполните команду:

    docker compose down
  • Во втором терминале выполните команду Ctrl + Z.