Como o coletor funciona
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
- 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.
- 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.
- 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.
- 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ê.
| Transporte | Alcança | Porta | Tipo de credencial | Status |
|---|---|---|---|---|
| T-SQL (Microsoft ODBC Driver 18) | Instâncias do SQL Server, grupos de disponibilidade, servidores vinculados, o log de execução do Reporting Services | 1433 ou a porta da instância; UDP 1434 para instâncias nomeadas sem porta fixa | Logon do SQL | Compatível |
| HTTP(S) | Endpoints web, portais do Reporting Services, certificados TLS, vencimento de domínios (RDAP) | 443, 80 | Nenhuma, conta do Windows (NTLM), usuário e senha HTTP, token de portador | Compatível |
| DNS | Resolução de nomes de endpoints e de ouvintes de grupos de disponibilidade, com o resolvedor do servidor | 53 | Nenhuma | Compatível |
| Azure Resource Graph | Verificações de postura na nuvem, avaliações do Defender for Cloud, Azure Update Manager, Service Health | 443 | A identidade gerenciada do servidor ou uma entidade de serviço do Azure | Compatível |
| Microsoft Graph | Verificações de identidade do Entra ID | 443 | A identidade gerenciada do servidor ou uma entidade de serviço do Azure | Compatível |
| Wazuh | O indexador do Wazuh e, opcionalmente, a API do gerenciador | As URLs que você define | Usuário e senha HTTP | Compatível quando o Wazuh está ativado |
| WinRM | Verificações de hosts Windows, verificações do Active Directory | 5986 (HTTPS) | Conta do Windows | Experimental |
| SSH | Verificações de hosts Linux | 22 ou a ssh_port do host | Chave SSH, senha SSH | Experimental |
| PostgreSQL | Verificações do módulo PostgreSQL | 5432 | Logon do SQL | Ainda não disponível: as verificações são adicionadas, mas permanecem Desconhecido |
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ódulo | Coletado por meio de | O que você fornece |
|---|---|---|
| SQL Server, grupos de disponibilidade, segurança do SQL Server | T-SQL | Um logon do SQL somente leitura em cada instância e réplica |
| Windows | WinRM (experimental) ou New Relic e NinjaOne | Uma conta do Windows em três grupos locais de leitura ou uma fonte |
| Linux | SSH (experimental) ou New Relic e NinjaOne | Um usuário não root com uma chave ou uma fonte |
| PostgreSQL | Ainda não disponível nativamente; servidores flexíveis do Azure por meio do Azure Monitor | Uma função com pg_monitor, pronta para quando a coleta chegar |
| Azure, Azure Data Factory | A fonte Azure Monitor | Reader e Monitoring Reader, além de uma função somente leitura do Data Factory |
| Testes sintéticos | HTTP, DNS, T-SQL | Credenciais apenas para endpoints protegidos e servidores de relatórios |
| Vencimentos | Azure Monitor, HTTP (RDAP), T-SQL, WinRM | Permissões de leitura do Key Vault e do Microsoft Graph |
| Atualizações | Feeds de fornecedores lidos pela API, além de verificações de inventário | HTTPS de saída do servidor para os feeds |
| Segurança de identidade | Microsoft Graph, WinRM | Permissões de aplicativo do Graph somente leitura |
| Segurança na nuvem | Resource Graph, Defender for Cloud, Wazuh | Reader e Security Reader; um usuário do Wazuh somente leitura |
| New Relic, NinjaOne | A fonte correspondente | Uma 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.
| Para | Porta | Finalidade |
|---|---|---|
| Cada instância do SQL Server, réplica, nome de ouvinte e IP de ouvinte | A porta SQL, 1433 por padrão | Módulos do SQL Server, grupos de disponibilidade, viagens de ida e volta SQL sintéticas |
| Instâncias nomeadas sem porta fixa | UDP 1434 | SQL Server Browser |
| Endpoints web e portais do Reporting Services | 443, 80 | Testes sintéticos, certificados TLS |
| O resolvedor DNS do servidor | 53 | Verificações de resolução de nomes |
data.iana.org e os servidores RDAP dos registros | 443 | Vencimento de domínios |
| Hosts Windows | 5986 | WinRM (experimental) |
| Hosts Linux | 22 | SSH (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ço | 443 | Fonte Azure Monitor, verificações de postura e de identidade do Azure |
api.newrelic.com ou api.eu.newrelic.com | 443 | Fonte New Relic |
app.ninjarmm.com ou eu., oc. ou ca.ninjarmm.com | 443 | Fonte NinjaOne |
| O indexador e o gerenciador do Wazuh | As portas deles | Wazuh |
É 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
| Limite | Valor |
|---|---|
| Verificações executadas ao mesmo tempo | 32 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 consulta | 10 s · 30 s (parâmetros do catálogo timeout_seconds, query_timeout_seconds) |
| Linhas lidas por consulta | 1.000 |
| Duração máxima de uma única verificação | 120 s |
| Resultados mantidos enquanto a API não pode ser alcançada | 10.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:
SELECTem exibições de gerenciamento dinâmico, exibições do catálogo, tabelas de backup e de trabalhos domsdbe aExecutionLog3do servidor de relatórios;sys.sp_readerrorlogpara uma variável de tabela;sp_testlinkedserverpara servidores vinculados. - HTTP: apenas
GETeHEAD. - Azure e Wazuh: leituras, além das poucas solicitações
POSTque são consultas, como uma consulta do Resource Graph, uma consulta de execuções do Data Factory ou um_searchdo 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.