Erros do coletor
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
| Tipo | Exibido como | Significa | Conta para Cannot reach |
|---|---|---|---|
unreachable | Unreachable | Erro de rede, nome não resolvido, conexão recusada ou interrompida, falha no handshake TLS | Sim |
auth | Sign-in refused | O logon falhou, ou o logon não consegue abrir o banco de dados de que precisa | Sim |
timeout | Timed out | A conexão, ou a verificação inteira, demorou mais do que o permitido | Sim |
query | Query failed | O sistema respondeu, mas a instrução falhou, normalmente por falta de uma permissão | Não |
query_timeout | Query timed out | Conectou, mas a instrução excedeu o tempo limite | Não |
config | Configuration | Algo a corrigir no Excubius: nenhum host, nenhuma credencial ou uma credencial do tipo errado, um segredo que não pode ser lido | Não |
unsupported | Not supported | O coletor não tem transporte para esta verificação | Não |
internal | Collector error | Um bug no coletor; a mensagem indica onde | Nã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 como | Normalmente | Verifique |
|---|---|---|
| Credentials refused | Chave ou segredo errado ou expirado, ou a região errada | Substitua o segredo, verifique a região ou o datacenter |
| Missing permission | Falta uma função ou um escopo | Test informa qual leitura falhou; conceda o que Permissões lista |
| Not found | ID de conta, organização ou assinatura errado | Verifique os IDs na fonte |
| Rate limited | A plataforma limita as solicitações | Aumente os intervalos de sondagem |
| Unreachable, Timed out | O servidor não consegue alcançar a API da plataforma | Permita HTTPS de saída para a plataforma |
| Platform error | A API da plataforma respondeu com um erro | Tente novamente mais tarde; verifique o status da plataforma |
| Secrets unreadable | EXCUBIUS_DATA_KEY mudou desde que os segredos foram salvos | Insira-os novamente |
| No collector picked it up | O coletor não está em execução | Consulte a seção anterior |
| Atualidade Stale | Nenhuma sondagem bem-sucedida em três intervalos, no mínimo 15 minutos; para uma fonte somente webhook, nada recebido em um dia | O coletor está em execução? A plataforma está enviando webhooks? |
| Webhooks Rejected | A fonte está desativada ou no modo Polling, ou o cabeçalho secreto está errado | Verifique o modo e o cabeçalho que a plataforma envia |