Перейти к основному содержимому
Версия: 0.4 · текущая

Добавление ресурса

Практическое руководствоПроверено 11 октября 2026 г.
Область применения:Excubius 0.4Роли: Администратор сущности
ПланыFree · Core · Pro · EnterpriseРазвертываниеСамостоятельное размещение

Ресурс — это один объект, который отслеживает Excubius: экземпляр SQL Server, веб-адрес, сервер отчетов, узел. При добавлении ресурса Excubius сразу настраивает проверки по умолчанию для его типа. В этом руководстве показано, как добавить ресурс с помощью мастера Add resource, проверить его подключение, обнаружить, что на нем работает, а также изменить или удалить его.

Перед началом работы​

  • Вам нужна роль Entity admin (администратор сущности) в сущности, которой будет принадлежать ресурс.
  • Учетные данные, нужные ресурсу, сохранены, или вы готовы создать их в мастере. См. статью Сохранение учетных данных для сборщика.
  • Сервер Excubius может подключиться к системе через нужный порт. См. раздел Сетевые пути.

Ресурсы, о которых сообщает источник, например ресурсы Azure из Azure Monitor или устройства из NinjaOne, появляются сами. Вы добавляете только то, к чему подключается собственный сборщик. Базы данных и связанные серверы тоже не добавляются вручную: вы обнаруживаете их из их экземпляра.

Добавление ресурса​

  1. Откройте Resources и выберите Add resource.
  2. Type: выберите, что это за объект. Для каждого типа показано, сколько проверок он получает по умолчанию и какие сведения ему нужны.
  3. Place and name: выберите Entity, которая определяет, что ресурс наследует (пороговые значения, каналы, учетные данные), и введите Name, которое будет отображаться везде, например sql-ventas-01.
  4. Connection: введите сведения, нужные для типа, начиная с обязательных. Они проверяются, прежде чем вы сможете продолжить.
  5. Tags: добавьте пары key:value, как минимум env, role и client, и задайте Criticality от 1 (низкая) до 5 (критическая).
  6. Credential: выберите подходящие доступные учетные данные, None, чтобы использовать учетные данные родительского ресурса, или New credential, чтобы создать их здесь.
  7. Проверьте введенные данные на шаге Review, затем выберите Create resource.

Проверки по умолчанию настраиваются сразу, а первые значения поступают в течение одной-двух минут. На последнем экране предлагаются варианты Test connection, Discover для экземпляров SQL Server, Open the resource и Add another.

Сведения для каждого типа​

ТипОбязательноДругие сведения
Экземпляр SQL Serverhostport (по умолчанию 1433); instance для именованного экземпляра без фиксированного порта, к которому выполняется подключение через обозреватель SQL Server (SQL Server Browser) по UDP 1434
Группа доступности Always Onag_nameОбычно создается при обнаружении вместе с прослушивателем, репликами и базами данных
SQL Server Reporting Servicesportal_urltest_report_path для отрисовки одного отчета; host, port, instance и report_server_db (по умолчанию ReportServer) для проверки журнала выполнения
Веб-адрес или порталurlexpect_status, expect_text; domain (регистрируемый домен) для проверки срока регистрации домена
Узел Windows—ip; без него сборщик подключается по имени ресурса
Узел Linux—ip и ssh_port (по умолчанию 22); без ip сборщик подключается по имени ресурса
Сервер PostgreSQL—host, port
Клиент Entra ID или доменные службы—tenant_id, domain; содержит проверки удостоверений
Сама платформа мониторинга—heartbeat_url; содержит проверки уровня платформы, например каналы обновлений и состояние облака
Ресурсы Azure—resource_id; обычно добавляются источником Azure Monitor

Проверка подключения​

На странице ресурса выберите Test connection. Сборщик получает задание на проверку примерно в течение 10 секунд и подключается с учетными данными ресурса.

ТипЧто показывает успешная проверка
Экземпляр SQL Server, группа доступностиИмя сервера, версию, выпуск и задержку, разрешения имени входа с указанием отсутствующих, а также предупреждение, если имя входа имеет роль sysadmin
Сервер отчетов, веб-адресАдрес, состояние HTTP и версию, а также задержку

При неудачной проверке отображается вид ошибки с подсказкой:

Вид ошибкиЧто проверить
authИмя входа и пароль, а также то, что экземпляр принимает имена входа SQL
unreachableИмя узла, порт и брандмауэр между сервером Excubius и системой
timeoutСетевой путь; система не ответила вовремя
queryОтсутствующее разрешение имени входа
configЧто-то, что нужно исправить в Excubius: узел, учетные данные или сохраненный секрет

Если проверка остается в состоянии waiting for the collector и завершается сообщением No collector picked it up, сборщик не запущен, не имеет токена или не предлагает этот транспорт. См. статью Ошибки сборщика.

Обнаружение того, что работает на экземпляре​

Для экземпляра SQL Server выберите Discover. Обнаружение считывает сведения о сервере, его группах доступности с репликами, ролями и прослушивателем, его базах данных, связанных серверах и сводку по агенту SQL Server. Оно добавляет или обновляет их как дочерние ресурсы с собственными проверками и сообщает, сколько ресурсов было создано, обновлено и больше не найдено.

  • Запускайте обнаружение повторно при каждом изменении топологии.
  • Дочерний ресурс, который больше не найден, отмечается как missing и сохраняется вместе с историей. Обнаружение никогда не удаляет его; удалите его сами, когда он исчезнет окончательно.
  • Для группы доступности добавьте каждую реплику как экземпляр и запустите обнаружение на одной из них. См. статью Краткое руководство. Добавление группы доступности.

Изменение и удаление ресурса​

  • Edit изменяет имя, критичность, теги и учетные данные. Сведения о подключении и сущность изменяются через API: PATCH /api/v1/resources/{id} с attributes или entity_id.
  • Delete удаляет ресурс вместе с обнаруженными дочерними ресурсами, проверками, метриками и оповещениями. Сама отслеживаемая система никогда не затрагивается.

Редакторы включают и отключают проверки, а также изменяют их интервал и пороговые значения для одного ресурса на его вкладке Checks; см. статью Ресурсы и страница ресурса.