Подключение Alertix к 1С с использованием OData

Для подключения Alertix к 1С используется специальный сервис с нестандартным транспортом 1С custom-ресивера, который открывает для сбора логов порт TCP/80.

Настройка 1С:

Для сбора логов 1С по протоколу OData необходимо на веб-сервере создать пользователя с правами на чтение необходимых журналов (стандартно Catalog_внЖурналРегистрации и всех сопутствующих - пользователи, компьютеры и др., полный перечень ниже). Логин-пароль для подключения следует передать вместе с URL для подключения и разрешить доступ по сети от сенсора до сервера.

Для преобразования идентификаторов в читаемые значения также необходим доступ к каталогам:

  • Catalog_внИнформационныеБазы;

  • Catalog_внУзлыРИБ;

  • Catalog_внМетаданные;

  • Catalog_внПользователи;

  • Catalog_внКомпьютеры;

  • Catalog_внСобытия.

Используйте Подсистему "Журнал регистрации во внешней информационной базе 1С", рекомендаций по настройкам журналирования нет. С описанием Подсистемы можно ознакомиться на сайте производителя по ссылке.

Подробное описание:

Стандартный коннектор запрашивает данные из каталога Catalog_внЖурналРегистрации следующего описания:

<EntityType Name="Catalog_внЖурналРегистрации">
<Key> <PropertyRef Name="Ref_Key"/></Key>
<Property Name="Ref_Key" Type="Edm.Guid" Nullable="false"/>
<Property Name="Predefined" Type="Edm.Boolean" Nullable="true"/>
<Property Name="PredefinedDataName" Type="Edm.String" Nullable="true"/>
<Property Name="DataVersion" Type="Edm.String" Nullable="true"/>
<Property Name="Code" Type="Edm.Int64" Nullable="true"/>
<Property Name="DeletionMark" Type="Edm.Boolean" Nullable="true"/>
<Property Name="ДатаИзменения" Type="Edm.DateTime" Nullable="true"/>
<Property Name="ИнформационнаяБаза_Key" Type="Edm.Guid" Nullable="true"/>
<Property Name="УзелРИБ_Key" Type="Edm.Guid" Nullable="true"/>
<Property Name="Версия" Type="Edm.Int64" Nullable="true"/>
<Property Name="МетаданныеОбъекта_Key" Type="Edm.Guid" Nullable="true"/>
<Property Name="ИдентификаторОбъекта_Key" Type="Edm.Guid" Nullable="true"/>
<Property Name="ПредставлениеОбъекта" Type="Edm.String" Nullable="true"/>
<Property Name="Пользователь_Key" Type="Edm.Guid" Nullable="true"/>
<Property Name="Компьютер_Key" Type="Edm.Guid" Nullable="true"/>
<Property Name="Событие_Key" Type="Edm.Guid" Nullable="true"/>
<Property Name="СостояниеЗаписи" Type="Edm.Int16" Nullable="true"/>
<Property Name="ПропускатьОбработку" Type="Edm.Boolean" Nullable="true"/>
<Property Name="Данные_Base64Data" Type="Edm.Binary" Nullable="true"/>
<Property Name="Данные_Type" Type="Edm.String" Nullable="true"/>
<Property Name="Данные" Type="Edm.Stream" Nullable="true"/>
<NavigationProperty Name="ИнформационнаяБаза" Relationship="StandardODATA.Catalog_внЖурналРегистрации_ИнформационнаяБаза" FromRole="Begin" ToRole="End"/>
<NavigationProperty Name="УзелРИБ" Relationship="StandardODATA.Catalog_внЖурналРегистрации_УзелРИБ" FromRole="Begin" ToRole="End"/>
<NavigationProperty Name="МетаданныеОбъекта" Relationship="StandardODATA.Catalog_внЖурналРегистрации_МетаданныеОбъекта" FromRole="Begin" ToRole="End"/>
<NavigationProperty Name="ИдентификаторОбъекта" Relationship="StandardODATA.Catalog_внЖурналРегистрации_ИдентификаторОбъекта" FromRole="Begin" ToRole="End"/>
<NavigationProperty Name="Пользователь" Relationship="StandardODATA.Catalog_внЖурналРегистрации_Пользователь" FromRole="Begin" ToRole="End"/>
<NavigationProperty Name="Компьютер" Relationship="StandardODATA.Catalog_внЖурналРегистрации_Компьютер" FromRole="Begin" ToRole="End"/>
<NavigationProperty Name="Событие" Relationship="StandardODATA.Catalog_внЖурналРегистрации_Событие" FromRole="Begin" ToRole="End"/>
</EntityType>

Запрашиваемые из этого каталога данные представлены в JSON- формате и выглядят следующим образом:

{
"odata.metadata": "http://1c-server/ExternalLog_DocMngCorp/odata/standard.odata/$metadata#Catalog_внЖурналРегистрации",
"value": [{
"Ref_Key": "0459a855-203e-11ec-a2f0-005056ba1489",
"DataVersion": "AAAAABg+N44=",
"DeletionMark": false,
"Code": "4524893",
"ДатаИзменения": "2021-08-13T12:24:23",
"ИнформационнаяБаза_Key": "2341c7da-bbeb-11e8-b315-2c59e5428183",
"УзелРИБ_Key": "2341c7db-bbeb-11e8-b315-2c59e5428183",
"Версия": "0",
"МетаданныеОбъекта_Key": "df6a60a0-bc09-11e8-b315-2c59e5428183",
"ИдентификаторОбъекта_Key": "0459a854-203e-11ec-a2f0-005056ba1489",
"ПредставлениеОбъекта": "Документ (№ Вх-1111 от 12.08.2021)",
"Пользователь_Key": "205a095a-d2a9-11e8-84f6-2c59e5428183",
"Компьютер_Key": "aa933fb7-4ccc-11ea-8317-2c59e5428183",
"Событие_Key": "f7975bd5-cdde-47bc-bea8-8aa2c5876422",
"СостояниеЗаписи": 3,
"ПропускатьОбработку": false,
"Данные_Type": "application/xml+xdto",
"Данные_Base64Data": "",
"Predefined": false,
"PredefinedDataName": "",
"ИнформационнаяБаза@navigationLinkUrl": "Catalog_внЖурналРегистрации(guid'0459a855-203e-11ec-a2f0-005056ba1489')/ИнформационнаяБаза",
"УзелРИБ@navigationLinkUrl": "Catalog_внЖурналРегистрации(guid'0459a855-203e-11ec-a2f0-005056ba1489')/УзелРИБ",
"МетаданныеОбъекта@navigationLinkUrl": "Catalog_внЖурналРегистрации(guid'0459a855-203e-11ec-a2f0-005056ba1489')/МетаданныеОбъекта",
"ИдентификаторОбъекта@navigationLinkUrl": "Catalog_внЖурналРегистрации(guid'0459a855-203e-11ec-a2f0-005056ba1489')/ИдентификаторОбъекта",
"Пользователь@navigationLinkUrl": "Catalog_внЖурналРегистрации(guid'0459a855-203e-11ec-a2f0-005056ba1489')/Пользователь",
"Компьютер@navigationLinkUrl": "Catalog_внЖурналРегистрации(guid'0459a855-203e-11ec-a2f0-005056ba1489')/Компьютер",
"Событие@navigationLinkUrl": "Catalog_внЖурналРегистрации(guid'0459a855-203e-11ec-a2f0-005056ba1489')/Событие"
},{
"Ref_Key": "32e65b8e-2042-11ec-a2f0-005056ba1489",
"DataVersion": "AAAAABg+OOw=",
"DeletionMark": false,
"Code": "4525053",
"ДатаИзменения": "2021-08-13T12:54:56",
"ИнформационнаяБаза_Key": "2341c7da-bbeb-11e8-b315-2c59e5428183",
"УзелРИБ_Key": "2341c7db-bbeb-11e8-b315-2c59e5428183",
"Версия": "0",
"МетаданныеОбъекта_Key": "2341c7fb-bbeb-11e8-b315-2c59e5428183",
"ИдентификаторОбъекта_Key": "32e65b7e-2042-11ec-a2f0-005056ba1489",
"ПредставлениеОбъекта": "По протоколу №ТТТ-2222 от 02.12.2020 - важное собрание",
"Пользователь_Key": "1efb09b1-1edc-11e9-9845-2c59e5428183",
"Компьютер_Key": "0f3bbed9-cc89-11e8-9c4c-2c59e5428183",
"Событие_Key": "a62f0d03-650e-490c-96f7-003e462906df",
"СостояниеЗаписи": 1,
"ПропускатьОбработку": false,
"Данные_Type": "application/xml+xdto",
"Данные_Base64Data": "ххх",
"Predefined": false,
"PredefinedDataName": "",
"ИнформационнаяБаза@navigationLinkUrl": "Catalog_внЖурналРегистрации(guid'32e65b8e-2042-11ec-a2f0-005056ba1489')/ИнформационнаяБаза",
"УзелРИБ@navigationLinkUrl": "Catalog_внЖурналРегистрации(guid'32e65b8e-2042-11ec-a2f0-005056ba1489')/УзелРИБ",
"МетаданныеОбъекта@navigationLinkUrl": "Catalog_внЖурналРегистрации(guid'32e65b8e-2042-11ec-a2f0-005056ba1489')/МетаданныеОбъекта",
"ИдентификаторОбъекта@navigationLinkUrl": "Catalog_внЖурналРегистрации(guid'32e65b8e-2042-11ec-a2f0-005056ba1489')/ИдентификаторОбъекта",
"Пользователь@navigationLinkUrl": "Catalog_внЖурналРегистрации(guid'32e65b8e-2042-11ec-a2f0-005056ba1489')/Пользователь",
"Компьютер@navigationLinkUrl": "Catalog_внЖурналРегистрации(guid'32e65b8e-2042-11ec-a2f0-005056ba1489')/Компьютер",
"Событие@navigationLinkUrl": "Catalog_внЖурналРегистрации(guid'32e65b8e-2042-11ec-a2f0-005056ba1489')/Событие"
}]
}

Подключение источника к Alertix:

Для подключения источника к Alertix выполните следующие действия:

  1. В консоли управления Alertix перейдите в меню Обслуживание > Ресиверы > Custom.

  2. Нажмите значок pencil grey "Настройка ресивера" в строке таблицы с установленным ресивером custom.

  3. Выберите элемент "1С".

  4. Нажмите кнопку "Добавить новый граббер".

  5. Введите параметры конфигурации источника 1С (Название, Интервал, Поле даты), адрес сервера, каталог и учетные данные для подключения (имя пользователя и пароль).

  6. В поле Время начала сбора событий укажите временную метку по местному времени, с какого промежутка времени необходимо начать сбор и обработку событий (по умолчанию установлено текущее время в часовом поясе Москвы). Местное время будет конвертироваться в UTC+0, т.к. все временные метки приводятся к единой точке отсчета. При сравнении событий к нему будет прибавляться значение, указанное в поле Временная зона (например, UTC+3 (Москва)).

  7. Нажмите кнопку "Установить".

image
Рисунок 1.