Экспорт и импорт активности пользователей
В системе предусмотрен экспорт и импорт активности пользователей. Для выгрузки и загрузки активности необходимо подключить привилегию Экспорт/Импорт активности пользователей с операцией выполнения Е.
Экспорт активности
Чтобы выгрузить данные активности в указанный каталог на диске, введите 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-запросе не указан путь, куда выгружаются данные;
- на диске не существует путь или указан файл, а не каталог.
Примечания:
- ошибки, связанные с системой ввода-вывода, будут отображены в журнале событий;
- чтобы активность пользователя с одного сервера при импорте соответствовала этому же пользователю на другом сервере, ему необходимо создать источник с логином и доменом;
- после импорта файлы с диска удаляются, данные активности записываются во встроенную файловую базу данных.