/docs/tags/%D0%B2%D0%B7%D0%B0%D0%B8%D0%BC%D0%BE%D1%81%D0%B2%D1%8F%D0%B7%D0%B8/ Recent content in взаимосвязи on Документация Proto Observability Platform Hugo -- gohugo.io ru /docs/guides/resource_service_model/ Mon, 01 Jan 0001 00:00:00 +0000 /docs/guides/resource_service_model/ <p>На этой странице:</p> <ul> <li><a href="#%D0%B2%D0%B2%D0%B5%D0%B4%D0%B5%D0%BD%D0%B8%D0%B5">Введение</a></li> <li><a href="#%D1%80%D0%B5%D1%81%D1%83%D1%80%D1%81%D1%8B">Ресурсы</a> <ul> <li><a href="#%D1%81%D0%BF%D0%B8%D1%81%D0%BE%D0%BA-%D1%80%D0%B5%D1%81%D1%83%D1%80%D1%81%D0%BE%D0%B2">Список ресурсов</a></li> <li><a href="#%D1%81%D0%BE%D0%B7%D0%B4%D0%B0%D0%BD%D0%B8%D0%B5-%D1%80%D0%B5%D1%81%D1%83%D1%80%D1%81%D0%B0">Создание ресурса</a></li> <li><a href="#%D0%B4%D0%B5%D1%82%D0%B0%D0%BB%D0%B8-%D1%80%D0%B5%D1%81%D1%83%D1%80%D1%81%D0%B0">Детали ресурса</a></li> <li><a href="#%D1%80%D0%B5%D0%B4%D0%B0%D0%BA%D1%82%D0%B8%D1%80%D0%BE%D0%B2%D0%B0%D0%BD%D0%B8%D0%B5-%D1%80%D0%B5%D1%81%D1%83%D1%80%D1%81%D0%B0">Редактирование ресурса</a></li> </ul> </li> <li><a href="#%D0%B0%D0%B2%D1%82%D0%BE%D0%BC%D0%B0%D1%82%D0%B8%D1%87%D0%B5%D1%81%D0%BA%D0%BE%D0%B5-%D0%BE%D0%B1%D0%BD%D0%B0%D1%80%D1%83%D0%B6%D0%B5%D0%BD%D0%B8%D0%B5-%D1%80%D0%B5%D1%81%D1%83%D1%80%D1%81%D0%BE%D0%B2">Автоматическое обнаружение ресурсов</a> <ul> <li><a href="#%D0%B6%D0%B8%D0%B7%D0%BD%D0%B5%D0%BD%D0%BD%D1%8B%D0%B9-%D1%86%D0%B8%D0%BA%D0%BB-provisional--confirmed">Жизненный цикл Provisional → Confirmed</a></li> </ul> </li> <li><a href="#%D0%BD%D0%B0%D1%81%D1%82%D1%80%D0%BE%D0%B9%D0%BA%D0%B0-%D1%80%D1%81%D0%BC">Настройка РСМ</a> <ul> <li><a href="#%D1%82%D0%B8%D0%BF%D1%8B-%D1%80%D0%B5%D1%81%D1%83%D1%80%D1%81%D0%BE%D0%B2">Типы ресурсов</a></li> <li><a href="#%D1%82%D0%B8%D0%BF%D1%8B-%D0%B2%D0%B7%D0%B0%D0%B8%D0%BC%D0%BE%D1%81%D0%B2%D1%8F%D0%B7%D0%B5%D0%B9">Типы взаимосвязей</a></li> <li><a href="#ci-%D0%BF%D0%BE%D0%B4%D0%BA%D0%BB%D0%B0%D1%81%D1%81%D1%8B">CI-подклассы</a></li> <li><a href="#ci-%D0%BA%D0%BB%D0%B0%D1%81%D1%81%D1%8B">CI-классы</a></li> </ul> </li> <li><a href="#%D0%BD%D0%B0%D0%B2%D0%B8%D0%B3%D0%B0%D1%86%D0%B8%D1%8F">Навигация</a></li> </ul> <h2 id="введение">Введение</h2> <p><strong>Ресурсно-сервисная модель (РСМ)</strong> — раздел платформы Proto Observability для ведения единого реестра ИТ-ресурсов и их взаимосвязей. РСМ позволяет:</p> <ul> <li><strong>Создавать и управлять ресурсами</strong> — вести каталог серверов, сервисов, баз данных, приложений и других элементов ИТ-инфраструктуры</li> <li><strong>Описывать взаимосвязи</strong> — фиксировать зависимости и связи между ресурсами (например, «сервис зависит от базы данных», «приложение работает на сервере»)</li> <li><strong>Визуализировать граф связей</strong> — просматривать интерактивный граф взаимосвязей ресурса с возможностью раскрытия и сворачивания узлов</li> <li><strong>Настраивать справочники</strong> — управлять типами ресурсов, типами взаимосвязей, CI-классами и CI-подклассами</li> </ul> <div class="alert alert-info" role="alert"> <h4 class="alert-heading">Версия</h4> Данный функционал доступен начиная с версии 200. </div> <p><strong>Как открыть</strong>: перейдите в раздел <strong>РСМ</strong> в основном меню навигации платформы.</p> <hr> <h2 id="ресурсы">Ресурсы</h2> <h3 id="список-ресурсов">Список ресурсов</h3> <p>Страница списка ресурсов состоит из двух панелей:</p> <ul> <li><strong>Левая панель</strong> — дерево фильтрации по типу ресурса. Выберите тип ресурса в дереве, чтобы отфильтровать таблицу справа.</li> <li><strong>Правая панель</strong> — таблица ресурсов с информацией о каждом ресурсе.</li> </ul> <!-- TODO: screenshot --> <p><strong>Возможности таблицы:</strong></p> <table> <thead> <tr> <th>Функция</th> <th>Описание</th> </tr> </thead> <tbody> <tr> <td><strong>Поиск</strong></td> <td>Текстовый поиск по имени и ключу ресурса</td> </tr> <tr> <td><strong>Фильтрация</strong></td> <td>По идентификаторам ресурсов, окружению (environment), статусу, операционному статусу</td> </tr> <tr> <td><strong>Постраничная навигация</strong></td> <td>Переключение между страницами результатов</td> </tr> <tr> <td><strong>Операции</strong></td> <td>Столбец с кнопками: просмотр деталей, редактирование, удаление ресурса</td> </tr> </tbody> </table> <p>Для создания нового ресурса нажмите кнопку <strong>Создать ресурс</strong> в верхней части страницы.</p> <h3 id="создание-ресурса">Создание ресурса</h3> <p>Форма создания ресурса содержит следующие поля:</p> <table> <thead> <tr> <th>Поле</th> <th>Описание</th> <th style="text-align:center">Обязательное</th> </tr> </thead> <tbody> <tr> <td><strong>Тип ресурса</strong> (resource_type)</td> <td>Категория ресурса из справочника типов</td> <td style="text-align:center">Да</td> </tr> <tr> <td><strong>Имя ресурса</strong> (resource_name)</td> <td>Понятное имя ресурса</td> <td style="text-align:center">Да</td> </tr> <tr> <td><strong>Ключ ресурса</strong> (resource_key)</td> <td>Уникальный идентификатор ресурса</td> <td style="text-align:center">Да</td> </tr> <tr> <td><strong>Отображаемое имя</strong> (display_name)</td> <td>Имя для отображения в интерфейсе</td> <td style="text-align:center">Нет</td> </tr> <tr> <td><strong>Уровень ресурса</strong> (resource_tier)</td> <td>Уровень важности ресурса</td> <td style="text-align:center">Нет</td> </tr> <tr> <td><strong>Окружение</strong> (environment)</td> <td>Окружение, в котором функционирует ресурс (production, staging и т.д.)</td> <td style="text-align:center">Нет</td> </tr> <tr> <td><strong>Владелец</strong> (owner)</td> <td>Ответственное лицо или команда</td> <td style="text-align:center">Нет</td> </tr> <tr> <td><strong>CI-класс</strong> (ci_class)</td> <td>Класс конфигурационной единицы из справочника</td> <td style="text-align:center">Нет</td> </tr> <tr> <td><strong>CI-подкласс</strong> (ci_subclass)</td> <td>Подкласс конфигурационной единицы из справочника</td> <td style="text-align:center">Нет</td> </tr> <tr> <td><strong>Критичность</strong> (criticality)</td> <td>Уровень критичности ресурса для бизнеса</td> <td style="text-align:center">Нет</td> </tr> <tr> <td><strong>Операционный статус</strong> (operational_status)</td> <td>Текущий операционный статус ресурса</td> <td style="text-align:center">Нет</td> </tr> <tr> <td><strong>Требуется одобрение изменений</strong> (change_approval_required)</td> <td>Флаг, указывающий, нужно ли согласование перед изменениями</td> <td style="text-align:center">Нет</td> </tr> <tr> <td><strong>Теги</strong> (tags)</td> <td>Произвольные метки для категоризации</td> <td style="text-align:center">Нет</td> </tr> <tr> <td><strong>Метаданные</strong> (metadata)</td> <td>Дополнительная информация в формате JSON</td> <td style="text-align:center">Нет</td> </tr> <tr> <td><strong>Статус ITIL</strong> (itil_state)</td> <td>Состояние ресурса по классификации ITIL</td> <td style="text-align:center">Нет</td> </tr> </tbody> </table> <!-- TODO: screenshot --> <p>После заполнения полей нажмите кнопку <strong>Сохранить</strong> для создания ресурса.</p> <h3 id="детали-ресурса">Детали ресурса</h3> <p>Страница деталей ресурса содержит три вкладки:</p> <p><strong>1. Вкладка «Детали»</strong></p> <p>Отображает все поля ресурса в формате карточки с подробной информацией. Здесь же доступны кнопки для перехода к редактированию или удаления ресурса.</p> <!-- TODO: screenshot --> <p><strong>2. Вкладка «Взаимосвязи»</strong></p> <p>Содержит два режима отображения связей ресурса:</p> <ul> <li><strong>Интерактивный граф</strong> — визуализация связей в виде графа. Узлы графа можно раскрывать для просмотра связей следующего уровня и сворачивать обратно. Наведите курсор на узел, чтобы увидеть информацию о связанном ресурсе.</li> <li><strong>Таблица взаимосвязей</strong> — список всех связей ресурса, сгруппированных по типу взаимосвязи. Для каждой связи отображается тип, направление и целевой ресурс.</li> </ul> <p>В этой вкладке также доступны операции:</p> <ul> <li><strong>Добавить взаимосвязь</strong> — создание новой связи с выбором типа взаимосвязи и целевого ресурса</li> <li><strong>Удалить взаимосвязь</strong> — удаление существующей связи</li> </ul> <p><strong>3. Вкладка «Граф вложенности»</strong></p> <p>Отображает иерархическую диаграмму ресурсов, входящих в состав текущего ресурса (отношение «содержит»).</p> <h3 id="редактирование-ресурса">Редактирование ресурса</h3> <p>Форма редактирования ресурса аналогична форме создания, но с предзаполненными значениями. Измените нужные поля и нажмите <strong>Сохранить</strong> для применения изменений.</p> <hr> <h2 id="автоматическое-обнаружение-ресурсов">Автоматическое обнаружение ресурсов</h2> <p>Помимо ручного ведения реестра, платформа поддерживает <strong>автоматическое обнаружение</strong> ресурсов из телеметрии.</p> <div class="alert alert-info" role="alert"> <h4 class="alert-heading">Частота обнаружения</h4> Интервал запуска задания обнаружения настраивается на стороне backend. По умолчанию задания запускаются раз в несколько минут — новые поды появляются в списке ресурсов практически в реальном времени. </div> <h3 id="жизненный-цикл-provisional--confirmed">Жизненный цикл Provisional → Confirmed</h3> <p>Автоматически обнаруженные ресурсы проходят через несколько состояний:</p> <table> <thead> <tr> <th>Состояние</th> <th>Описание</th> </tr> </thead> <tbody> <tr> <td><strong>Provisional</strong></td> <td>Ресурс найден в телеметрии однократно. Ещё не подтверждён как долгоживущий — может оказаться одноразовым спаном или ошибкой данных</td> </tr> <tr> <td><strong>Confirmed</strong></td> <td>Ресурс стабильно появляется в данных в течение нескольких циклов обнаружения — автоматически продвигается в подтверждённое состояние</td> </tr> <tr> <td><strong>Stale</strong></td> <td>Ресурс не появлялся в данных дольше порогового времени (по умолчанию — несколько дней) — кандидат на автоматическое снятие</td> </tr> <tr> <td><strong>Retired</strong></td> <td>Ресурс снят с обслуживания. Данные о нём сохраняются, но он не учитывается в активных дашбордах и зависимостях</td> </tr> </tbody> </table> <p>Администратор может вручную перевести ресурс между состояниями на странице деталей. Подтверждение и снятие с обслуживания также выполняются автоматически — это настраивается пороговыми значениями <code>EphemeralResourceTTL</code> (для provisional) и <code>StalenessThreshold</code> / <code>ResourceDeleteAfter</code> (для stale и retired).</p> <hr> <h2 id="настройка-рсм">Настройка РСМ</h2> <p>Раздел настройки РСМ позволяет управлять справочными данными, которые используются при создании ресурсов и их взаимосвязей. Настройка содержит четыре вкладки.</p> <p><strong>Как открыть</strong>: перейдите в <strong>РСМ</strong> &gt; <strong>Настройка РСМ</strong> в меню навигации.</p> <!-- TODO: screenshot --> <h3 id="типы-ресурсов">Типы ресурсов</h3> <p>Справочник типов ресурсов определяет, какие категории ресурсов доступны в системе (например, «Сервер», «База данных», «Микросервис», «Балансировщик нагрузки»).</p> <p><strong>Доступные операции:</strong></p> <ul> <li>Просмотр списка типов ресурсов</li> <li>Создание нового типа ресурса (имя и описание)</li> <li>Просмотр деталей типа ресурса</li> <li>Редактирование существующего типа</li> </ul> <h3 id="типы-взаимосвязей">Типы взаимосвязей</h3> <p>Справочник типов взаимосвязей задает допустимые виды связей между ресурсами (например, «зависит от», «содержит», «подключается к»).</p> <p><strong>Доступные операции:</strong></p> <ul> <li>Просмотр списка типов взаимосвязей</li> <li>Создание нового типа взаимосвязи</li> <li>Просмотр деталей типа взаимосвязи</li> <li>Редактирование существующего типа</li> </ul> <h3 id="ci-подклассы">CI-подклассы</h3> <p>Справочник CI-подклассов позволяет детализировать классификацию конфигурационных единиц внутри CI-классов (например, для CI-класса «Сервер» подклассы могут быть «Физический сервер», «Виртуальная машина», «Контейнер»).</p> <p><strong>Доступные операции:</strong></p> <ul> <li>Просмотр списка CI-подклассов</li> <li>Создание нового CI-подкласса</li> <li>Просмотр деталей CI-подкласса</li> <li>Редактирование существующего CI-подкласса</li> </ul> <h3 id="ci-классы">CI-классы</h3> <p>Справочник CI-классов определяет верхний уровень классификации конфигурационных единиц (например, «Сервер», «Сетевое оборудование», «Программное обеспечение»).</p> <p><strong>Доступные операции:</strong></p> <ul> <li>Просмотр списка CI-классов</li> <li>Создание нового CI-класса</li> <li>Просмотр деталей CI-класса</li> <li>Редактирование существующего CI-класса</li> </ul> <hr> <h2 id="навигация">Навигация</h2> <p>Раздел РСМ доступен через пункт <strong>РСМ</strong> в боковом меню навигации платформы. Внутри раздела навигация осуществляется через подменю:</p> <ul> <li><strong>Ресурсы</strong> — переход к списку ресурсов, созданию и просмотру деталей</li> <li><strong>Настройка РСМ</strong> — переход к справочникам типов и классов</li> </ul> <p>В верхней части страниц отображаются хлебные крошки (breadcrumbs), позволяющие быстро вернуться к предыдущему уровню навигации.</p>