Resource_service_model: Группы хостов

Mon, 01 Jan 0001 00:00:00 +0000

Версия

Группы хостов доступны начиная с версии 204.

На этой странице:

Что такое группа хостов
Как открыть
Список групп
Карточка группы
Состав группы
Хосты без данных
Имена групп и хостов
Переименование и удаление
Где используются группы
Права доступа
Группы в РСМ
Ограничения версии 204

Что такое группа хостов

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

выдать роли доступ к данным сразу нескольких хостов, не перечисляя их в роли;
отфильтровать дашборд по группе и увидеть группу в отдельной колонке таблицы «Все хосты»;
объявить окно обслуживания на все хосты группы.

Пользователям, переходящим с Zabbix, понятие знакомо: хост может входить в несколько групп, а права выдаются на группу. Совместимость с форматами и API Zabbix не заявляется.

Группа хранится в ресурсно-сервисной модели как ресурс типа host_group, её состав — как связи «содержит» с хостами. В составе могут быть только хосты, на которых работает агент Linux или Windows. Вложенных групп нет.

Группа живёт, пока её не удалит пользователь. Состав меняется только вручную: пропажа данных, списание хоста в РСМ и его возвращение состав не затрагивают.

Как открыть

Главное меню → Инфраструктура → Группы хостов. Пункт виден пользователям с правом просмотра resource_group (см. Права доступа).

Список групп

Таблица со всеми группами. Поиск ведётся по имени.

Колонка	Описание
Имя	Имя группы
Описание	Необязательное описание
Хостов	Число хостов в составе
Без данных	Число хостов, которые числятся в составе, но данных от которых нет

Кнопка Создать группу открывает форму «Новая группа хостов». Правила для полей формы:

Имя — обязательное, от 1 до 128 символов. Если группа с таким именем уже есть, форма сообщает «Группа с таким именем уже есть» и предлагает её открыть.
Описание — необязательное, не длиннее 1024 символов.

Если групп ещё нет, список подсказывает: соберите хосты в группу, чтобы выдавать по ней доступ, фильтровать дашборды и ставить окна обслуживания.

Карточка группы

Карточка открывается по клику на группу. Кнопки в шапке: Переименовать, Изменить состав, Удалить (две последние — при праве редактирования). Вкладки:

Вкладка	Что показывает
Состав	Хосты группы и их состояние. Хост ведёт на его дашборд Proto-Linux-Service. Кнопка Открыть на «Все хосты» открывает дашборд Proto-Linux-Root с фильтром по этой группе
Доступ	Роли, которым выдан доступ к группе. Ссылка на роль доступна только пользователям, которые могут править роли
Обслуживание	Окна обслуживания, нацеленные на эту группу, со статусом «активно», «запланировано» или «истекло»

Если группу переименовали или удалили, а ссылка на неё осталась, страница сообщает «Группа не найдена».

Состав группы

Состав меняется кнопкой Изменить состав (право редактирования). Хосты можно выбрать двумя способами:

Из РСМ — поиск среди известных платформе хостов;
Списком — имена хостов через перевод строки, запятую или пробел.

За один запрос принимается не больше 1000 имён.

Доступны три операции:

Операция	Действие
Добавить	Добавляет указанные хосты в состав
Убрать	Убирает указанные хосты из состава
Заменить состав	Делает состав равным указанному списку; диалог показывает, сколько хостов уйдёт из группы

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

Результат	Значение
добавлен	Хост добавлен в группу
уже в группе	Хост уже был в составе
создан	Хоста не было в РСМ, создан хост без данных и добавлен в группу
не найден	Хоста нет в РСМ, ничего не сделано
убран	Хост убран из группы
не в группе	Убирать нечего: хоста в составе не было

Хост, которого платформа ещё не видела, добавляется только явно: отметьте Создать N хостов без данных. Такой хост создаётся как ручной ресурс; когда от хоста с тем же именем появятся данные, платформа сопоставит их с этим ресурсом.

Хост, убранный из последней группы, удаляется из РСМ, если по нему нет данных и других связей. Хост с данными остаётся.

Хосты без данных

Хост из состава может не присылать данные. На вкладке Состав для такого хоста показывается одно из состояний:

Состояние	Значение
списан в РСМ	Ресурс хоста списан в РСМ
данных не было	Хост добавлен вручную, телеметрии от него не поступало
молчит с (время)	Данные от хоста были, но перестали поступать

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

В списке групп такие хосты считаются в колонке Без данных. На дашборде «Все хосты» при выбранной группе они показываются отдельными строками — см. Дашборды.

Лицензия

Хост, не попавший в лимит лицензии, на экране не отличается от хоста без данных.

Имена групп и хостов

Имя группы уникально без учёта регистра и пробелов по краям: при попытке создать «Прод» рядом с «прод» платформа ответит конфликтом и укажет существующую группу.
Символ «/» в имени разрешён. Вложенности в версии 204 нет — «/» остаётся обычным символом имени.
Регистр имён хостов. Хосты в составе группы сравниваются без учёта регистра: WEB01 и web01 — один и тот же хост. Добавление WEB01 в группу, где уже есть web01, вернёт «уже в группе».

Переименование и удаление

Переименование. Группа адресуется на дашбордах по имени. Диалог переименования предупреждает: «Фильтры дашбордов и ссылки по старому имени перестанут работать». После переименования ссылка с прежним именем покажет, что группа не найдена. Доступ ролей и окна обслуживания ссылаются на группу по идентификатору и переименование переживают.

Удаление. Группы удаляются по одной.

Если на группу нет ссылок, она удаляется сразу после подтверждения.
Если у группы есть роли с доступом или окна обслуживания, диалог перечисляет их: «Группа используется. При удалении права ролей на неё будут сняты». Кнопка Удалить и снять права удаляет группу и снимает выданные на неё права. Факт удаления и снятые права записываются в журнал аудита.
Если группа — цель неистёкшего окна обслуживания (активного или запланированного), удаление запрещено: «Группа — цель неистёкшего окна обслуживания. Удалите окно или дождитесь его окончания». У истёкших окон в списке остаётся пометка «удалённая группа».

При удалении группы сами хосты не удаляются.

Где используются группы

Дашборды

На дашборде можно создать переменную типа Группа хостов: она показывает список групп с числом хостов, поддерживает мультивыбор и поиск; пустой выбор означает «все». Подробнее — Переменные дашборда.

На встроенных дашбордах версии 204 переменная уже есть:

Proto-Linux-Root — фильтруются виджеты «Все хосты» и «Здоровье хостов»; в таблице «Все хосты» появляется колонка Группы.
Proto-Main-Root — фильтруются «Здоровье хостов» и «Топ хостов с проблемами».

Права доступа ролей

Роли можно выдать доступ к данным хостов группы. Состав группы раскрывается платформой: добавленный в группу хост становится доступен роли не позже чем через 30 секунд. См. Администрирование RBAC.

Окна обслуживания

Тип области действия Группа хостов глушит оповещения по всем хостам группы с учётом её текущего состава. См. Окна обслуживания.

Права доступа

Управление группами регулируется отдельным правом resource_group (в админке ролей — «Управление группами хостов»):

Действие	Что разрешает
`view`	Раздел Группы хостов: список, карточки, вкладки «Доступ» и «Обслуживание»
`edit`	Создание, переименование, удаление групп и изменение состава

Право resource_group выдаётся только целиком — на все группы (ключ *). Выдать его на одну конкретную группу в версии 204 нельзя: сервер отвергает такую запись. Роли с правом {edit, *, *} получают resource_group автоматически.

Выбор группы на дашбордах и в форме окна обслуживания не требует права resource_group: пользователь видит те группы, на которые у его роли есть доступ, и группы, в которых есть хотя бы один видимый ему хост. Счётчики хостов считаются только по видимым хостам.

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

Группы в РСМ

Группа отображается в списке ресурсов РСМ как ресурс типа host_group, вместе со связями «содержит». В РСМ она доступна только для чтения: создавать группы, редактировать их и менять состав через общие операции РСМ нельзя, сервер отвечает ошибкой. Для изменений на карточке группы в РСМ есть кнопка Открыть группу — она ведёт на экран «Группы хостов» и видна пользователям с правом resource_group:view. Тип host_group скрыт в списке типов при создании ресурса. При удалении хоста через РСМ диалог подтверждения показывает группы, в которые он входит.

Ограничения версии 204

РСМ не ограничивается правами на группы. Роль с правом просмотра ресурсов РСМ (resource:view) видит все группы и их состав, в том числе через инструменты ассистента.
Права resource_group — только на все группы. Управление одной группой — не в версии 204.
Фильтр дашборда адресует группу по имени. После переименования ссылки и сохранённые значения со старым именем дают пустой результат или сообщение «Группа не найдена».
Прямые гранты host чувствительны к регистру, как и раньше; хосты из группы сравниваются без учёта регистра.
В составе группы — только хосты с агентом Linux или Windows. Узлы Kubernetes, виртуальные машины, сетевые устройства в состав не входят.
Нет фильтров «Без группы» и «Кроме групп», вложенных групп и автоматического наполнения групп по правилам или тегам.

Документация Proto Observability Platform – группы хостов