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

Como o coletor funciona

ConceitoRevisado em 11 de outubro de 2026
Aplica-se a:Excubius 0.4Funções: Administrador de entidade, Instalador (administrador do Linux)
PlanosFree · Core · Pro · EnterpriseImplantaçãoAuto-hospedado

O coletor é a parte do Excubius que alcança os seus sistemas. Ele executa as verificações do catálogo por meio de conexões somente leitura, lê as fontes que você adiciona e envia os resultados brutos para a API, que os avalia, gera alertas e envia notificações. Este artigo explica como ele funciona, quais transportes usa, o que cada módulo exige, quais caminhos de rede abrir e o que ele nunca faz.

Como uma verificação é executada​

  1. A cada 30 segundos, o coletor pergunta à API o que executar: as definições das verificações do catálogo, os recursos que elas têm como destino e as credenciais que usam. Quando nada mudou, a resposta vem vazia e quase não tem custo.
  2. Ele executa cada verificação no intervalo dela, pelo transporte que o catálogo indica, como T-SQL para uma instância do SQL Server ou HTTP para um endpoint web.
  3. Ele envia os resultados brutos para a API em lotes. A API os compara com os limites efetivos, abre e resolve alertas e notifica os canais certos.
  4. A cada 10 segundos, ele obtém as tarefas avulsas, como Test connection, Discover e o Test e o Sync now de uma fonte. A cada 60 segundos, ele informa uma pulsação, que a zona Sources do painel Overview mostra.

O coletor é executado dentro do servidor do Excubius, ao lado da API. Ele recebe apenas o próprio token e as próprias configurações; nunca vê a senha do banco de dados nem a chave que criptografa os segredos armazenados. As credenciais chegam a ele pela rede interna, ficam na memória e nunca são registradas em log.

Transportes​

Um transporte é a forma como o coletor se comunica com um tipo de sistema. Cada um apenas lê.

TransporteAlcançaPortaTipo de credencialStatus
T-SQL (Microsoft ODBC Driver 18)Instâncias do SQL Server, grupos de disponibilidade, servidores vinculados, o log de execução do Reporting Services1433 ou a porta da instância; UDP 1434 para instâncias nomeadas sem porta fixaLogon do SQLCompatível
HTTP(S)Endpoints web, portais do Reporting Services, certificados TLS, vencimento de domínios (RDAP)443, 80Nenhuma, conta do Windows (NTLM), usuário e senha HTTP, token de portadorCompatível
DNSResolução de nomes de endpoints e de ouvintes de grupos de disponibilidade, com o resolvedor do servidor53NenhumaCompatível
Azure Resource GraphVerificações de postura na nuvem, avaliações do Defender for Cloud, Azure Update Manager, Service Health443A identidade gerenciada do servidor ou uma entidade de serviço do AzureCompatível
Microsoft GraphVerificações de identidade do Entra ID443A identidade gerenciada do servidor ou uma entidade de serviço do AzureCompatível
WazuhO indexador do Wazuh e, opcionalmente, a API do gerenciadorAs URLs que você defineUsuário e senha HTTPCompatível quando o Wazuh está ativado
WinRMVerificações de hosts Windows, verificações do Active Directory5986 (HTTPS)Conta do WindowsExperimental
SSHVerificações de hosts Linux22 ou a ssh_port do hostChave SSH, senha SSHExperimental
PostgreSQLVerificações do módulo PostgreSQL5432Logon do SQLAinda não disponível: as verificações são adicionadas, mas permanecem Desconhecido
aviso

Os transportes WinRM e SSH existem e as verificações deles são adicionadas aos hosts Windows e Linux, mas ainda não foram validados com hosts reais. Para esses hosts, use o NinjaOne, o New Relic ou o Azure Monitor como fonte até que uma versão os marque como compatíveis.

As fontes também são lidas pelo coletor, por HTTPS (443), cada uma com o próprio adaptador: o New Relic por meio do NerdGraph, o NinjaOne por meio da API pública dele e o Azure Monitor por meio do Azure Resource Manager, do Resource Graph, do Azure Monitor, do Data Factory, do Key Vault e do Microsoft Graph. Consulte Fontes.

Por padrão, o coletor oferece todos os transportes cujas bibliotecas estão presentes na imagem dele. EXCUBIUS_COLLECTOR_TRANSPORTS restringe essa lista; consulte Variáveis de ambiente.

O que cada módulo exige​

MóduloColetado por meio deO que você fornece
SQL Server, grupos de disponibilidade, segurança do SQL ServerT-SQLUm logon do SQL somente leitura em cada instância e réplica
WindowsWinRM (experimental) ou New Relic e NinjaOneUma conta do Windows em três grupos locais de leitura ou uma fonte
LinuxSSH (experimental) ou New Relic e NinjaOneUm usuário não root com uma chave ou uma fonte
PostgreSQLAinda não disponível nativamente; servidores flexíveis do Azure por meio do Azure MonitorUma função com pg_monitor, pronta para quando a coleta chegar
Azure, Azure Data FactoryA fonte Azure MonitorReader e Monitoring Reader, além de uma função somente leitura do Data Factory
Testes sintéticosHTTP, DNS, T-SQLCredenciais apenas para endpoints protegidos e servidores de relatórios
VencimentosAzure Monitor, HTTP (RDAP), T-SQL, WinRMPermissões de leitura do Key Vault e do Microsoft Graph
AtualizaçõesFeeds de fornecedores lidos pela API, além de verificações de inventárioHTTPS de saída do servidor para os feeds
Segurança de identidadeMicrosoft Graph, WinRMPermissões de aplicativo do Graph somente leitura
Segurança na nuvemResource Graph, Defender for Cloud, WazuhReader e Security Reader; um usuário do Wazuh somente leitura
New Relic, NinjaOneA fonte correspondenteUma chave ou um cliente de API somente leitura

Todas as permissões em um só lugar: Permissões.

Caminhos de rede​

Todas as conexões começam no servidor do Excubius. Nada se conecta ao coletor.

ParaPortaFinalidade
Cada instância do SQL Server, réplica, nome de ouvinte e IP de ouvinteA porta SQL, 1433 por padrãoMódulos do SQL Server, grupos de disponibilidade, viagens de ida e volta SQL sintéticas
Instâncias nomeadas sem porta fixaUDP 1434SQL Server Browser
Endpoints web e portais do Reporting Services443, 80Testes sintéticos, certificados TLS
O resolvedor DNS do servidor53Verificações de resolução de nomes
data.iana.org e os servidores RDAP dos registros443Vencimento de domínios
Hosts Windows5986WinRM (experimental)
Hosts Linux22SSH (experimental)
management.azure.com, graph.microsoft.com, os seus cofres de chaves (*.vault.azure.net) e login.microsoftonline.com quando você usa uma entidade de serviço443Fonte Azure Monitor, verificações de postura e de identidade do Azure
api.newrelic.com ou api.eu.newrelic.com443Fonte New Relic
app.ninjarmm.com ou eu., oc. ou ca.ninjarmm.com443Fonte NinjaOne
O indexador e o gerenciador do WazuhAs portas delesWazuh

É a API, e não o coletor, que obtém os feeds de atualizações e se comunica com o Slack e o Jira; consulte Variáveis de ambiente. Os webhooks das fontes chegam ao endereço público do servidor na porta 443 e vão para a API, nunca para o coletor.

Limites e tempos limite​

LimiteValor
Verificações executadas ao mesmo tempo32 no total; por transporte: T-SQL 8, HTTP e DNS 16, SSH 8, WinRM 4, Resource Graph 4, Defender, Microsoft Graph e Wazuh 2
Tempo limite de logon do SQL Server · tempo limite de consulta10 s · 30 s (parâmetros do catálogo timeout_seconds, query_timeout_seconds)
Linhas lidas por consulta1.000
Duração máxima de uma única verificação120 s
Resultados mantidos enquanto a API não pode ser alcançada10.000; os mais antigos são descartados primeiro

As sessões do SQL Server levam o nome de aplicativo monitoring-collector, para que os administradores de banco de dados possam reconhecê-las em sys.dm_exec_sessions.

O que o coletor nunca faz​

O coletor é somente leitura por provisionamento e por código. Ele nunca instala, atualiza, reinicia ou para nada, nunca grava dados, registro ou configuração, nunca encerra uma sessão e nunca executa uma correção. Uma verificação que precisaria de uma gravação é rejeitada quando é revisada para o catálogo.

O que ele envia:

  • SQL Server: SELECT em exibições de gerenciamento dinâmico, exibições do catálogo, tabelas de backup e de trabalhos do msdb e a ExecutionLog3 do servidor de relatórios; sys.sp_readerrorlog para uma variável de tabela; sp_testlinkedserver para servidores vinculados.
  • HTTP: apenas GET e HEAD.
  • Azure e Wazuh: leituras, além das poucas solicitações POST que são consultas, como uma consulta do Resource Graph, uma consulta de execuções do Data Factory ou um _search do Wazuh. Qualquer outra coisa é recusada no código.
  • WinRM e SSH: os comandos do PowerShell e do shell escritos no catálogo, que apenas leem.

A consulta exata de cada verificação está no catálogo e na API em GET /api/v1/catalog/checks/{id}.

Agentes para fontes opcionais​

O Excubius não instala nada nos sistemas que monitora. Os agentes das fontes opcionais, como o Wazuh, são implantados pelas suas próprias ferramentas, por exemplo o NinjaOne ou o seu gerenciamento de configuração.

Próximas etapas​