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

Подключение Azure Monitor

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

Подключите Azure Monitor, чтобы передавать в Excubius ресурсы Azure вместе с метриками платформы, сработавшими оповещениями, запусками Data Factory и секретами с истекающим сроком действия. В этом руководстве показаны роли с минимальными привилегиями на стороне Azure, добавление источника и получение оповещений через группу действий.

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

  • Вам нужна роль Entity admin (администратор сущности) в сущности, которой принадлежат подписки.
  • В Azure нужен человек, который может назначать роли в подписках и, для сроков действия регистраций приложений, предоставлять согласие администратора в Entra ID.
  • Функция sources.azure_monitor включена. См. статью Источники.

Что считывает Excubius​

Azure считывается через Azure Resource Manager, Resource Graph, Azure Monitor, Alerts Management, Data Factory, плоскость данных Key Vault и Microsoft Graph. Каждый вызов только читает данные; немногочисленные запросы POST — это запросы на чтение, например запрос Resource Graph, запрос запусков конвейеров или триггеров либо запрос состояния среды выполнения интеграции.

ЭтапЧтоИнтервал по умолчанию
Inventory (инвентаризация)Один запрос Resource Graph по подпискам, ограниченный выбранными вами типами ресурсов15 минут
Metrics (метрики)Проверки модуля Azure (метрики платформы и строки Resource Graph, например задания резервного копирования), состояние туннелей VPN и, с отдельными переключателями, проверки Data Factory, сроки действия Key Vault и сроки действия секретов регистраций приложений5 минут
Alerts (оповещения)Сработавшие оповещения Azure Monitor за последние 30 дней по целевому ресурсу5 минут в режиме Polling; сверка каждые 15 минут в режиме Hybrid

Выбор удостоверения​

УдостоверениеКогда использовать
The server's managed identity (управляемое удостоверение сервера, рекомендуется)Сервер Excubius работает в Azure, и его удостоверение имеет доступ к подпискам. Ничего не нужно хранить или менять. Это назначаемое системой удостоверение виртуальной машины или назначаемое пользователем, если оно указано в AZURE_CLIENT_ID в файле .env
A service principal (субъект-служба)Подписки находятся в клиенте Azure (tenant), к которому у удостоверения сервера нет доступа. Это регистрация приложения с секретом клиента; меняйте секрет до окончания срока его действия

Если в файле .env заданы все три переменные AZURE_TENANT_ID, AZURE_CLIENT_ID и AZURE_CLIENT_SECRET, сервер использует вместо управляемого удостоверения субъект-службу, заданную этими переменными.

Предоставление разрешений​

Предоставляйте только то, что нужно используемым вами параметрам. Идентификаторы ролей — это идентификаторы встроенных ролей Azure.

Для чегоРоль или разрешениеИдентификатор ролиОбласть
Инвентаризация и оповещенияReaderacdd72a7-3385-48ef-bd42-f606fba81ae7Каждая подписка или группа управления
Метрики платформыMonitoring Reader43d0d8ad-25c7-4714-9337-8ba259a9fe05То же
Запуски Data Factory, запуски триггеров, состояние среды выполнения интеграцииНастраиваемая роль Data Factory run reader, см. нижеСоздается в вашем клиенте AzureФабрики данных или их группы ресурсов
Сроки действия Key VaultKey Vault Reader для хранилищ с Azure RBAC или политика доступа с разрешением List для секретов, ключей и сертификатов21090545-7ca7-4776-b22c-e363652d74d2Каждое хранилище
Сроки действия регистраций приложенийРазрешение приложения Microsoft Graph Application.Read.All с согласием администратора—Клиент Azure

Например, для управляемого удостоверения сервера в одной подписке:

az role assignment create --assignee <principal-id> --role "Reader" \
--scope /subscriptions/<subscription-id>
az role assignment create --assignee <principal-id> --role "Monitoring Reader" \
--scope /subscriptions/<subscription-id>

Роль только для чтения для Data Factory​

Data Factory предоставляет историю запусков в виде действий (actions). Роль Reader их не включает, а встроенная роль Data Factory Contributor предоставила бы их вместе с правом записи. Настраиваемая роль сохраняет доступ только для чтения. Сохраните следующее как data-factory-run-reader.json:

{
"Name": "Data Factory run reader",
"Description": "Read Data Factory pipelines, triggers, runs and integration runtime status.",
"Actions": [
"Microsoft.DataFactory/factories/read",
"Microsoft.DataFactory/factories/pipelines/read",
"Microsoft.DataFactory/factories/triggers/read",
"Microsoft.DataFactory/factories/integrationruntimes/read",
"Microsoft.DataFactory/factories/querypipelineruns/action",
"Microsoft.DataFactory/factories/querytriggerruns/action",
"Microsoft.DataFactory/factories/integrationruntimes/getstatus/action"
],
"NotActions": [],
"AssignableScopes": ["/subscriptions/<subscription-id>"]
}

Затем создайте и назначьте роль:

az role definition create --role-definition data-factory-run-reader.json
az role assignment create --assignee <principal-id> --role "Data Factory run reader" \
--scope /subscriptions/<subscription-id>/resourceGroups/<resource-group>

Без этой роли все остальное работает, а Test показывает Data Factory как необязательное разрешение, проверка которого завершилась ошибкой.

Добавление источника​

  1. Откройте Settings › Sources, выберите Add a source, а затем Azure Monitor.
  2. В разделе General введите Name и выберите Entity.
  3. В разделе Identity выберите The server's managed identity или A service principal. Для субъекта-службы введите Tenant ID, Client ID и Client secret.
  4. В разделе Subscriptions введите идентификаторы подписок, по одному в строке, или оставьте поле пустым, чтобы читать все подписки, доступные удостоверению. Перечисляя подписки, вы делите один клиент Azure между несколькими сущностями клиентов.
  5. В разделе Resource types оставьте нужные типы: виртуальные машины, базы данных Azure SQL, управляемые экземпляры SQL, гибкие серверы PostgreSQL, учетные записи хранения, хранилища ключей, хранилища служб восстановления, фабрики данных, а также сетевые шлюзы, брандмауэры и подсистемы балансировки нагрузки.
  6. Выберите, что считывать: Platform metrics, Fired alerts и Data Factory runs включены по умолчанию; Key Vault secret expiry и App registration secret expiry выключены, пока вы не предоставите нужные разрешения.
  7. Задайте часовой пояс (Time zone), в котором начинается «сегодня» для сводки Data Factory, например America/Santo_Domingo.
  8. В разделе Ingest mode выберите Hybrid (recommended), если ваши правила оповещений могут обращаться к серверу Excubius, или Polling в остальных случаях.
  9. Выберите Create source и скопируйте URL-адрес веб-перехватчика. Он отображается только один раз.

Получение оповещений через группу действий​

В режиме Hybrid или Webhook only:

  1. В Azure Monitor создайте группу действий (action group) с действием Webhook на URL-адрес, который показал Excubius, и включите common alert schema.
  2. Используйте эту группу действий в правилах оповещений, оповещения которых вы хотите видеть в Excubius.
внимание

Группы действий не могут добавлять заголовки, поэтому учетными данными служит токен в URL-адресе. Не передавайте URL-адрес посторонним, а если он стал известен, выберите Rotate URL для источника.

Проверка и синхронизация​

  1. На странице источника выберите Test. Каждая операция чтения перечислена со своим результатом, необязательные отмечены: учетные данные, подписки, инвентаризация, оповещения, метрики, Data Factory, Key Vault и регистрации приложений.
  2. Выберите Sync now, чтобы сразу получить ресурсы, метрики и оповещения, не дожидаясь расписания.

Ресурсы Azure отображаются в сущности источника и сопоставляются с теми же серверами из других источников по идентификатору ресурса и именам. Для каждой фабрики данных на панели мониторинга Overview появляется карточка, а секреты, срок действия которых истекает в течение 30 дней, отображаются в разделе Expiry and risk.