Экспорт и импорт активности пользователей
8 800 555-89-02
Войти
Документация
CTRL+K
Standalone2409
SaaS

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

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

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

Также у конфигурационного файла системы com.infomaximum.subsystem.monitoring.json должен быть выключен параметр по разбору и синхронизации архивов активности, принятой с агентов, и последующей передачей в CH. У параметра parsing_activity_enabled должно быть значение false.

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

Чтобы выгрузить данные активности в указанный каталог на диске, введите 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_msLongвремя выполнения операции в миллисекундах
total_sizeLongразмер необработанных байтов, прочитанных из встроенной файловой базы данных с учетом наименования, но без учета внешних метаданных архива контейнера
countIntобщее количество экспортируемых архивов с активностью из встроенной файловой базы данных
filesStringсписок имен файлов, сформированных в процессе экспорта в указанном каталоге

Во время экспорта запись новых архивов во встроенную файловую базу данных блокируется. Файл выгружается с названием 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
    }
  }
}
Предупреждение

Если источник активности и пользователь отсутствуют, необходимо выполнить GraphQL-запрос с использованием ключа API и из ссылки убрать букву i в слове «graphiql». Пример: automation-dev.preview.infomaximum.com/graphql?&api_key=ключ. После изменения ссылки необходимо обновить страницу.

Укажите:

  • directory_path — путь на сервере, откуда импортируются данные активности
  • is_create_by_login: true/false — параметр, который отвечает за проверку на наличие источников у пользователя и его создание при необходимости:
    • если источник по login и domain есть в базе, считается, что источник существует, и дальнейшая работа по нему не требуется
    • если источник по login существует, но нет соответствия по domain, из полученного источника извлекается идентификатор пользователя, и этому пользователю создается новый источник
    • если не найдено соответствие по login и domain, источник создается автоматически
ПолеТип данныхОпределение
time_msLongВремя выполнения операции MS
total_sizeLongРазмер необработанных байтов, прочитанных из контейнера архива с учетом наименования
countIntОбщее количество импортируемых архивов с активностью из встроенной файловой базы данных
filesStringСписок имен файлов прочитанных операцией импорта

Для импорта активности поместите архивы агента мониторинга в один архив с названием activity_queue_({C}-{CN})_{yyyy_MM_dd_HH_mm_ss_SSS}.zip, где:

  • {C} — первый ключ
  • {CN} — последний ключ
  • {yyyy_MM_dd_HH_mm_ss_SSS} — время формирования архива
Заметка

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

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

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

Примечание:

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

Была ли статья полезна?

Да
Нет
Предыдущая
Хранение логов агента мониторинга
8 (800) 555-89-028 (495) 150-31-45team@infomaximum.com
Для бизнеса
© 20102024. ООО «Инфомаксимум»
Мы используем файлы cookies, чтобы сайт был лучше для вас.