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

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

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

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

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

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

named fields
Пример словаря с именованными полями

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

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

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

Название

Серийный номер

Ввод в эксплуатацию

ПУЛЬСАР 1ш-1-5/60-0-1-0

MKL68JLASKH8

24.03.2021

Инкотекс Меркурий 236

GRY9RK635VQM

16.09.2023

Инкотекс Меркурий 201.7

AA8RQPVD3JL8

03.11.2024

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

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

encrypted

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

{
    "content": "{\"john.doe\":\"<<crypt:8D0E4E0C1EFC3D4533005804379270C8:96CB2385E0E693D391DD69A156088C46ACAEBEF2C7266993509723F7ECA7DE42>>\",\"jane.doe\":\"<<crypt:280B6896DECF67A730AC1AE011B254FF:0BF81AAF0B206712967008CA9BC9367C>>\"}",
}
Для шифрования полей необходимо включить шифрование в серверной конфигурации. Без этих предварительных настроек шифрование происходить не будет, а лишь будет скрываться значение в соответствующем поле в интерфейсе отображения справочника.

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

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

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

Индекс элемента Значение

0

Ключ

1 .. N

Значения словаря. N – количество полей в словаре.

N + 1, отрицательные значения

undefined.

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

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

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

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

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

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

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

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

  • 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

Название словаря.