Экспорт и импорт активности пользователей

В системе предусмотрен экспорт и импорт активности пользователей. Для выгрузки и загрузки активности необходимо подключить привилегию Экспорт/Импорт активности пользователей с операцией выполнения Е.

Экспорт активности

Чтобы выгрузить данные активности в указанный каталог на диске, введите GraphQL-запрос:

mutation{
  activity_exchange{
    export_activity_queue(directory_path:"C:\\work\\Business-Projects\\activity\\monitoring\\data\\backup", limit_per_file:25000){
      time_ms
      total_size
      count
      files
    }
  }
}

Укажите:

directory_path – путь, куда экспортируются данные активности;
limit_per_file – лимит файлов в одном контейнере экспорта. Если лимит файлов не задан, то выгружаемые данные будут делиться по 25000 архивов активности.

Поле	Тип данных	Определение
time_ms	Long	время выполнения операции в миллисекундах
total_size	Long	размер необработанных байтов, прочитанных из встроенной файловой базы данных с учетом наименования, но без учета внешних метаданных архива контейнера
count	Int	общее количество экспортируемых архивов с активностью из встроенной файловой базы данных
files	String	список имен файлов, сформированных в процессе экспорта в указанном каталоге

Для выгрузки активности у конфигурационного файла системы com.infomaximum.subsystem.monitoring.json должен быть выключен параметр по разбору и синхронизации архивов активности, принятой с агентов, и последующей передачей в CH. У параметра parsing_activity_enabled должно быть значение false. Во время экспорта запись новых архивов во встроенную файловую базу данных блокируется. Файл выгружается с названием activity_queue_({C}-{CN})_{yyyy_MM_dd_HH_mm_ss_SSS}.zip, где:

{C} – первый ключ;
{CN} – последний ключ;
{yyyy_MM_dd_HH_mm_ss_SSS} – время формирования архива.

Пример названия архива: activity_queue_(1-3)_2022_12_21_16_22_46_000.zip.

Данные активности не экспортируются, если:

в GraphQL-запросе не указан путь, куда выгружаются данные;
на диске не существует путь или указан файл, а не каталог;
не удалось блокировать запись активности в очередь в течении 800 мс. В этом случае ожидается повторный запрос.

Импорт активности

Чтобы загрузить данные активности из указанного каталога на диске, введите GraphQL-запрос:

mutation{
  activity_exchange{
    import_activity_queue(directory_path:"C:\\work\\Business-Projects\\activity\\monitoring\\data\\backup", is_create_by_login:true){
      time_ms
      total_size
      count
      files
    }
  }
}

Укажите:

directory_path – путь, куда импортируются данные активности;
is_create_by_login: true/false – параметр, который отвечает за проверку на наличие источников у пользователя и его создание при необходимости:
- Если источник по login и domain есть в базе, считается, что источник существует, и дальнейшая работа по нему не требуется;
- Если источник по login существует, но нет соответствия по domain, из полученного источника извлекается идентификатор пользователя, и этому пользователю создается новый источник;
- Если не найдено соответствие по login и domain, источник создается автоматически.

Поле	Тип данных	Определение
time_ms	Long	Время выполнения операции MS
total_size	Long	Размер необработанных байтов, прочитанных из контейнера архива с учетом наименования
count	Int	Общее количество импортируемых архивов с активностью из встроенной файловой базы данных
files	String	Список имен файлов прочитанных операцией импорта

Данные активности не импортируются, если:

в GraphQL-запросе не указан путь, куда выгружаются данные;
на диске не существует путь или указан файл, а не каталог.

Примечания:

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

Хранение логов агента мониторинга

Агент мониторинга на ОС Linux