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

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

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

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

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

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

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

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

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

Как открыть

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

Список групп

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Дашборды

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

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

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

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

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

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

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

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

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

Право 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, виртуальные машины, сетевые устройства в состав не входят.
• Нет фильтров «Без группы» и «Кроме групп», вложенных групп и автоматического наполнения групп по правилам или тегам.