Управление кластерами

Дарья Барышева

В ADB Control есть возможность мониторинга нескольких кластеров ADB одновременно. При этом целевой кластер, в котором будет использоваться web-интерфейс ADB Control, и прочие кластера, которые будут отправлять в него свои метрики, необязательно должны находиться в одном ADCM-контуре.

Управление кластерами осуществляется на вкладке Clusters страницы Configuration.

ВАЖНО

В версии ADB Control 4.6.4 внесены изменения в API регистрации внешних кластеров ADB. Если вы используете ADB Control версии 4.6.4 и выше, а для мониторинга подключены кластеры ADB с меньшей версией, чем 6.26.0.53 — необходимо выполнить обновление всех внешних кластеров ADB до версии 6.26.0.53 (или выше) перед выполнением любых конфигурационных изменений.

Просмотр списка кластеров

Вкладка Configuration → Clusters выводит следующую информацию о кластерах.

adbc config clusters dark
Вкладка Configuration → Clusters
adbc config clusters light
Вкладка Configuration → Clusters
Поля вкладки Configuration → Clusters
Поле Описание

Monitoring

Переключатель, используемый для перевода кластера в архивное состояние

Cluster name

Название кластера. Для кластера, используемого по умолчанию, дополнительно выводится подпись default cluster

JDBC URL

URL JDBC-соединения с кластером

Username

Имя пользователя, используемого для соединения с кластером

Database

Список баз данных для мониторинга. Базы данных, для которых настроена выгрузка метрик во внешнюю БД, отмечены иконкой upload dark upload light

Над таблицей со списком кластеров расположены фильтры, которые можно использовать для отбора данных:

  • Monitoring type — фильтрация по текущему статусу мониторинга:

    • Activate — активные кластеры, мониторинг которых выполняется.

    • Archived — кластеры, к которым применена архивация (временная приостановка сбора метрик).

    • All — все кластеры.

  • Cluster name — фильтрация по названию кластера (см. Cluster name выше). Поиск возможен по первым введенным символам.

Подключение нового кластера

ВАЖНО

  • Имя кластера ADB должно быть уникальным в рамках ADB Control. Зарегистрировать несколько кластеров с одним именем (например, созданных в разных ADCM) невозможно.

  • Если с течением времени URL-адрес подключения к кластеру ADB изменится, необходимо отредактировать его в настройках ADB Control.

  • При обновлении кластеров в ADCM в первую очередь следует обновлять тот кластер ADB, где установлен основной сервис ADB Control (не внешний).

Подключение нового кластера ADB к системе мониторинга ADB Control описано ниже:

  1. Используя ADCM, добавьте сервис ADB Control в кластер, который необходимо подключить к существующей системе мониторинга.

  2. На этапе конфигурирования сервиса выполните следующее:

    • Переведите переключатель External ADB Control server parameters в активное состояние.

    • В поле ADB Control address введите IP-адрес хоста, где развернут целевой сервис ADB Control, web-интерфейс которого планируется использовать для мониторинга нового кластера.

    • Нажмите Save.

      adbc config clusters2
      Заполнение адреса внешнего сервиса ADB Control

  3. Выполните установку сервиса. Обратите внимание, что распределение компонентов сервиса между хостами не требуется, так как будет использоваться внешний ADB Control.

  4. В web-интерфейсе целевой системы мониторинга ADB Control перейдите на вкладку Configuration → Clusters. Новый кластер добавляется в список автоматически.

    adbc config clusters5 dark
    Кластер добавлен
    adbc config clusters5 light
    Кластер добавлен

  5. Для того чтобы убедиться, что подключение кластера выполнено успешно, можно запустить SQL-запрос в одной из БД кластера, выбранных ранее для мониторинга, и проверить появление информации о запросе на вкладках страницы Monitoring. Обратите внимание, что добавленный кластер необходимо предварительно выбрать в фильтрах на странице (если он не назначен кластером по умолчанию). Пример тестового запроса ниже:

    SELECT pg_sleep(60);
    adbc config clusters6 dark
    Кластер доступен для мониторинга
    adbc config clusters6 light
    Кластер доступен для мониторинга

Редактирование подключения к кластеру

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

  1. Нажмите на иконку edit dark edit light в столбце Actions на вкладке Configuration → Clusters.

    adbc config clusters7 dark
    Переход к редактированию
    adbc config clusters7 light
    Переход к редактированию

  2. В открывшемся окне отредактируйте необходимые данные (название кластера в поле Cluster name не редактируется):

    • JDBC URL — строка JDBC-подключения к Master-хосту кластера ADB. Строка имеет следующий формат:

      jdbc:postgresql://<IP-адрес Master-хоста ADB>:5432/postgres

    • User — пользователь для подключения. По умолчанию adcc.

    • Password — пароль для подключения. Для пользователя adcc пароль не требуется.

    • Databases — список баз данных, мониторинг которых необходим. Список становится доступен после нажатия Fetch full list. Необходимо отметить минимум одну БД.

      adbc config clusters8 dark
      Редактирование данных
      adbc config clusters8 light
      Редактирование данных

  3. Нажмите Save. В результате информация о кластере обновляется на вкладке Configuration → Clusters.

    adbc config clusters9 dark
    Информация о кластере обновлена
    adbc config clusters9 light
    Информация о кластере обновлена

Установка кластера по умолчанию

На многих страницах web-интерфейса ADB Control присутствуют фильтры по имени кластера. Чтобы назначить кластер, который будет выбираться в этих фильтрах по умолчанию, выполните следующие шаги:

  1. Нажмите кнопку Set default на вкладке Configuration → Clusters.

    adbc config clusters10 dark
    Переход к назначению кластера по умолчанию
    adbc config clusters10 light
    Переход к назначению кластера по умолчанию

  2. В открывшемся окне выберите необходимый кластер из выпадающего списка Cluster name.

    adbc config clusters11 dark
    Выбор кластера по умолчанию
    adbc config clusters11 light
    Выбор кластера по умолчанию

  3. Нажмите Save. В результате подпись default cluster отображается под именем выбранного кластера.

    adbc config clusters12 dark
    Кластер по умолчанию обновлен
    adbc config clusters12 light
    Кластер по умолчанию обновлен

Архивация кластера

В некоторых случаях необходимо приостановить обработку метрик в ADB Control для определенного кластера. Для этой цели можно использовать архивацию кластера, которая означает следующее:

  • ADB Control более не собирает данные аудита для кластера.

  • Системная задача (job) по экспорту данных игнорирует выбранный кластер.

  • Для кластера не собирается статистика по ресурсным группам.

  • На странице Information перестает отображаться детальная информация о кластере.

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

  1. Откройте страницу Configuration → Clusters и для нужного кластера переведите переключатель в столбце Monitoring в неактивное состояние.

    adbc config clusters13 dark
    Переход к архивации кластера
    adbc config clusters13 light
    Переход к архивации кластера

  2. Подтвердите операцию в открывшемся окне, нажав на кнопку Stop.

    adbc config clusters14 dark
    Подтверждение архивации
    adbc config clusters14 light
    Подтверждение архивации

    В результате кластер отображается как архивный (не подлежащий мониторингу) на вкладке Configuration → Clusters.

    adbc config clusters15 dark
    Мониторинг кластера приостановлен
    adbc config clusters15 light
    Мониторинг кластера приостановлен
ПРИМЕЧАНИЕ

Если в дальнейшем потребуется возобновить мониторинг кластера, переведите переключатель в столбце Monitoring обратно в активное состояние.

Выбор кластера для выгрузки метрик во внешнюю БД

Если необходимо, чтобы метрики кластера выгружались во внешнюю аналитическую БД (согласно расписанию, установленному на вкладке Configuration → Job policy → Metrics offload), выполните следующие шаги:

  1. Нажмите на иконку upload dark upload light в столбце Actions на вкладке Configuration → Clusters.

    adbc offload dark
    Переход к настройке
    adbc offload light
    Переход к настройке

  2. В открывшемся окне отметьте базы данных кластера, из которых требуется выгружать метрики во внешнее хранилище.

    adbc offload2 dark
    Выбор баз данных
    adbc offload2 light
    Выбор баз данных

  3. Нажмите Offload. В результате к имени выбранной БД в столбце Database исходного окна добавляется иконка upload dark upload light.

    adbc offload3 dark
    Выбранная для выгрузки метрик база данных
    adbc offload3 light
    Выбранная для выгрузки метрик база данных
ПРИМЕЧАНИЕ

Если в дальнейшем потребуется изменить состав баз данных, из которых выгружаются метрики, либо отменить выгрузку для всего кластера — повторно нажмите на иконку upload dark upload light в столбце Actions для нужного кластера и внесите изменения.

Настройка GUC

Начиная с версии ADB Control 4.7.5 на странице Configuration → Clusters доступна настройка GUC, определяющих функционирование ADB Control. Для перехода к просмотру текущих значений GUC и их редактированию нажмите на иконку setup dark setup light напротив нужного кластера.

Переход к настройке GUC
Переход к настройке GUC
Переход к настройке GUC
Переход к настройке GUC

В открывшемся окне измените текущие значения GUC, если необходимо, и нажмите Save.

Список GUC для выбранного кластера
Список GUC для выбранного кластера
Список GUC для выбранного кластера
Список GUC для выбранного кластера

Доступные для редактирования GUC с описаниями приведены в таблице ниже.

Перечень GUC, определяющих функционирование ADB Control
Имя GUC Имя в UI Описание

adcc.monitor_inner_queries

Send inner queries metrics to ADCC

Необходим ли мониторинг вложенных запросов для всех команд кроме тех, что перечислены для adcc.monitor_utility_inner_queries

adcc.monitor_utility_inner_queries

Send utility inner queries metrics to ADCC

Необходим ли мониторинг вложенных запросов для utility-команд вида COPY, VACUUM, DDL-запросов и так далее

adcc.explain_log_buffers

Log buffers usage for EXPLAIN ANALYZE plan

Использовать ли буферы логов для планов EXPLAIN ANALYZE

adcc.explain_log_timing

Collect timing data, not just row counts for EXPLAIN ANALYZE plan

Собирать ли данные о таймингах в дополнение к числу строк для планов EXPLAIN ANALYZE

adcc.explain_log_analyze

Send EXPLAIN ANALYZE at the end of the query

Отправлять ли EXPLAIN ANALYZE в конце выполнения запросов

adcc.explain_log_verbose

Use VERBOSE for EXPLAIN ANALYZE plan

Использовать ли опцию VERBOSE для EXPLAIN ANALYZE

adcc.explain_log_min_duration

Sets the minimum execution time above which EXPLAIN ANALYZE plans will be sent

Минимальное время выполнения, при превышении которого будут отправлены планы для команды EXPLAIN ANALYZE (в миллисекундах)
Нашли ошибку? Выделите текст и нажмите Ctrl+Enter чтобы сообщить о ней