Conectar o Azure Monitor
Conecte o Azure Monitor para trazer os seus recursos do Azure para o Excubius, com as métricas de plataforma, os alertas disparados, as execuções do Data Factory e os segredos prestes a vencer. Este guia mostra as funções com privilégios mínimos no lado do Azure, como adicionar a fonte e como receber alertas por meio de um grupo de ações.
Antes de começar
- Você precisa da função Entity admin (Administrador de entidade) na entidade à qual as assinaturas pertencem.
- No Azure, alguém que possa atribuir funções nas assinaturas e, para o vencimento dos registros de aplicativo, conceder o consentimento do administrador no Entra ID.
- O recurso
sources.azure_monitorestá ativado. Consulte Fontes.
O que o Excubius lê
O Azure é lido por meio do Azure Resource Manager, do Resource Graph, do Azure Monitor, do Alerts Management, do Data Factory, do plano de dados do Key Vault e do Microsoft Graph. Todas as chamadas são de leitura; as poucas solicitações POST são consultas, como uma consulta do Resource Graph, uma consulta de execuções de pipeline ou de gatilho ou o status de um runtime de integração.
| Fase | O quê | Intervalo padrão |
|---|---|---|
| Inventário | Uma consulta do Resource Graph nas assinaturas, limitada aos tipos de recurso que você escolher | 15 minutos |
| Métricas | As verificações do módulo Azure (métricas de plataforma e linhas do Resource Graph, como trabalhos de backup), o estado dos túneis VPN e, cada um podendo ser desativado, as verificações do Data Factory, o vencimento do Key Vault e o vencimento dos segredos de registros de aplicativo | 5 minutos |
| Alertas | Alertas do Azure Monitor disparados nos últimos 30 dias, por recurso de destino | 5 minutos em Polling; reconciliação a cada 15 minutos em Hybrid |
Escolher a identidade
| Identidade | Use quando |
|---|---|
| The server's managed identity (recomendado) | O servidor do Excubius é executado no Azure e a identidade dele consegue alcançar as assinaturas. Não há nada a armazenar nem a renovar. É a identidade atribuída pelo sistema da VM ou uma identidade atribuída pelo usuário quando AZURE_CLIENT_ID no arquivo .env a indica |
| A service principal | As assinaturas estão em um locatário que a identidade do servidor não alcança. Um registro de aplicativo com um segredo do cliente; renove o segredo antes que ele expire |
Quando o arquivo .env define AZURE_TENANT_ID, AZURE_CLIENT_ID e AZURE_CLIENT_SECRET, todos os três, o servidor usa essa entidade de serviço em vez da identidade gerenciada dele.
Conceder as permissões
Conceda apenas o que as opções que você usa exigem. Os IDs de função são os das funções internas do Azure.
| Para | Função ou permissão | ID da função | Escopo |
|---|---|---|---|
| Inventário e alertas | Reader | acdd72a7-3385-48ef-bd42-f606fba81ae7 | Cada assinatura ou um grupo de gerenciamento |
| Métricas de plataforma | Monitoring Reader | 43d0d8ad-25c7-4714-9337-8ba259a9fe05 | O mesmo |
| Execuções do Data Factory, execuções de gatilhos, status do runtime de integração | Função personalizada Data Factory run reader, abaixo | Criada no seu locatário | As data factories ou os grupos de recursos delas |
| Vencimento do Key Vault | Key Vault Reader para cofres com o RBAC do Azure ou uma política de acesso com List em segredos, chaves e certificados | 21090545-7ca7-4776-b22c-e363652d74d2 | Cada cofre |
| Vencimento dos registros de aplicativo | Permissão de aplicativo do Microsoft Graph Application.Read.All, com consentimento do administrador | — | O locatário |
Por exemplo, para a identidade gerenciada do servidor em uma assinatura:
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>
Uma função somente leitura para o Data Factory
O Data Factory expõe o histórico de execuções como ações. A função Reader não as inclui, e a função interna Data Factory Contributor as concederia junto com o acesso de gravação. Uma função personalizada mantém o acesso somente leitura. Salve isto como 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>"]
}
Em seguida, crie-a e atribua-a:
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>
Sem essa função, todo o resto funciona, e Test lista o Data Factory como uma permissão opcional que falhou.
Adicionar a fonte
- Abra Settings › Sources, selecione Add a source e escolha Azure Monitor.
- Em General, digite um Name e escolha a Entity.
- Em Identity, escolha The server's managed identity ou A service principal. Para uma entidade de serviço, digite o Tenant ID, o Client ID e o Client secret.
- Em Subscriptions, digite os IDs das assinaturas, um por linha, ou deixe vazio para ler todas as assinaturas que a identidade pode ler. Listá-las é a forma de dividir um locatário entre várias entidades de cliente.
- Em Resource types, mantenha os tipos que você quer: máquinas virtuais, bancos de dados do Azure SQL, instâncias gerenciadas de SQL, servidores flexíveis do PostgreSQL, contas de armazenamento, cofres de chaves, cofres dos Serviços de Recuperação, data factories e gateways de rede, firewalls e balanceadores de carga.
- Escolha o que ler: Platform metrics, Fired alerts e Data Factory runs vêm ativados por padrão; Key Vault secret expiry e App registration secret expiry ficam desativados até que você conceda as permissões deles.
- Defina o Time zone em que o "hoje" começa para o resumo do Data Factory, por exemplo
America/Santo_Domingo. - Em Ingest mode, escolha Hybrid (recommended) quando as suas regras de alerta conseguirem alcançar o servidor do Excubius ou Polling caso contrário.
- Selecione Create source e copie a URL do webhook. Ela é exibida apenas uma vez.
Receber alertas por meio de um grupo de ações
No modo Hybrid ou Webhook only:
- No Azure Monitor, crie um action group (grupo de ações) com uma ação Webhook para a URL que o Excubius mostrou e ative o common alert schema (esquema de alerta comum).
- Use esse grupo de ações nas regras de alerta cujos alertas você quer no Excubius.
Os grupos de ações não podem adicionar cabeçalhos, por isso o token na URL é a credencial. Mantenha a URL privada e selecione Rotate URL na fonte se ela vazar.
Testar e sincronizar
- Na página da fonte, selecione Test. Cada leitura é listada com o resultado, com as opcionais marcadas: credenciais, assinaturas, inventário, alertas, métricas, Data Factory, Key Vault e registros de aplicativo.
- Selecione Sync now para trazer os recursos, as métricas e os alertas sem esperar.
Os recursos do Azure aparecem na entidade da fonte, correspondidos com os mesmos servidores de outras fontes pelo ID de recurso e pelos nomes. Cada data factory recebe um cartão no painel Overview, e os segredos que vencem em até 30 dias aparecem em Expiry and risk.