Обзор веб-интерфейса StarRocks

Дмитрий Булгаков

Свернуть контент Развернуть контент

Содержание

Доступ к веб-интерфейсу
Навигация по веб-интерфейсу
- Homepage
- System
- Backends
- Logs
- Queries
- Sessions
- Variables
- HA
- Proc profiles
Вопросы безопасности

Веб-интерфейс StarRocks — встроенный веб-интерфейс, предоставляющий администраторам информацию о кластере StarRocks, его узлах, выполняющихся запросах и сессиях, системных переменных, состоянии высокой доступности (High Availability, HA), журналах и профилях производительности процессов.

Доступ к веб-интерфейсу

Доступ к веб-интерфейсу обеспечивается Frontend-узлами (FE). URL-адреса веб-интерфейса можно найти в ADCM на вкладке Services → StarRocks → Components → StarRocks FE → Info в формате http://<FE-host>:<FE-http-port>/. Например, http://starrocks-fe.example.com:18030/.

В ADH порт HTTP FE по умолчанию — 18030. Его можно изменить в конфигурации, задав параметр Services → StarRocks → Components → StarRocks FE → Custom fe.conf → http_port.

Доступ к веб-интерфейсу StarRocks осуществляется с помощью учетных записей StarRocks. У веб-интерфейса нет отдельного набора пользователей.

После установки ADH доступ к веб-интерфейсу StarRocks можно получить либо от имени пользователя root, либо от имени сервисного пользователя:

Вход под пользователем root предназначен для администраторов. Учетная запись создается с пустым паролем, который нельзя изменить в ADH. После создания кластера вручную задайте пароль для пользователя root, как описано в документации StarRocks.
Пользователь service_user создается в StarRocks с ограниченными правами доступа к административным функциям и информации веб-интерфейса. Пароль для этой учетной записи можно задать в Services → StarRocks → Credentials → Service_user password.

Вы можете создавать дополнительных пользователей и предоставлять им доступ к веб-интерфейсу.

Навигация по веб-интерфейсу

Веб-интерфейс содержит следующие вкладки:

Homepage

Главная страница открывается после успешного входа в систему. Ее также можно открыть, нажав логотип StarRocks в веб-интерфейсе. На странице отображается информация об установленной версии StarRocks и подробная информация об аппаратном обеспечении.

Главная страница веб-интерфейса

System

На вкладке System отображается общая информация о процессах StarRocks FE и среде, в которой они выполняются.

Эта вкладка полезна для первоначальной диагностики при исследовании состояния StarRocks. Ее можно использовать для проверки доступности процесса FE и просмотра основной системной информации.

Вкладка System
Элемент	Описание
brokers	Зарегистрированные брокеры, включая их адреса, порты, доступность и сообщения об ошибках. Эквивалентный SQL-запрос: `SHOW PROC '/brokers'`
frontends	Узлы FE, включая их IP-адреса, порты, роли, доступность, состояние и версию StarRocks. Эквивалентный SQL-запрос: `SHOW FRONTENDS` или `SHOW PROC '/frontends'`. `SHOW FRONTENDS` предоставляет актуальную информацию от ведущего узла FE (Leader FE)
routine_loads	Задачи Routine Load и информация об их выполнении, включая состояние задач, ход выполнения, статистику и свойства источника данных. Эквивалентный SQL-запрос: `SHOW ROUTINE LOAD` или `SHOW PROC '/routine_loads'`
catalog	Каталоги (внутренние и внешние), зарегистрированные в кластере. Эквивалентный SQL-запрос: `SHOW PROC '/catalog'`
colocation_group	Группы Colocate Join и информация о таблицах, назначенных каждой группе. Эквивалентный SQL-запрос: `SHOW PROC '/colocation_group'`
cluster_balance	Информация о балансировке нагрузки кластера, включая текущее состояние балансировки, нагрузку кластера, состояние планировщика и операции восстановления tablet. Эквивалентный SQL-запрос: `SHOW PROC '/cluster_balance'`
load_error_hub	Конфигурация Load Error Hub, используемая для управления сообщениями об ошибках, сгенерированными заданиями загрузки. Эквивалентный SQL-запрос: `SHOW PROC '/load_error_hub'`
meta_recovery	Информация о восстановлении метаданных, включая разделы, восстановление которых завершилось ошибкой
global_current_queries	Запросы, выполняющиеся в данный момент на всех узлах FE кластера. Эквивалентный SQL-запрос: `SHOW PROC '/global_current_queries'`
tasks	Общие задачи кластера, их количество, а также число задач, завершившихся ошибкой. Эквивалентный SQL-запрос: `SHOW PROC '/tasks'`
compute_nodes	Узлы CN в кластере и их текущее состояние. Эквивалентный SQL-запрос: `SHOW COMPUTE NODES` или `SHOW PROC '/compute_nodes'`
statistic	Статистика для каждой базы данных, включая информацию о таблицах, разделах, индексах, tablet и репликах. Эквивалентный SQL-запрос: `SHOW PROC '/statistic'`
jobs	Задания в кластере, включая их типы и количество ожидающих выполнения, выполняющихся, завершенных и отмененных заданий. Эквивалентный SQL-запрос: `SHOW PROC '/jobs'`
warehouses	Хранилища данных, настроенные в кластере, и их текущее состояние
resources	Ресурсы, доступные в кластере. Эквивалентный SQL-запрос: `SHOW RESOURCES` или `SHOW PROC '/resources'`
monitor	Информация о мониторинге кластера, включая информацию о JVM. Эквивалентный SQL-запрос: `SHOW PROC '/monitor'`
transactions	Транзакции в кластере и их текущее состояние. Эквивалентный SQL-запрос: `SHOW PROC '/transactions'`. Подробную информацию о конкретной транзакции можно получить с помощью `SHOW TRANSACTION`
backends	Узлы BE в кластере и их текущее состояние. Эквивалентный SQL-запрос: `SHOW BACKENDS` или `SHOW PROC '/backends'`. Поскольку ADH развертывает StarRocks с использованием модели shared-data, этот элемент ничего не показывает. Узлы CN отображаются в разделе `compute_nodes`
current_queries	Запросы, выполняющиеся в данный момент на узле FE, к которому подключен веб-интерфейс. Эквивалентный SQL-запрос: `SHOW PROC '/current_queries'`
stream_loads	Операции Stream Load и информация об их выполнении
replications	Задачи репликации данных, включая их состояние, ход выполнения и ошибки. Эквивалентный SQL-запрос: `SHOW PROC '/replications'`
dbs	Базы данных, таблицы, разделы и tablet в кластере. Эквивалентный SQL-запрос: `SHOW PROC '/dbs'`
current_backend_instances	Узлы BE, которые в данный момент обрабатывают запросы в кластере. Эквивалентный SQL-запрос: `SHOW PROC '/current_backend_instances'`
historical_nodes	Узлы, которые ранее были зарегистрированы в кластере
compactions	Задачи компакции и информация об их выполнении

Backends

Вкладка Backends предназначена для отображения информации об узлах Backend (BE), включая их состояние и использование ресурсов.

ВАЖНО

Компоненты BE недоступны в ADH, поскольку StarRocks разворачивается с использованием модели shared-data. Поэтому вкладка Backends не предоставляет полезной информации об узлах в ADH. Для просмотра состояния Compute Node (CN) используйте оператор SHOW PROC '/compute_nodes' или вкладку System → compute_nodes.

Logs

Вкладка Logs предоставляет доступ к логам StarRocks. Логи являются одним из основных источников диагностической информации при анализе:

проблем с запуском и остановкой FE;
изменений состояния кластера;
неудачных запросов;
ошибок, связанных с запросами;
проблем с планированием;
ошибок связи;
проблем с конфигурацией;
аномального поведения узлов.

StarRocks поддерживает отдельные логи для FE и вычислительных процессов. Логи FE содержат информацию о запуске, изменениях состояния кластера, запросах DML и DQL, а также операциях, связанных с планированием.

Вкладка Logs

Queries

Вкладка Queries предназначена для отображения информации о текущих и завершенных SQL-запросах, обработанных узлами BE.

ВАЖНО

Компоненты BE недоступны в ADH, поскольку StarRocks развертывается с использованием модели shared-data. По этой причине данная вкладка всегда остается пустой в ADH.

Sessions

На вкладке Sessions отображаются активные клиентские сессии, подключенные к StarRocks.

Сессия представляет собой клиентское подключение к StarRocks по протоколу, совместимому с MySQL. Одно клиентское приложение может устанавливать одну или несколько сессий.

На вкладке отображается информация о:

активных клиентских подключениях;
пользователях, подключенных к кластеру;
адресах клиентов;
продолжительности подключений;
сессиях, связанных с выполняющимися запросами;
длительно существующих или потенциально оставленных без использования подключениях.

Вкладка Sessions

Variables

На вкладке Variables отображаются текущие значения системных параметров StarRocks и переменных.

Вкладка Variables

HA

На вкладке HA показана информация о состоянии высокой доступности слоя FE StarRocks, информация об адресе FE, HTTP-порте, порте запросов, роли, доступности, состоянии heartbeat и версии.

Узлы FE могут иметь следующие роли:

LEADER — активный FE, отвечающий за операции записи метаданных;
FOLLOWER — FE, участвующий в синхронизации метаданных и выборах;
OBSERVER — FE, синхронизирующий метаданные, но не участвующий в выборах.

Для просмотра текущего состояния узлов FE также можно использовать оператор SHOW FRONTENDS;.

Вкладка HA

Proc profiles

На вкладке Proc profiles отображены профили производительности StarRocks на уровне процессов. Их можно использовать для выявления потребления ресурсов фоновыми задачами, обработкой метаданных, синхронизацией и другими внутренними операциями.

Вкладка Proc profiles

Профили процессов содержат flame graph для CPU и памяти. Flame graph представляет собой иерархию вызовов процесса и показывает относительный объем потребления ресурсов, связанный с отдельными функциями или цепочками вызовов.

Пример CPU flame graph

Информацию можно использовать для:

анализа распределения нагрузки на CPU;
анализа выделения памяти;
исследования высокого потребления ресурсов;
анализа сложных проблем во время выполнения задач;
изучения падения производительности.

Вопросы безопасности

Веб-интерфейс предоставляет доступ к эксплуатационной информации о кластере StarRocks и должен быть защищен от несанкционированного доступа. Ограничьте доступ к HTTP-порту FE доверенными сетями и авторизованными администраторами. Используйте механизмы аутентификации и контроля доступа, настроенные для развертывания StarRocks.

Нашли ошибку? Выделите текст и нажмите Ctrl+Enter чтобы сообщить о ней