Pular para o conteúdo principal
Versão: 0.4 · atual

Conectar o Azure Monitor

Guia de instruçõesRevisado em 11 de outubro de 2026
Aplica-se a:Excubius 0.4Funções: Administrador de entidade
PlanosFree · Core · Pro · EnterpriseImplantaçãoAuto-hospedado

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_monitor está 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.

FaseO quêIntervalo padrão
InventárioUma consulta do Resource Graph nas assinaturas, limitada aos tipos de recurso que você escolher15 minutos
MétricasAs 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 aplicativo5 minutos
AlertasAlertas do Azure Monitor disparados nos últimos 30 dias, por recurso de destino5 minutos em Polling; reconciliação a cada 15 minutos em Hybrid

Escolher a identidade​

IdentidadeUse 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 principalAs 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.

ParaFunção ou permissãoID da funçãoEscopo
Inventário e alertasReaderacdd72a7-3385-48ef-bd42-f606fba81ae7Cada assinatura ou um grupo de gerenciamento
Métricas de plataformaMonitoring Reader43d0d8ad-25c7-4714-9337-8ba259a9fe05O mesmo
Execuções do Data Factory, execuções de gatilhos, status do runtime de integraçãoFunção personalizada Data Factory run reader, abaixoCriada no seu locatárioAs data factories ou os grupos de recursos delas
Vencimento do Key VaultKey Vault Reader para cofres com o RBAC do Azure ou uma política de acesso com List em segredos, chaves e certificados21090545-7ca7-4776-b22c-e363652d74d2Cada cofre
Vencimento dos registros de aplicativoPermissã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​

  1. Abra Settings › Sources, selecione Add a source e escolha Azure Monitor.
  2. Em General, digite um Name e escolha a Entity.
  3. 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.
  4. 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.
  5. 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.
  6. 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.
  7. Defina o Time zone em que o "hoje" começa para o resumo do Data Factory, por exemplo America/Santo_Domingo.
  8. Em Ingest mode, escolha Hybrid (recommended) quando as suas regras de alerta conseguirem alcançar o servidor do Excubius ou Polling caso contrário.
  9. 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:

  1. 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).
  2. Use esse grupo de ações nas regras de alerta cujos alertas você quer no Excubius.
aviso

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​

  1. 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.
  2. 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.