Тип 1c-xml используется для получения данных из журналов регистрации программы 1С. При обработке коннектором многострочные события преобразовываются в однострочные. Коннектор этого типа доступен для Linux-агентов.
При создании этого типа коннектора требуется указать значения для следующих параметров:
Вкладка Основные параметры:
Название (обязательно) – уникальное имя для этого типа ресурса. Должно содержать от 1 до 128 символов в кодировке Unicode.
Тенант (обязательно) – название тенанта, которому принадлежит ресурс.
Тип (обязательно) – тип коннектора, 1c-xml.
URL (обязательно) – полный путь до директории с файлами, с которыми требуется выполнять взаимодействие. Например, /var/log/1c/logs/.
Префиксы, которые невозможно использовать при указании путей к файлам:
/*
/bin
/boot
/dev
/etc
/home
/lib
/lib64
/proc
/root
/run
/sys
/tmp
/usr/*
/usr/bin/
/usr/local/*
/usr/local/sbin/
/usr/local/bin/
/usr/sbin/
/usr/lib/
/usr/lib64/
/var/*
/var/lib/
/var/run/
/opt/kaspersky/kuma/
Файлы по указанным ниже путям доступны:
/opt/kaspersky/kuma/clickhouse/logs/
/opt/kaspersky/kuma/mongodb/log/
/opt/kaspersky/kuma/victoria-metrics/log/
Описание – описание ресурса: до 4000 символов в кодировке Unicode.
Вкладка Дополнительные параметры:
Кодировка символов – параметр для установки кодировки символов. Значение по умолчанию: UTF-8.
Отладка – переключатель, с помощью которого можно указать, будет ли включено логирование ресурса. По умолчанию положение Выключено.
Схема работы коннектора:
Происходит поиск всех файлов с журналами 1C с расширением XML внутри указанной директории. Журналы помещаются в директорию или вручную, или через приложение, написанное на языке 1С, например, с помощью функции ВыгрузитьЖурналРегистрации(). Коннектор поддерживает журналы, полученные только таким образом. Подробнее о том, как получить журналы 1С, см. в официальной документации 1С.
Файлы сортируются по возрастанию времени последнего изменения и отбрасываются все файлы, измененные раньше, чем последний прочитанный.
Сведения об обработанных файлах хранятся в файле /<рабочая директория коллектора>/1c_xml_connector/state.ini и имеют следующий формат: "offset=<число>\ndev=<число>\ninode=<число>".
В каждом непрочитанном файле определяются события.
События из файла по очереди принимаются на обработку, при этом многострочные события преобразовываются в однострочные события.
Ограничения коннектора:
Установка коллектора с коннектором 1c-xml на ОС Windows не поддерживается. Чтобы обеспечить передачу файлов с журналами 1С для обработки коллектором KUMA, выполните следующие действия:
На сервере Windows предоставьте доступ для чтения по сети к папке с журналами 1С.
На сервере Linux примонтируйте сетевую папку с журналами 1С на сервере Linux (cм. список поддерживаемых ОС).
На сервере Linux установите коллектор, который будет обрабатывать файлы с журналами 1С из примонтированной сетевой папки.
Не читаются файлы с некорректным форматом событий. Например, если теги события в файле на русском языке, коллектор не прочитает такие события.
Если дополнить уже прочитанный коннектором файл новыми событиями и если этот файл не является последним прочитанным файлом в директории, все события из файла будут обработаны заново.