Версия: 9.2

Метамодель РСМ

BUSINESSENTERPRISE

Функционал Метамодели РСМ (также называемый Настройки CMDB) предоставляет администраторам Monq возможность:

Создавать новые, редактировать или удалять существующие типы конфигурационных единиц в собственном пространстве Monq.
Определять собственные атрибуты для каждого типа конфигурационных единиц.

Управление типами КЕ

Для управлению типами КЕ, вы должны быть в группе Администраторов пространства с соответствующей ролью и правом просмотра/редактирования "Метамодели РСМ".

Перейдите через основное меню в раздел Администрирование - Настройки CMDB – откроется вкладка со списком доступных типов КЕ в системе.

На данной вкладке располагается список подключенных типов КЕ в системе и краткая информация о них (название, описание, идентификатор). Список отсортирован по идентификатору типа КЕ от большего к меньшему.

При выборе определенного типа КЕ в списке, - отображается подробная информация о данном типе КЕ:

Всего КЕ - количество КЕ, данного типа в системе

По клику отображается информация о количестве КЕ в разрезе Рабочих групп, которым принадлежат КЕ данного типа
Активные КЕ - количество активных КЕ, данного типа в системе

По клику отображается информация о количестве КЕ в разрезе Рабочих групп, которым принадлежат КЕ данного типа
Архивные КЕ - количество архивных КЕ, данного типа в системе

По клику отображается информация о количестве КЕ в разрезе Рабочих групп, которым принадлежат КЕ данного типа
Иконка типа КЕ - графическое изображение КЕ

При наличии соответствующих прав на редактирование "Метамодели РСМ" - администратор пространства может изменять иконку типа КЕ
Название типа КЕ - уникальное в рамках пространства название категории(класса) КЕ, попадающих под данный тип.

При наличии соответствующих прав на редактирование "Метамодели РСМ" - администратор пространства может изменять название типа КЕ
Описание типа КЕ - описание категории(класса) КЕ, попадающих под данный тип

При наличии соответствующих прав на редактирование "Метамодели РСМ" - администратор пространства может изменять описание типа КЕ
Жизненный цикл КЕ - информационное поле о принадлежности типа КЕ к определенному жизненному циклу.

В контекстом меню выбранного типа КЕ доступны действия:

Копирование идентификатора типа КЕ в буфер обмена
Создание копии типа КЕ
Экспорт типа КЕ
Удалить тип КЕ

Добавление нового типа КЕ

Администратор пространства с правами на редактирование "Метамодели РСМ" может добавить новый тип КЕ в систему.

Чтобы добавить новый тип КЕ в систему нажмите кнопку + Создать тип КЕ в правом верхнем углу.

Заполните в открывшемся окне параметры типа КЕ и нажмите Создать - новый тип КЕ будет добавлен в систему.

Экспорт/импорт

Для удобства настройки типов КЕ администраторам доступны функции:

Клонирование - создание копии типа КЕ
- Система автоматически создает строку в формате base64, полностью повторяющую процесс при экспорте.
- Название для нового типа КЕ генерируется автоматически по шаблону: "[Название исходного типа КЕ] - Copy N", где N — неповторяющийся номер по порядку, начиная с 1.
- Все настройки, входящие в экспорт, полностью переносятся в новый созданный тип КЕ.

Справка

После создания новый тип КЕ открывается с заполненными данными

Экспорт - экспорт настроек типа КЕ в формат base64
- Система преобразует настройки типа КЕ в формат base64
- По результату администратору предлагается:
  - Скачать файл в формате .txt с именем [Название_экспортируемого_типа_КЕ]_settings.txt (пробелы в названии заменяются на нижнее подчеркивание)
  - Скопировать получившуюся строку base64 в буфер обмена

Справка

В экспорт НЕ входит: Название типа КЕ

Импорт - импорт настроек типа КЕ из формата base64 в текущий тип КЕ при его импортировании (создании)

Важно

Все параметры и значения типа КЕ, созданного через импорт, полностью соответствуют экспортированным настройкам

Удаление существующего типа КЕ

Администратор пространства с правами на редактирование "Метамодели РСМ" может удалить существующий тип КЕ из системы.

Для удаления существующего типа КЕ из системы, предварительно необходимо удалить или изменить тип всех КЕ данного типа.

⚠️ При попытке удаления типа КЕ, в котором есть КЕ - будет выведено соответствующее предупреждение.

Управление атрибутами типа КЕ

В качестве атрибутов КЕ могут выступать все базовые типы переменных, а также структуры, заранее созданные в пользовательских библиотеках Автоматона.

Чтобы добавить атрибуты для типа конфигурационных единиц необходимо:

В разделе администрирования пространства - "Настройки CMDB" выберите существующий тип КЕ или создайте новый тип КЕ, которому предполагается назначить типовые атрибуты.
В настройке "Атрибуты КЕ" нажмите кнопку добавления нового атрибута + Атрибут
- при создании нового атрибута его название генерируется автоматически по шаблону а1, а2, а3 и т.д.
Определите название атрибута, выберите его тип (базовый тип или структура)
При необходимости задайте значения по умолчанию для каждого атрибута.

Важно

Изменение значений по умолчанию для существующего атрибута не влияет на уже созданные КЕ. Значения по умолчанию применяются только к новым экземплярам КЕ данного типа.

Сохраните изменения.

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

Атрибутами можно управлять вручную через графический интерфейс системы, а также используя сценарии автоматизации при автоматическом построении РСМ.

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

Компоненты типа КЕ

Блок представлен в виде списка плашек. Каждая плашка содержит:

Название компонента.
Индикацию, является ли компонент компонентом по умолчанию.
Набор слотов (при их наличии).

При клике на плашку компонента открывается боковая панель (подкат) с полным набором настроек данного компонента, включая управление слотами.

Компоненты задаются строго на типе КЕ и не могут быть изменены на экземпляре типа. При создании компонентов каждому из них должны быть присвоены параметры по умолчанию, которые задаются в Метамодели РСМ на типе КЕ:

Влияние компонента на здоровье КЕ
Параметры расчета здоровья компонента:
- Весовой
- Комбо
Влияние сигнала на здоровье компонента
Влияние КЕ на здоровье компонента

Задать приоритетные настройки можно на экземпляре в Здоровье на Карте РСМ.

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

Настройки покрытия мониторингом

Для создания слотов на Компоненте типа КЕ, выберите нужный компонент (клик по плашке) и в открывшейся боковой панели перечислите слоты данного компонента.

Например, для мониторинга компонента CPU мы можем определить следующие слоты:

Utilization - загрузка процессора
Temperature - температура процессора
ioWait - показатель iowait
Frequency - тактовая частота
Cores - количество ядер

Привязка порогов к слотам компонентов будет осуществляться по названию компонента, слота и идентификатору КЕ. При проектировании метамодели РСМ учтите данный фактор.

Модель статуса КЕ

Статусы типа КЕ зависят от здоровья, и их модель может быть уникальной для каждого типа КЕ. Задать интервалы статусов (в процентах здоровья) можно на типе КЕ в Метамодели РСМ с точностью до сотых. Также есть возможность удаления любого из статусов.

Ключевые атрибуты типа КЕ

Для каждого отдельного типа КЕ можно определить параметр или группу параметров - Атрибутов, по значениям которых можно было бы однозначно идентифицировать КЕ и быстро получить ее при фильтрации через публичные функции API.

На основе ключевых атрибутов КЕ формируется кэш для быстрого поиска КЕ данного типа в системе и используется в сценариях автоматизации для уменьшения времени ответа при поиске КЕ в системе.

Прирост скорости работы с использованием ключевых атрибутов КЕ заметен на установках, содержащих более 15000 активных КЕ.

Атрибуты, содержащие ключевые атрибуты выделяются зеленым цветом и обозначаются иконкой в виде ключа.

Определить какие атрибуты типа КЕ будут являться ключевыми можно следующим образом:

Добавьте новый атрибут для типа КЕ
Перейдите в панель Управление ключевыми атрибутами
При помощи кнопки + Группа ключей добавьте атрибуты, которые будут являться ключевыми для данного типа КЕ.

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

В роли ключевых атрибутов КЕ, могут быть атрибуты следующего типа:

Integer

Integer64

Double

Guid

String

⚠️ Использование массивов данных типов данных НЕ поддерживается!

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

Возможны следующие случаи:

У типа КЕ нет ни одной КЕ - администратор получит зеленое уведомление и хэш по созданным КЕ будет сформирован
При создании КЕ ее атрибуты имеют значение null, если значения по умолчанию не переопределены на типе КЕ
Все КЕ определенного типа КЕ имеют значения для выбранных атрибутов (не null и не "") и комбинации этих значений уникальны - администратор получит зеленое уведомление и хэш по таким КЕ будет сформирован
Все КЕ определенного типа КЕ имеют значения для выбранных атрибутов (не null и не "") и комбинации этих значений не уникальны - администратор получит красное сообщение, что группа параметров не может быть сохранена
У типа КЕ есть КЕ, у которой заполнены не все ключевые атрибуты (не null и не ""), но заполненные атрибуты каждой КЕ уникальны в комбинации - администратор получит зеленое уведомление и хэш по таким КЕ будет сформирован
У типа КЕ есть КЕ, у которой заполнены не все ключевые атрибуты (есть значения null или ""), но заполненные атрибуты каждой КЕ не уникальны в комбинации - администратор получит красное сообщение, что группа параметров не может быть сохранена
У типа КЕ есть КЕ, у которой не заполнены все ключевые атрибуты (значения null или ""), а комбинации значений в остальных КЕ уникальны - администратор получит желтое уведомление о том, что такие КЕ не будет найдены поиском и хэш по ним не сформируется
У типа КЕ есть КЕ, у которой не заполнены все ключевые атрибуты (значения null или ""), а комбинации значений в остальных КЕ не уникальны - администратор получит красное сообщение, что группа параметров не может быть сохранена

Настройки CacheInvalidation

Для инвалидации (обновления) кэша ключевых атрибутов доступны следующие настройки сервиса sm-rsm-attributes-service:

Свойство	Описание	Формат	Пример	По умолчанию
Enabled	Флаг включения инвалидации	boolean	true	true
Rate	Частота инвалидации кэша	D.HH:mm:ss (string)	"1.00:00:00"	1 день
ConfigItemsPerIteration	Количество КЕ, получаемых за одну итерацию	number	500	1000
ConfigItemTypeIds	Список ID типов КЕ, для которых нужно проводить инвалидацию кэша	number[]	[34,56,789]	null

Для изменения свойств используется клиент управления monqctl через команду monqctl registry apply.

Применяемая настройка обновляет все свойства!

Если обновить только Enabled, остальные свойства затрутся значениями по умолчанию.

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

Проверка текущей конфигурации:

monqctl registry get microservice-parameters sm-rsm-attributes-service --output json | jq '.[] | select(.Name == "CacheInvalidation") | .Value'

Пример ответа, выводимого в консоль:

{
  "Enabled": false,
  "ConfigItemTypeIds": [
    1,
    2,
    3
  ]
}

Применение новой конфигурации с обновленными свойствами:

monqctl registry apply microservice-parameter sm-rsm-attributes-service \
--name=CacheInvalidation \
--settingsKey="appsettings.json" \
--value='
{
  "Enabled": true,
  "Rate": "0.12:00:00",
  "ConfigItemTypeIds": [
    48,
    51,
    79
  ]
}
'

Перезапуск микросервиса:

monqctl instance restart microservice --microservice=sm-rsm-attributes-service

Проверка лога микросервиса sm-rsm-attributes-service после перезапуска:
```
kubectl logs -n production deployment/sm-rsm-attributes-service | grep Cache
```
Свидетельством успешного запуска инвалидации в его логах должна появиться запись вида:
```
INF ["CacheInvalidationService"] Cache invalidation is started
```
Если запись не появилась,
то возможна ситуация, когда в кеше Redis осталась неактуальная дата прошлых запусков.
Их можно очистить вручную командами DEL на сервере Redis с помощью клиента redis-cli, либо на сервере Monq через monqctl + kubectl:
1. Получить пароль к Redis:
  monqctl registry get services Redis
2. Подключиться к Redis:
  kubectl exec -n infra redis-0 -ti -- redis-cli
3. Авторизоваться:
  auth <пароль из шага 1>
4. Выбор базы (всегда под номером 1):
  SELECT 1
5. Удалить ключи с неактуальной датой:
  DEL "Production:sm-rsm-attributes-service:InvalidationDate" DEL "Production:sm-rsm-service:DataSyncDate"
После чего повторно перезапустить микросервис и проверить лог.

Сервис синхронизации здоровья, статусов и атрибутов КЕ

В системе предусмотрен фоновый сервис синхронизации статусов, здоровья и атрибутов КЕ между базами данных, если распространение данных было не выполнено в связи с какими-либо проблемами в инфраструктуре.

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

Для изменения свойств используется клиент управления monqctl через команду monqctl registry apply.

В сервисе sm-rsm-service-sync в секции DataSync возможно указание следующих настроек:

"DataSync": {
  "Enabled": true,                # Флаг включения синхронизации (false по умолчанию)
  "Rate": "1.00:00:00",           # Частота синхронизации (1 день по умолчанию)
  "ConfigItemsPerIteration": 1000 # Количество КЕ, получаемых за одну итерацию синхронизации (1000 по умолчанию)
}

Управление типами КЕ​

Добавление нового типа КЕ​

Экспорт/импорт​

Удаление существующего типа КЕ​

Управление атрибутами типа КЕ​

Компоненты типа КЕ​

Настройки покрытия мониторингом​

Модель статуса КЕ​

Ключевые атрибуты типа КЕ​

Настройки CacheInvalidation​

Сервис синхронизации здоровья, статусов и атрибутов КЕ​