Подключение Azure Monitor
Подключите 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.
| Для чего | Роль или разрешение | Идентификатор роли | Область |
|---|---|---|---|
| Инвентаризация и оповещения | Reader | acdd72a7-3385-48ef-bd42-f606fba81ae7 | Каждая подписка или группа управления |
| Метрики платформы | Monitoring Reader | 43d0d8ad-25c7-4714-9337-8ba259a9fe05 | То же |
| Запуски Data Factory, запуски триггеров, состояние среды выполнения интеграции | Настраиваемая роль Data Factory run reader, см. ниже | Создается в вашем клиенте Azure | Фабрики данных или их группы ресурсов |
| Сроки действия Key Vault | Key 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 как необязательное разрешение, проверка которого завершилась ошибкой.
Добавление источника
- Откройте Settings › Sources, выберите Add a source, а затем Azure Monitor.
- В разделе General введите Name и выберите Entity.
- В разделе Identity выберите The server's managed identity или A service principal. Для субъекта-службы введите Tenant ID, Client ID и Client secret.
- В разделе Subscriptions введите идентификаторы подписок, по одному в строке, или оставьте поле пустым, чтобы читать все подписки, доступные удостоверению. Перечисляя подписки, вы делите один клиент Azure между несколькими сущностями клиентов.
- В разделе Resource types оставьте нужные типы: виртуальные машины, базы данных Azure SQL, управляемые экземпляры SQL, гибкие серверы PostgreSQL, учетные записи хранения, хранилища ключей, хранилища служб восстановления, фабрики данных, а также сетевые шлюзы, брандмауэры и подсистемы балансировки нагрузки.
- Выберите, что считывать: Platform metrics, Fired alerts и Data Factory runs включены по умолчанию; Key Vault secret expiry и App registration secret expiry выключены, пока вы не предоставите нужные разрешения.
- Задайте часовой пояс (Time zone), в котором начинается «сегодня» для сводки Data Factory, например
America/Santo_Domingo. - В разделе Ingest mode выберите Hybrid (recommended), если ваши правила оповещений могут обращаться к серверу Excubius, или Polling в остальных случаях.
- Выберите Create source и скопируйте URL-адрес веб-перехватчика. Он отображается только один раз.
Получение оповещений через группу действий
В режиме Hybrid или Webhook only:
- В Azure Monitor создайте группу действий (action group) с действием Webhook на URL-адрес, который показал Excubius, и включите common alert schema.
- Используйте эту группу действий в правилах оповещений, оповещения которых вы хотите видеть в Excubius.
Группы действий не могут добавлять заголовки, поэтому учетными данными служит токен в URL-адресе. Не передавайте URL-адрес посторонним, а если он стал известен, выберите Rotate URL для источника.
Проверка и синхронизация
- На странице источника выберите Test. Каждая операция чтения перечислена со своим результатом, необязательные отмечены: учетные данные, подписки, инвентаризация, оповещения, метрики, Data Factory, Key Vault и регистрации приложений.
- Выберите Sync now, чтобы сразу получить ресурсы, метрики и оповещения, не дожидаясь расписания.
Ресурсы Azure отображаются в сущности источника и сопоставляются с теми же серверами из других источников по идентификатору ресурса и именам. Для каждой фабрики данных на панели мониторинга Overview появляется карточка, а секреты, срок действия которых истекает в течение 30 дней, отображаются в разделе Expiry and risk.