Словарь для мониторинга

Словари для мониторинга – специальный тип словарей для хранения данных, используемых при настройке задач мониторинга. Функционально словари для мониторинга идентичны обычным словарям.

Словари для мониторинга настраиваются в отдельном меню конфигурации, а также имеют отдельные запросы REST API.

Словари для мониторинга можно объединять в Группы словарей для мониторинга.

Именованные поля

Каждому значению словаря можно присвоить название. Например, словарь, который хранит список измерительных приборов, может выглядеть следующим образом:

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

Присвоить названия полям можно только при импорте словаря из таблицы Excel. В текущей версии пользовательского интерфейса системы SmartDCIM функционал переименования столбцов недоступен.

Для импорта именованных полей, таблица должна выглядеть следующим образом:

Название	Серийный номер	Ввод в эксплуатацию
ПУЛЬСАР 1ш-1-5/60-0-1-0	MKL68JLASKH8	24.03.2021
Инкотекс Меркурий 236	GRY9RK635VQM	16.09.2023
Инкотекс Меркурий 201.7	AA8RQPVD3JL8	03.11.2024

Зашифрованные поля

Поля в словарях могут быть зашифрованными. Для этого, название поля должно содержать слово password (не зависит от регистра). Для изменения значений зашифрованных полей нужно ввести значение заново в соответствующее поле. Расшифровать и использовать данные можно только на стороне сервера.

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

{
    "content": "{\"john.doe\":\"<<crypt:8D0E4E0C1EFC3D4533005804379270C8:96CB2385E0E693D391DD69A156088C46ACAEBEF2C7266993509723F7ECA7DE42>>\",\"jane.doe\":\"<<crypt:280B6896DECF67A730AC1AE011B254FF:0BF81AAF0B206712967008CA9BC9367C>>\"}",
}

NOTE

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

Адресация полей

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

Словари используют следующую адресацию:

Индекс элемента	Значение
0	Ключ
1 .. N	Значения словаря. N – количество полей в словаре.
N + 1, отрицательные значения	undefined.

Системные словари

В системе есть специальные словари для мониторинга, которые используются для аутентификации в некоторых встроенных сенсорах.

Эти словари находятся в группе "Системные словари" с ID system. Переименовать и сменить ID этой группы нельзя.

В этой группе есть следующие системные словари:

• Учётные данные подключений
• Учётные данные подключений по SNMP
• Формат учётной записи

Системная группа и словари создаются по умолчанию.

Учётные данные подключений

В этом словаре хранятся учётные записи, которые можно использовать для аутентификации в следующих проверках:

• FTP-сенсор
• JMX-сенсор
• Выполнение SSH скрипта

Этот словарь имеет следующие поля:

• id
• name
• description
• comment
• domain
• user
• password
• privateKey

Учётные данные подключений по SNMP

В этом словаре хранятся учётные записи, которые можно использовать для аутентификации в сенсорах SNMP.

Этот словарь имеет следующие поля:

• id
• name
• description
• comment
• communityRead
• communityWrite
• domain
• user
• authPassword
• authType
• privPassword
• privType

Формат учётной записи

В этом словаре хранятся настройки форматов аутентификации для некоторых проверок.

Этот словарь имеет следующие поля:

• id
• login_format
• description
• comment

Модель словаря для мониторинга

Поле	Тип	Описание
columns	Object
Названия столбцов (ключа и значений) словаря. Присутствует только словарях с именованными столбцами.

Определяется как объект JSON следующего вида:

"columns": { "0": { "name": "название ключа" }, "1": { "name": "название первого значения" }, "2": { "name": "название второго значения" }, ... },

Значения в объекте можно пропускать и оставлять столбцы неназванными.

| | Значения в объекте можно пропускать и оставлять столбцы неназванными. | | | Значения в объекте можно пропускать и оставлять столбцы неназванными. | | | | | content | String | Пары ключ-значение, где ключ – реальное значение метрики, а значение – отображаемое пользователю в виджетах. | | | | contentType | String | Строка, которая содержит тип значения словаря. В текущей реализации, всегда содержит object. | | | | comment | String | Пользовательский комментарий к словарю. | | | | description | String | Описание словаря. | | | | group | String | ID группы, к которой принадлежит словарь. | | | | id | String | Идентификатор словаря. | | | | key_auto_gen | Boolean | Включить автоматическую генерация ключей. Если true – система будет генерировать ключи в формате UUIDv4 для новых записей. | | | | name | String | Название словаря. | | |