Добавление ресурса
Ресурс — это один объект, который отслеживает Excubius: экземпляр SQL Server, веб-адрес, сервер отчетов, узел. При добавлении ресурса Excubius сразу настраивает проверки по умолчанию для его типа. В этом руководстве показано, как добавить ресурс с помощью мастера Add resource, проверить его подключение, обнаружить, что на нем работает, а также изменить или удалить его.
Перед началом работы
- Вам нужна роль Entity admin (администратор сущности) в сущности, которой будет принадлежать ресурс.
- Учетные данные, нужные ресурсу, сохранены, или вы готовы создать их в мастере. См. статью Сохранение учетных данных для сборщика.
- Сервер Excubius может подключиться к системе через нужный порт. См. раздел Сетевые пути.
Ресурсы, о которых сообщает источник, например ресурсы Azure из Azure Monitor или устройства из NinjaOne, появляются сами. Вы добавляете только то, к чему подключается собственный сборщик. Базы данных и связанные серверы тоже не добавляются вручную: вы обнаруживаете их из их экземпляра.
Добавление ресурса
- Консоль
- API
- Откройте Resources и выберите Add resource.
- Type: выберите, что это за объект. Для каждого типа показано, сколько проверок он получает по умолчанию и какие сведения ему нужны.
- Place and name: выберите Entity, которая определяет, что ресурс наследует (пороговые значения, каналы, учетные данные), и введите Name, которое будет отображаться везде, например
sql-ventas-01. - Connection: введите сведения, нужные для типа, начиная с обязательных. Они проверяются, прежде чем вы сможете продолжить.
- Tags: добавьте пары
key:value, как минимумenv,roleиclient, и задайте Criticality от 1 (низкая) до 5 (критическая). - Credential: выберите подходящие доступные учетные данные, None, чтобы использовать учетные данные родительского ресурса, или New credential, чтобы создать их здесь.
- Проверьте введенные данные на шаге Review, затем выберите Create resource.
curl -s "${H[@]}" -X POST "$BASE/resources" -d "{
\"entity_id\": \"$PROD\", \"type\": \"web_endpoint\", \"name\": \"portal-ventas\",
\"attributes\": {\"url\": \"https://ventas.ciguapa.example/\", \"domain\": \"ciguapa.example\"},
\"tags\": {\"env\": \"prod\", \"role\": \"web\", \"client\": \"ciguapa\"}, \"criticality\": 4
}" | jq '{id, name, checks_provisioned}'
$BASE — это https://<your server>/api/v1, а H содержит ваш токен Bearer; см. справочник по API.
Проверки по умолчанию настраиваются сразу, а первые значения поступают в течение одной-двух минут. На последнем экране предлагаются варианты Test connection, Discover для экземпляров SQL Server, Open the resource и Add another.
Сведения для каждого типа
| Тип | Обязательно | Другие сведения |
|---|---|---|
| Экземпляр SQL Server | host | port (по умолчанию 1433); instance для именованного экземпляра без фиксированного порта, к которому выполняется подключение через обозреватель SQL Server (SQL Server Browser) по UDP 1434 |
| Группа доступности Always On | ag_name | Обычно создается при обнаружении вместе с прослушивателем, репликами и базами данных |
| SQL Server Reporting Services | portal_url | test_report_path для отрисовки одного отчета; host, port, instance и report_server_db (по умолчанию ReportServer) для проверки журнала выполнения |
| Веб-адрес или портал | url | expect_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; см. статью Ресурсы и страница ресурса.