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

Erros do coletor

Solução de problemasRevisado em 11 de outubro de 2026
Aplica-se a:Excubius 0.4Funções: Administrador de entidade, Editor, Operador
PlanosFree · Core · Pro · EnterpriseImplantaçãoAuto-hospedado

Quando uma verificação não consegue ser executada, ela informa um tipo de erro em vez de um valor. O tipo aparece na verificação, na linha do tempo do recurso e no resultado de Test connection (testar conexão), e ele restringe a causa. Este artigo lista todos os tipos, explica o alerta Cannot reach e indica o que verificar para cada sintoma, tanto em verificações quanto em fontes.

Tipos de erro​

TipoExibido comoSignificaConta para Cannot reach
unreachableUnreachableErro de rede, nome não resolvido, conexão recusada ou interrompida, falha no handshake TLSSim
authSign-in refusedO logon falhou, ou o logon não consegue abrir o banco de dados de que precisaSim
timeoutTimed outA conexão, ou a verificação inteira, demorou mais do que o permitidoSim
queryQuery failedO sistema respondeu, mas a instrução falhou, normalmente por falta de uma permissãoNão
query_timeoutQuery timed outConectou, mas a instrução excedeu o tempo limiteNão
configConfigurationAlgo a corrigir no Excubius: nenhum host, nenhuma credencial ou uma credencial do tipo errado, um segredo que não pode ser lidoNão
unsupportedNot supportedO coletor não tem transporte para esta verificaçãoNão
internalCollector errorUm bug no coletor; a mensagem indica ondeNão

Um recurso mostra um único alerta "Cannot reach"​

Sintoma. Um alerta crítico Cannot reach aparece em um recurso, e os outros alertas do recurso o indicam como causa raiz.

Causa. Por padrão, 3 execuções consecutivas de uma verificação desse recurso falharam com unreachable, auth ou timeout. Em vez de um alerta por verificação com falha, o Excubius abre um único alerta e retém as notificações dos outros alertas do recurso enquanto ele estiver aberto. O número de falhas é definido por EXCUBIUS_UNREACHABLE_AFTER.

Resolução. Corrija a conexão e selecione Test connection no recurso para confirmar. O alerta é resolvido sozinho assim que as verificações com falha voltam a ser bem-sucedidas; até lá, as notificações dos outros alertas do recurso ficam em espera.

As verificações falham com auth​

Causa. A senha está errada ou expirou, o logon está desabilitado, a instância não aceita logons SQL, ou o logon não tem usuário em um banco de dados que uma verificação abre. Em um grupo de disponibilidade, o logon pode ter um SID diferente na nova primária após um failover.

Resolução. Verifique a credencial e se a instância é executada em modo misto. Em grupos de disponibilidade, crie o logon com o mesmo SID em todas as réplicas; consulte Pré-requisitos para grupos de disponibilidade.

As verificações falham com unreachable ou timeout​

Causa. O nome do host não é resolvido a partir do servidor do Excubius, um firewall bloqueia a porta, o serviço está parado ou o caminho de rede está lento.

Resolução. Verifique o DNS e o firewall entre o servidor do Excubius e o sistema, na porta correta: a porta do SQL (e a UDP 1434 para instâncias nomeadas sem porta fixa), 443 ou 80 para endpoints web, 5986 para WinRM, 22 para SSH. Para ouvintes com várias sub-redes, permita todos os IPs do ouvinte. Consulte Caminhos de rede.

As verificações falham com query​

Causa. O sistema respondeu, mas a instrução foi recusada, quase sempre porque falta uma permissão ao logon. Uma verificação que precisa de msdb ou de CONNECT ANY DATABASE falha dessa forma enquanto as outras funcionam.

Resolução. Selecione Test connection: no SQL Server, ele lista as permissões do logon e o que está faltando. Conceda o que Permissões lista, e nada mais.

As verificações falham com query_timeout​

Causa. A instrução foi executada por mais tempo do que o tempo limite, 30 segundos por padrão no SQL Server, normalmente em uma instância sob carga pesada.

Resolução. Tente novamente mais tarde. Se o problema persistir em uma instância ocupada, aumente o parâmetro query_timeout_seconds da verificação para esse recurso.

As verificações falham com config​

Causa. Algo no Excubius está incompleto: o recurso não tem host, nenhuma credencial o alcança, a credencial é de um tipo que a verificação não pode usar, ou o segredo armazenado não pode ser descriptografado porque EXCUBIUS_DATA_KEY mudou.

Resolução. Edite o recurso ou a credencial. Uma verificação em um servidor de relatórios que tem uma conta do Windows precisa de um logon SQL para suas verificações T-SQL; consulte Qual credencial um recurso usa. Se os segredos não puderem ser lidos, insira-os novamente.

As verificações falham com unsupported ou ficam em Unknown​

Causa. Nenhum coletor oferece o transporte de que a verificação precisa. EXCUBIUS_COLLECTOR_TRANSPORTS pode excluí-lo, ou o transporte ainda não existe: as verificações do PostgreSQL ficam em Unknown nesta versão.

Resolução. Remova o transporte da restrição ou desative a verificação nesse recurso. Consulte Compatibilidade.

Um trabalho termina com "No collector picked it up"​

Sintoma. Test connection, Discover ou o Test de uma fonte fica em waiting for the collector e depois termina com No collector picked it up (nenhum coletor o assumiu).

Causa. Nenhum coletor assumiu o trabalho em 10 minutos. O coletor não está em execução, não tem token (EXCUBIUS_COLLECTOR_TOKEN está vazio e, nesse caso, ele fica ocioso) ou não oferece o transporte. Um trabalho que um coletor assumiu, mas sobre o qual não informou resultado em 15 minutos, falha com timeout.

Resolução. Verifique a última pulsação do coletor na zona Sources do Overview. No servidor, como a conta de serviço, execute <dir>/current/scripts/compose.sh ps e <dir>/current/scripts/compose.sh logs collector.

Erros de fontes​

Uma fonte mostra seu último erro com um destes tipos:

Exibido comoNormalmenteVerifique
Credentials refusedChave ou segredo errado ou expirado, ou a região erradaSubstitua o segredo, verifique a região ou o datacenter
Missing permissionFalta uma função ou um escopoTest informa qual leitura falhou; conceda o que Permissões lista
Not foundID de conta, organização ou assinatura erradoVerifique os IDs na fonte
Rate limitedA plataforma limita as solicitaçõesAumente os intervalos de sondagem
Unreachable, Timed outO servidor não consegue alcançar a API da plataformaPermita HTTPS de saída para a plataforma
Platform errorA API da plataforma respondeu com um erroTente novamente mais tarde; verifique o status da plataforma
Secrets unreadableEXCUBIUS_DATA_KEY mudou desde que os segredos foram salvosInsira-os novamente
No collector picked it upO coletor não está em execuçãoConsulte a seção anterior
Atualidade StaleNenhuma sondagem bem-sucedida em três intervalos, no mínimo 15 minutos; para uma fonte somente webhook, nada recebido em um diaO coletor está em execução? A plataforma está enviando webhooks?
Webhooks RejectedA fonte está desativada ou no modo Polling, ou o cabeçalho secreto está erradoVerifique o modo e o cabeçalho que a plataforma envia