Организации, квоты и лимиты

Мультиарендность: организации, лимиты камер и пользователей, хранилище и удаление.

Организация — это арендатор системы: замкнутый набор камер, пользователей, тегов, мозаик, событий и шаблонов. Объекты одной организации не видны из другой, а права оператора действуют только внутри его организации. Один сервер Plane обслуживает столько организаций, сколько нужно: филиалы одного предприятия, объекты подрядчика или разные клиенты интегратора.

При установке всегда создаётся первая организация. Пока она одна, установка работает в однотенантном режиме: колонки и фильтры «Организация» в списках не показываются, чтобы не загромождать интерфейс. Как только появляется вторая организация, эти колонки включаются автоматически. Текущее состояние видно суперадмину в разделе «Настройки» → «Платформа», блок «Установка»: «Настроено организаций: {n}.» и подсказка «Однотенантный режим. Добавьте вторую организацию, чтобы включить multi-org управление.».

Кто и что видит#

Раздел открывается по адресу /admin/access/organizations, но ведёт себя по-разному:

Подсказка пункта у админа организации — «Лимиты, размещение и использование ресурсов»: он видит свои границы, но не меняет их. Лимиты для него доступны только на просмотр — «Этими лимитами управляет администратор платформы; здесь они доступны только для просмотра.».

Список организаций#

Кнопка в шапке — «Новая организация».

Действия строки: «Открыть организацию», «Изменить» и «Статистика и очистка».

Статус «Выполняется очистка» означает, что запущено безвозвратное удаление организации: оно выполняется в фоне и повторяется, пока все узлы не подтвердят удаление своих данных. Такую организацию не редактируют — дожидаются завершения.

Карточка организации#

Вверху четыре плитки — Камеры, Пользователи, События, Хранилище вложений — каждая с подписью «Лимит: …» либо «без ограничений». Ниже — разделы; каждый имеет собственный адрес, поэтому на нужный можно дать прямую ссылку.

Кнопка «Изменить организацию» (в разделе «Лимиты» — «Изменить лимиты») открывает форму.

Форма организации#

Форма разбита на четыре секции.

Организация#

«Название» — понятное клиенту имя, его можно изменить позже. Флажок отключения «Блокирует новые сессии и операционные изменения организации, не удаляя её данные.».

Размещение#

«Политика размещения камер» определяет, как выбирается нода при создании камеры:

Ниже — границы размещения: «Ограничить доступные ноды» (камеры организации размещаются только на отмеченных нодах) и «Разрешённые имена хранилищ» — имена через запятую, точно как они настроены на разрешённых нодах. Пока ограничения не заданы, действуют «Все доступные ноды» и все хранилища.

Границы размещения — это способ отдать арендатору выделенное железо. Учтите: если в списке разрешённых не осталось ни одной пригодной ноды с инициализированным диском, создание камеры с архивом завершится ошибкой подбора. Подробнее — Ноды и флот и Хранилища DVR.

Лимиты ресурсов#

Три группы полей:

Пустое поле означает «без ограничений» — не ноль. Ноль запрещает ресурс полностью, и это разные вещи: организация с «Макс. камер = 0» не сможет завести ни одной камеры.

«Макс. сессий / пользователь» ограничивает число одновременных просмотров под одной учётной записью — защита от передачи пароля между сотрудниками. Значение видно в разделе «Использование» подписью «Лимит: {n} на пользователя (D20, антишеринг).»; если лимит не задан — «Лимит сессий на пользователя не задан (антишеринг выключен).».

Хранение#

«Квота вложений (байты)» ограничивает объём материалов событий (кадры, кропы), которые хранит Plane. «Хранение событий (дни)» задаёт срок, после которого события удаляются автоматически.

Где лимиты проявляются в работе#

• Раздел «Использование» — живые счётчики относительно квот: «Камеры», «Пользователи», «Хранилище вложений», «Активные сессии», «Аналитические дашборды», «Аналитические отчёты», «Теги», «Пользовательские шаблоны событий», «Туннельные агенты», «Устройства агентов», «Правила доступа агентов».
• Баннер над рабочей областью — появляется у администраторов при заполнении квоты от 80 %: «Организация приближается к лимиту квоты — {ресурс}: {процент}%.», а при достижении лимита — «Организация достигла лимита квоты». Кнопка «Открыть использование» ведёт прямо в раздел «Использование» вашей организации.
• Отказ при создании объекта — когда лимит исчерпан, создание камеры, пользователя или тега не проходит. Проверьте счётчики в «Использовании» прежде чем искать причину в другом месте.

Необратимые операции#

Раздел «Данные и очистка» (?org_tab=data) доступен только суперадмину. Сверху — инвентарь организации: «Вложения событий», «Шаблоны камер», «Виджеты аналитики», «Записи аудита», «Туннельные эндпоинты», «Связанные строки БД», «Архив вложений событий» и «Архив DVR». У размера архива DVR может стоять пометка «Телеметрия узла устарела; фактический размер может отличаться.» — это значит, что нода давно не присылала телеметрию, и число справочное.

Ниже — три операции, каждая из которых удаляет данные безвозвратно.

Очистка архива событий#

Кнопка «Просмотреть или очистить архив событий» открывает раздел событий с уже выбранной организацией. Там применяют фильтры (тип, камера, важность, время) и удаляют либо отмеченные строки, либо весь результат фильтра. Удаление по фильтру требует подтверждения вводом слова DELETE.

Очистка архива DVR#

Кнопка «Очистить архив DVR». Выберите камеру (или «Все камеры») и при необходимости диапазон «От (необязательно)» / «До (необязательно)» в местном времени. Пустые поля диапазона означают все существующие сейчас записи. Кнопка предпросмотра показывает «Предпросмотр необратимой очистки DVR» с числом камер и текущим общим объёмом их потоков.

Удаление организации#

Кнопка «Безвозвратно удалить организацию и все данные».

Что дальше#

• Пользователи и права доступа — учётные записи внутри организации и их права.
• Хранилища DVR — куда пишется архив, ограниченный политикой размещения.
• Ноды и флот — какие ноды доступны организации.
• Ноды и хранилища в API — подбор размещения (/api/v1/nodes/placement-options, /api/v1/nodes/recommend) для автоматизации.