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

Использование узлов-обработчиков

Доступно с версии 3.1.0.

Tarantool DB поддерживает тип экземпляров, который называется обработчик (worker). Узел-обработчик представляет собой Go-приложение, которое позволяет вынести бизнес-логику работы с данными отдельно от хранения данных в Tarantool DataBase и предоставляет удобный интерфейс для работы с базой данных. Такое приложение подключается к Tarantool DataBase через Go-коннектор и отслеживает изменения конфигурации и смену мастер-узла.

Tarantool DataBase поддерживает отображение обработчиков в веб-интерфейсе TCM. В TCM обработчики отображаются на вкладке Stateboard в отдельной группе узлов workers.

Группа узлов-обработчиков в TCM

Конфигурация

Конфигурация каждого узла-обработчика задается в отдельном YAML-файле конфигурации и хранится по отдельному ключу в централизованном хранилище конфигурации — etcd или хранилище на основе Tarantool. Пример конфигурации узла может выглядеть так:

type: nontarantoolinstrumentation:    url:            worker-1:9080    metrics_url:    /metrics    metrics_format: "prometheus"    liveness_url:   /alive    info_url: /info    binary: ./bin/http-serverconfig:    addr: localhost:10000    tarantool_cluster_prefix: /tdb/config/all    tarantool_user: admin    tarantool_pass: secret-cluster-cookie

Здесь:

  • Секция config содержит произвольные поля, связанные с приложением, но при этом формат хранения конфигурации в централизованном хранилище строго определен;
  • В cекции instrumentation определены параметры мониторинга и интеграции с веб-интерфейсом TCM.

Отслеживание состояния обработчиков

Обработчики в Tarantool DataBase поддерживают мониторинг своего состояния с помощью трех адресов обработчиков запросов (endpoints):

  • /healthcheck — проверка работоспособности обработчика;
  • /metrics — метрики экземпляра;
  • /info — общая информация об обработчике.

Метрики и события журнала у обработчиков используют такой же формат, как и в самом Tarantool. Для отслеживания состояния узлов-обработчиков используются системные метрики Go.

В TCM просмотреть информацию об обработчике и его метрики можно на вкладке Stateboard, выбрав нужный экземпляр обработчика:

Информация об обработчике в TCM