Кластеры

Раздел меню Обслуживание → Кластеры содержит инструменты управления кластерами в Платформе.

При первой авторизации пользователя система предлагает создать кластер и сервер по умолчанию. При подтверждении пользователя Платформа создает кластер, сервер и сервис обработки процессов. События по созданию и запуску фиксируются в журнале изменений системы.

Имя кластера, имя и наименование сервера наследуются от имени сервера, на котором установлена и запущена Платформа, указанного в операционной системе. В качестве адреса устанавливается ip-адрес 127.0.0.1.

Примечание

При необходимости добавить в кластер дополнительный сервер потребуется сменить адрес 127.0.0.1 на IP-адрес сервера из настроек сетевого подключения либо на имя компьютера сервера, которое должно разрешаться в корректный IP-адрес данного сервера на компьютерах локальной подсети.

Информация о конфигурации серверов, сервисов и систем кластера, работа с их очередями и архивом сообщений, диагностические запросы доступны в Центре мониторинга.

Настройка кластера

В рабочей области кластера содержатся вкладки: Основные, Группы серверов, Производительность, Логирование и сбор событий.

1. На вкладке Основные проверьте и при необходимости обновите следующие поля:

   • Название: произвольное название кластера, обязательно для заполнения.

   • Имя: уникальное имя кластера, необязательно для заполнения.

   • Комментарий: описание кластера, необязательно для заполнения, поддерживается многострочный ввод.

2. На вкладке Производительность заполните следующие поля:

Взаимодействие в кластере

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

• Максимальное количество сообщений в очереди для модуля процессов на своем сервере: до какого объема сообщений модуль процессов будет копить их у себя, прежде чем “переливать” нагрузку.

• Процент сообщений в очереди для модуля процессов на своем сервере, при повышении которого передавать выполнение другим серверам: порог, после которого очередь на текущем сервере считается “переполненной”, и задачи отправляются на другие сервера. Чем ниже показатель, тем раньше начнет перераспределяться.

• Балансировка нагрузки при обработке сообщений: если включено, система автоматически распределяет задачи по серверам, чтобы не перегружать один.

Выполнение процессов

• Количество потоков выполнения процессов: сколько процессов может выполняться одновременно (параллельно).

• Максимальное количество спящих процессов: сколько процессов можно “притормозить” и оставить в спящем состоянии, чтобы не выполнять сразу.

• Максимальный объем спящих процессов, Мб: ограничение по объему памяти для спящих процессов.

• Максимальный объем очереди процессов к обработке, Мб: максимальный размер очереди процессов, которые уже взяты в работу.

• Минимальное время ожидания ответа до помещения процесса в очередь спящих, мс: если процесс долго ждет ответа, после этого времени он отправляется в “спящий” режим.

• Максимальный процент количества ожидающих процессов от заданного ограничения на объем спящих процессов: ограничение доли “ожидающих” процессов от лимита для спящих. При превышении новые процессы уже не будут переводиться в спящие.

• Максимальное время ожидания в шагах, поддерживающие ожидание, минут: если шаг процесса поддерживает ожидание, то не дольше указанного времени.

• Минимальное количество сообщений, забираемых из очереди на один поток обработки: минимальный объем сообщений, который один поток берет за один проход.

3. На вкладке Логирование и сбор событий заполните следующие поля:

Параметры сбора и хранения данных журнала

• Уровень логирования для оперативного журнала (minLogLevel): установите необходимый уровень логирования журнала.

• Уровень логирования журнала для хранения (minLogLevelHistory): установите необходимый уровень логирования журнала.

• Дополнительные разделы журнала (features): установите дополнительный раздел журнала. Запись логов указанного раздела будет происходить без ограничения по уровню логирования.

Параметры сбора и хранения событий

• Сохранять в формате Datareon (saveAsBinFiles): при активном флаге события сохраняются в бинарном формате. Формат необходим для работы Сервиса аналитики. По умолчанию флаг активен.

• Сохранять в текстовом формате (saveAsTextFiles): при активном флаге события сохраняются в текстовых файлах. По умолчанию флаг не установлен.

  Внимание

  Допускается включение обоих форматов (и бинарный, и текстовый) одновременно. Один из параметров Сохранять в формате Datareon или Сохранять в текстовом формате должен быть активен.

• Уровень логирования событий для оперативного журнала (defaultEventLevel): установите необходимый уровень логирования журнала.

• Уровень логирования событий для хранения (defaultEventLevelHistory): установите необходимый уровень логирования.

Параметры хранения файлов в формате Datareon

• Сохранять события с телами сообщений (saveBodies): при активном флаге тело сообщения сохраняется в событиях. При умолчанию флаг не установлен. Включение параметра увеличивает объем хранимых данных.

• Максимальный размер тела сообщения для хранения (maxBodySizeBytes): максимальный размер тела сообщения, сохраняемого в событии (в байтах). Параметр используется только при активном флаге Сохранять события с телами сообщений.

Параметры хранения текстовых файлов

• Длительность хранения (storeDays): определяет срок хранения текстовых файлов журнала и событий, указываются дни.

• Максимальный размер каталога (folderMaxSizeMb): максимально допустимый размер каталога с текстовыми файлами журнала и событий, указываются мб. При достижении указанного размера выполняется очистка старых файлов.

• Длительность хранения распакованных файлов (uncompressedDays): определяет срок хранения распакованных текстовых файлов (после автоматической распаковки архивов), указываются дни. По истечении срока файлы удаляются.

• Максимальный размер распакованных файлов (uncompressedMaxSizeMb): максимальный суммарный размер распакованных текстовых файлов, указываются мб. При превышении значения выполняется удаление наиболее старых файлов.

• Максимальный размер каталога для временных файлов (tempFolderMaxSizeMb): максимальный размер каталога, используемого для хранения временных файлов при работе с журналами и событиями, указываются мб.

• Длительность хранения временных файлов (tempStoreMinutes): определяет, как долго временные файлы хранятся до автоматического удаления (в минутах).

4. Нажмите на кнопку Сохранить изменения. Введенные данные будут сохранены, и между кнопками появится кнопка Обновить, которую можно будет использовать для обновления данных:

   

5. Перейдите в режим редактора конфигурации, используя переключатель Перейти в режим редактора конфигурации.

   Откроется окно редактора конфигурации, содержащее начальную конфигурацию.

6. Внесите необходимые изменения в конфигурацию.

7. Нажмите на кнопку Сохранить изменения для сохранения изменений.

8. Нажмите на кнопку Применить конфигурацию.

Настройки кластера определяют ключевые параметры работы систем.

Параметры конфигурации кластера

Общие параметры кластера:

• heartbeatPeriod (integer): период опроса машин координатором (в мс.).

• otherMachineSenderThreadsCount (integer): количество потоков при передаче данных между серверами кластера. Может принимать значения от 1 до 12. Значение по умолчанию - 8.

• failThreshold (integer): максимальное количество пропущенных heartbeat-сообщений, после которых сервер считается недоступным.

• useCertificateForChannels (boolean): использование сертификатов для каналов связи.

• useBalancing (boolean): включение балансировки на модулях процессов. Уточнение параметра доступно в настройках модуля процессов.

• redirectDiagnostics (boolean): перенаправление диагностических сообщений.

• useSystemUDPSender (boolean): включение UDP рассылки для 1C.

• updateTimeout (integer): настройка периода рассылки состояния координатора серверам.

• entityId (string): GUID кластера, совпадает с clusterId.

• name (string): имя кластера.

• version (integer): номер версии текущей конфигурации кластера.

• tagsCollection (array): теги кластера.

Сетевые параметры кластера:

• LocalNodeApiPort (integer): порт для работы с очередями кластера.

• apiPort (integer): порт API кластера.

• snmpPort (integer): порт для сборки счетчиков SNMP с серверов.

• systemRequestsPort (integer): порт сервера для отправки параметров адаптеров 1С.

• resolveList (array): список сопоставления ip-адресов серверов кластера с именами.

Параметры обработки процессов:

• processParams (array): базовые настройки балансировщика для всех модулей процессов, см. раздел Балансировка. Уточнение параметра доступно в настройках модуля процессов.

• commonParams (array): максимальный объем потребляемой памяти модулями процессов, см. раздел Балансировка. Уточнение параметра доступно в настройках модуля процессов.

Параметры серверов:

• nodeParams (array): настройки перенаправления сообщений, см. раздел Перенаправление процессов с перегруженного сервера. Уточнение параметра доступно в настройках сервера.

Диагностика и мониторинг:

• globalDiagnosticParams (array): настройки диагностики, в том числе уровень логирования, см. раздел Цепочка событий и Очередь. Уточнение параметра доступно в настройках сервера или модуля.

• executeRequestTimeoutMs (integer): время ожидания ответа от процесса сервера, направленного процессу сервера-координатора при выполнении запроса получения записей журнала или событий ЦМ. Единица измерения - миллисекунды. Значение по умолчанию - 600000.

• counterSettings (array): настройки сбора счетчиков серверов и модулей в ЦН.

Кэширование:

• cacheSettings (array): настройки кеширования.

Серверы:

• nodeGroupCollection (array): настройка Группы серверов.

Очереди сообщений:

• largeObjectQueueParams (array): настройки параметров очереди больших сообщений.

• queueParams (array): настройки хранилища очередей.

• messageProcessingParams (array): настройки количества откладывания сообщения.

Хранилище логов и дампы:

• logStorageParams (array): настройки логирования на диск, см. раздел Логирование на диск.

• dumpStorageParams (array): параметры хранения дампов диагностики кластера.

Хранилище событий:

• eventsStorageParams (array): параметры сбора и хранения событий Сервиса для сбора событий для Сервиса аналитики.

Ограничения использования диска:

• diskUsageParams, archiveStorageParams и trackingStorageParams (array): параметры контроля использования дискового пространства.

Балансировка:

• allocationOptions (array): настройка распределения сервисов и внешних систем.

Отказоустойчивость и репликация:

• coordinators (array): массив приоритетных координаторов для кластера, см. раздел Отказоусточивость.

• faultTolerance (integer): уровень отказоустойчивости, то есть количество реплик, на которых будет создаваться копия данных серверам.

• hotRecoverySettingsGlobal (array): настройка модуля горячего восстановления.

• replicationSettings (array): настройки репликации.

Параметры совместимости:

• useOldDateConverter (boolean): параметр блока deprecatedParams. Флаг, управляющий способом отображения дат: при true время показывается без перевода в локальный часовой пояс, при false — с переводом. По умолчанию установлен флаг false.

• useOldServiceUI (boolean): параметр блока deprecatedParams. При true в ЦН видны настройки меню Формы интерфейса, Настройка меню и сервиса Веб-интерфейс. По умолчанию установлен флаг false. Если Веб-интерфейс был ранее создан, то при значении false он отображается в списке сервисов.

Примечание

Некоторые параметры могут быть уточнены в конфигурации конкретного сервера, модуля или системы. Если уточнения нет, то для работы берутся значения, заполненные в кластере.

При возникновении ошибки Сработал лимит на размер директории Temp увеличьте значение tempFolderMaxSizeMb параметра logStorageParams, сохраните изменения и примените конфигурацию.

Внимание

В версии 3.1.2.1 изменение параметра useOldDateConverter доступно только для Типов данных и Внешних типов данных, для Категорий в Версии 3.1.2.1 не применимо.

Очистка архивов и логов

Параметры ограничения занимаемого дискового пространства настраиваются в блоке параметров diskUsageParams, archiveStorageParams, trackingStorageParams конфигурации кластера и используются для предотвращения переполнения дискового пространства.

"diskUsageParams": {
    "$type": "DT.DiskUsageParams, DT_Core",
    "archiveMaxSizeMb": 100,
    "trackingMaxSizeMb": 100,
    "dataMaxSizeMb": 1024,
    "logsMaxSizeMb": 100,
    "totalMaxSizeMb": 2048
},
"archiveStorageParams": {
    "$type": "DT.ArchiveStorageParams, DT_Config",
    "archiveMaxSizeMb": 100
},
"trackingStorageParams": {
    "$type": "DT.TrackingStorageParams, DT_Config",
    "trackingMaxSizeMb": 100
}

Основные параметры:

• archiveMaxSizeMb (integer): максимальный размер (мб) журнала архивных сообщений (папка Archive). Минимально возможное значение - 10 (мб), максимальное - 51200 (мб). Задается параметром archiveStorageParams.archiveMaxSizeMb.

  При превышении 90% от максимального объема очищается папка Archive до достижения 80% от максимального. Удаляются самые старые файлы.

• trackingMaxSizeMb (integer): максимальный размер (мб) журнала трассировки (папка Trace). Минимально возможное значение - 10 (мб), максимальное - 51200 (мб). Задается параметром trackingStorageParams.trackingMaxSizeMb.

  При превышении 90% от максимального объема очищается папка Trace до достижения 80% от максимального. Удаляются самые старые файлы.

• dataMaxSizeMb (integer): максимальный размер (мб) данных очередей папки NodeStorage.

  Если достигнут порог в 100%, останавливается обработка данных.

• logsMaxSizeMb (integer): максимальный размер (мб) папки с логами logs.

  При достижении порога в 95% сортируются все файлы в папке Logs по дате, и удаляются файлы, созданные более чем сутки назад до достижения порога в 80%. Если количества устаревших файлов недостаточно для очищения до 80%, удаляются файлы из папок с самым большим количеством файлов.

• totalMaxSizeMb (integer): максимальный размер (мб) папки Platform.

  При достижении порога в 100% Платформа перестает обрабатывать прием или отправку сообщений. После восстановления памяти Платформа автоматически возобновляет работу. Сообщения, отправленные во время сбоя, продолжают обрабатываться и доходят до получателя.

Примечание

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

Группы серверов

По умолчанию все серверы, создаваемые в кластере (не в nodeGroups), добавляются в группу default, в рамках которой осуществляется распределение сервисов и систем.

Внимание

Если система или сервис указаны напрямую в конфигурации конкретного сервера, они будут запущены независимо от принадлежности к группе.

При сбое серверов внутри группы сервисы остаются внутри нее — перераспределение не происходит за пределы группы. Это обеспечивает управляемую локализацию нагрузки в рамках одной группы. Концепция изоляции групп гарантирует, что перераспределение нагрузки происходит только внутри группы серверов.

При назначении сервера в пользовательскую группу он запускает только те сервисы и системы, которые также привязаны к этой группе.

Внимание

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

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

В конфигурации кластера поле nodeGroupCollection содержит массив nodeGroups - групп серверов.

"nodeGroupCollection": {
    "$type": "DT.ClusterConfiguration.NodeGroupCollection, DT_Core",
    "nodeGroups": [{
            "nodeGroupId": "ee85a5bb-399b-40b2-8ec8-5157d8cad99b",
            "nodeGroupName": "1",
            "nodeIds": [
                "5d77e4f6-623a-4e24-aa20-fe9b688f2474"
            ],
            "systemsAndModulesIds": [
                "6a9ae87c-a5a6-4d76-8c86-6cd4088ec6be"
            ]
        }, {
            "nodeGroupId": "92f96ec3-0a34-47f8-983c-dca51b01de6d",
            "nodeGroupName": "2",
            "nodeIds": [
                "d67bcf81-ab4d-491c-bdfc-cec32a642386",
                "fce58a75-dcdc-4b18-bbbf-3d1a25f2cf8e"
            ],
            "systemsAndModulesIds": [
                "5a14fdfb-d502-4939-889e-cd4d3c651ad7"
            ]
        }
    ],
    "distributeWorkloadToAllNodes": false
}

В примере:

• 2 группы серверов (1 и 2) - nodeGroupName, nodeGroupId;

• в 1 группе: 1 сервер (nodeIds) и 1 система или сервис (systemsAndModulesIds);

• во 2 группе: 2 сервера (nodeIds) и 1 система или сервис (systemsAndModulesIds)

Внимание

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

Внимание

Если хотя бы одна включенная система или сервис не привязана к какому-либо серверу (через группы или в конфигурации сервера), то на домашней странице ЦМ будет ошибка Проблема распределения.

У координатора будет соответствующая ошибка:

В группе {НазваниеГруппы} нет рабочих серверов. Останутся без распределения и не запустятся:
[id системы, имя системы], [id сервиса, имя сервиса], ...

Настройка группы серверов

Для группирования серверов необходимо:

1. перейти: ЦН → Обслуживание → Кластеры → открыть требуемый кластер двойным щелчком

   

Внимание

Убедитесь, что созданы необходимые Серверы, Сервисы, Системы

2. в Кластере выбрать вкладку Группы серверов

Установите флаг Распределять при балансировке нагрузки процессы между группами, если необходимо перераспределять нагрузку на все сервера. Если флаг не установлен, перераспределение процессов будет только в своей группе.

3. для добавления Группы нажать +

   

4. новая группа будет добавлена в конце списка.

Группе будет присвоено числовое имя последовательно, начиная с 1. Поддерживается редактирование имени группы при двойном щелчке по требуемой группе.

5. для настройки необходимо выделить соответствующую группу

При необходимости группу можно удалить, нажав на иконку Корзины.

Примечание

Если ранее созданная группа была удалена, ее порядковый номер становится доступным для повторного использования. Таким образом, при создании новой группы используется первый «пропущенный» (свободный) номер, чтобы поддерживать непрерывность нумерации.

6. выбрать для группы Серверы, Системы и Сервисы

   

Где:

Серверы - перечень Серверов, настроенных в ЦН

Системы - перечень Внешних систем (Интеграция), настроенных в ЦН

Сервисы - перечень Сервисов, настроенных в ЦН

Доступен мультиселект, перечень Серверов, Систем и Сервисов редактируется - можно удалить и / или добавить в группу.

7. Нажмите на кнопку Сохранить изменения.

8. Нажмите на кнопку Применить конфигурацию.

9. при необходимости повторить п.3 - 8.

Настройка кластера из нескольких серверов

Роль мастер-сервера

В кластере может быть несколько серверов, но только один из них является мастер-сервером Центра настройки (ЦН), остальные серверы кластера определяются как не мастер-серверы (slave-серверы).

Мастером становится сервер, на котором запущено первое применение конфигурации в кластере.

Роль мастер-сервера определяет, на каком сервере разрешено изменение и применение конфигурации Платформы, в режиме мастера доступны общие элементы управления.

На не мастер-серверах Центра настройки конфигурация доступна только для просмотра без общих элементов управления. Все операции изменения и сохранения данных (например, редактирование форм, добавление и удаление объектов, изменение шагов процессов) на не мастер-серверах заблокированы.

Если мастер не назначен, появится кнопка Не определен мастер ЦН

При открытии формы по кнопке предлагается назначить мастер

В форме доступны следующие варианты:

• Да: мастером будет назначен сервер, в котором на данный момент открыт ЦН.

• Нет, выбрать другой сервер: откроется форма выбора мастера из всех созданных серверов.

  

• Отмена: форма будет закрыта без внесения изменений.

После выбора сервера нажмите Продолжить и подтвердите назначение в окне подтверждения

Добавление серверов в кластер

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

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

   Внимание

   ЦН должен быть открыт только на мастер-сервере кластера.

   После установки Платформы на сервер, предназначенный для добавления в кластер, ЦН открывать не следует. При первом открытии ЦН создается новый кластер, что делает невозможным добавление сервера в существующий кластер.

2. В ЦН перейдите в раздел Серверы.

3. В рабочей области раздела нажмите на кнопку + (Добавить).

   

4. На странице добавления сервера укажите следующие данные:

   • Название: название сервера, обязательно для заполнения.

   • Имя: имя сервера, необязательно для заполнения.

   • Комментарий: описание сервера, необязательно для заполнения.

   • Адрес: адрес сервера с установленной Платформой.

   • Порт: порт сервера с установленной Платформой (по умолчанию - 7290).

     

5. Установите флаг Включен.

6. Нажмите на кнопку Сохранить изменения.

7. Нажмите на кнопку Применить конфигурацию.

   Внимание

   Мастером становится сервер, на котором запущено первое применение конфигурации в кластере.

   Внимание

   Один из серверов кластера всегда будет являться мастером, управляющим работой других серверов кластера.

   Начиная с версии 3.2.0, Центр мониторинга является распределенным и запускается на каждом сервере кластера в виде отдельного сервиса. Веб-интерфейс Центра мониторинга доступен по адресу каждого сервера кластера и не зависит от выбора мастера.

   Для открытия ЦМ рекомендуется использовать кнопку Центр мониторинга и администрирования в разделе Обслуживание ‣ Управление конфигурацией или Перейти в Центр мониторинга в элементах управления ЦН.

   

   При успешном подключении сервера к кластеру он будет отображен в рабочей области раздела ЦМ Серверы с индикатором зеленого цвета.

8. Повторите шаги 2-7 для последовательной установки других серверов.

Внимание

Системное время между серверами кластера должно быть синхронизировано. В противном случае последовательность при построении цепочек в ЦМ будет некорректной.

Вывод сервера из кластера

Для вывода сервера из кластера:

1. В ЦН в кластере удалить сервер (открепить от кластера).

2. Нажмите на кнопку Сохранить изменения.

3. Нажмите на кнопку Применить конфигурацию.

4. Вручную почистите файлы Платформы на этом сервере (кэш, архив, логи).

5. На этом сервере заново установить Платформу - запустить установщик. Сохранить, применить конфигурацию.

6. Таким образом авторизоваться в независимом от кластера ЦН.

Управление сервером с неизвестного ЦН

Если сервер получит запрос от ЦН, адрес которого не находится в списке доверенных, сервер не примет запрос и в ответ отправит сообщение с ошибкой. В ЦН будет отображена следующая ошибка: В списке зарегистрированных Центров настроек на сервере отсутствует адрес сервера Центра настроек. Чтобы добавить адрес ЦН в список доверенных на сервере-координаторе, выполните следующую команду на машине сервера-координатора:

Для Windows:

DatareonPlatformService.exe SetCS <ip adress>

Для Linux:

sudo /usr/bin/datareon/platform/DatareonPlatformService setCS <ip adress>

После этого потребуется повторно применить конфигурацию в ЦН.