Базовый сервис Хранилище сообщений

О базовом сервисе

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

Данные Хранилища сообщений хранятся в DatareonDB. Базовый сервис запускается на каждом сервере кластера.

Путь к каталогу с файлами Хранилища сообщений отображается в ЦМ, путь: Серверы -> Хранилище сообщений -> вкладка Основные. Для резервного копирования данных следует скопировать содержимое этого каталога.

../../../_images/module_storage_data_path.png

Настройки

Вкладка Основные:

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

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

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

../../../_images/module_storage_settings.png

Для дополнительных настроек перейдите в режим редактора конфигурации.

Работа с записями Хранилища

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

Что просмотреть сообщения, сохраненные в Хранилище, перейдите в ЦМ, раздел Серверы -> Хранилище сообщений -> вкладка Сообщения. Если в кластере несколько серверов, то у каждого из них собственная страница Хранилища сообщений с сообщениями, которые сохранились при выполнении процессов на данном сервере.

Примеры методов C# для работы с записями Хранилища сообщений доступны в разделе Функции Хранилища сообщений.

Индексирование данных

Индексирование данных используется для выполнения поиска по телам сообщений в Хранилище.

Механизм индексирования данных запускается после загрузки Хранилища сообщений и завершения основных задач базы данных (проверка целостности, формирование новых колонок и заполнение их значениями). Индексирование данных повторяется каждые 5 минут в течение всего времени работы Платформы.

Время работы механизма индексирования не регламентировано и зависит от количества и размера сообщений.

По умолчанию индексирование данных выключено. Чтобы включить индексирование, перейдите в ЦН по пути: Обслуживание -> Базовые сервисы -> Хранилище сообщений. Перейдите в режим редактора конфигурации.

За индексирование отвечает параметр MessageStorageIndexationOptions (string), его значения:

  • IndexationStopped: индексирование данных выключено (значение по умолчанию).

  • None: индексирование данных включено.

После изменения параметра необходимо перезапустить Хранилище сообщений.

Хранение данных

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

Настройка выполняется в режиме редактора конфигурации – за нее отвечают параметры datareonDBConfig:

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

  • storageDataCleaningMaxRetentionTimeInDays (integer): срок хранения сообщений в Хранилище в днях. После автоматического удаления в Хранилище останутся только сообщения, срок хранения которых не превышает установленное ограничение.

  • storageDataCleaningSchedule (string): расписание запуска очистки данных в формате Cron. По умолчанию «0 * * * *» – запуск очистки один раз в час.

  • storageDataCleaning (string): включена ли очистка данных.