Skip to main content

Guia de Erros Comuns

Este documento é um guia rápido para identificar e corrigir falhas em scripts personalizados no Monsta Tecnologia. Se você encontrou um erro de execução ou um retorno inesperado em um sensor, consulte as categorias abaixo.

Estrutura de cada tópico:

  1. Erro: Descrição do sintoma ou mensagem de log.

  2. Causa Provável: O que geralmente dispara esse comportamento.

  3. Solução: Passo a passo para correção.

Erro Lua script runner timeout: deadline has elapsed
Causa

Este erro ocorre quando o motor de execução do Monsta interrompe o script Lua porque ele excedeu o

tempo limite (timeout) permitido para a execução de um sensor. Por padrão, o Monsta encerra scripts que demoram muito para responder para evitar que o sistema fique travado ou consuma recursos excessivos do servidor.

Solução

Acesse Configuração > Parâmetros e utilize o campo de pesquisa para localizar a chave lua.timeout. O valor padrão é de 130 segundos. Para alterá-lo, clique em Desbloquear, insira o novo valor e salve.

 

Erro Pagefile: Timeout connecting to xx.xx.xx.xx:xxxx stack traceback: [C]: in function 'poll' [string "?"]:x: in function 'connect' [string "script"]:xxx: in function <[string "script"]:xxx> (tail call): in function <(tail call):-1>
Causa

Este erro indica uma falha na tentativa de estabelecer uma conexão de rede. O script Lua conseguiu iniciar a chamada, mas ela expirou antes que o dispositivo de destino respondesse ao "aperto de mão" (handshake) da conexão.

"stack traceback" mostra que a falha ocorreu exatamente no momento da tentativa de conexão (in function 'connect'), antes mesmo de qualquer dado ser enviado ou recebido.

Solução

Edite o dispositivo, acesse o menu Coleta > WMI e aumente o campo WMI Timeout. Utilize o botão de "Testar" para validar a comunicação. Após, salve as modificações. 

 

Caso o problema persista, outros fatores relacionados a rede podem impedir essa comunicação. Nesse caso, verifique em sua rede:

  • Firewall/Bloqueio: Existe uma regra de firewall no destino ou no meio do caminho (ACL, IPS) bloqueando o IP do Monsta na porta especificada.

  • Serviço Offline: O serviço que você está tentando monitorar (ex: API, servidor web, banco de dados) está parado ou não está escutando naquela porta específica.

  • Rede Inalcançável: O servidor Monsta não possui uma rota válida para o IP de destino.

  • Porta Incorreta: O script está tentando conectar em uma porta diferente da que o serviço utiliza.

  • Carga Excessiva no Destino: O dispositivo alvo está com a CPU tão alta que não consegue processar novas requisições de conexão.

 

Erro Tempo de Resposta: ping failed: Request timeout for icmp_seq x
Causa

Este erro ocorre quando o Monsta envia um pacote de eco ICMP (o famoso "Ping") para um dispositivo, mas não recebe a resposta (Echo Reply) dentro do tempo esperado.

Solução

O dispositivo monitorado não respondeu às solicitações de ICMP (ping) do Monsta.

 

Dica: Se o equipamento estiver em uma rede com alta latência ou perda de pacotes, ajuste a sensibilidade de detecção. Para isso, edite o dispositivo e acesse Detalhes > Sensibilidade, alterando os parâmetros conforme a necessidade do ambiente.

 

Erro SNMP timeout stack traceback: [C]: in function 'poll' [string "?"]:xx: in function 'getex' [string "script"]:xx: in function 'get' [string "script"]:xx: in main chunk
Causa

Este erro ocorre quando o script tenta realizar uma leitura SNMP e a conexão expira sem receber os dados solicitados

Solução

O dispositivo monitorado não respondeu às solicitações de SNMP do Monsta.

 

Edite o dispositivo, acesse o menu Coleta > SNMP e aumente o Timeout SNMP. Utilize o botão de "Testar" para validar a comunicação. Após, salve as modificações. 

 

Caso o problema persista, outros fatores relacionados a rede podem impedir essa comunicação. Nesse caso, verifique em sua rede:

  • Comunidade SNMP Incorreta: A "Community String" (ex: public ou private) configurada no Monsta não coincide com a configurada no dispositivo.

  • Versão do SNMP Divergente: O dispositivo está usando SNMP v2c e o script/configuração está tentando v1 (ou vice-versa), ou há erro nas credenciais de v3.

  • ACL ou Firewall: O dispositivo possui uma lista de controle de acesso (ACL) que permite apenas IPs específicos realizarem consultas SNMP, e o IP do Monsta não está nela.

  • Porta Bloqueada: A porta UDP 161 (padrão do SNMP) está bloqueada no caminho.

  • Sobrecarga do Agente SNMP: O processador do dispositivo monitorado está tão ocupado que o serviço (agente) SNMP não consegue responder à consulta a tempo.

 

Erro Error converting to type: Float
Causa

Esse erro ocorre quando o sistema espera um número decimal (Float), mas recebeu algo que ele não consegue transformar em número, como um texto (String) inválido ou um valor nulo (nil).

Solução

Revise o script do monitor para garantir que o retorno não contenha strings (como vírgulas ou unidades de medida) no campo de valor. Caso o monitor apresente leituras normais, mas exiba falhas intermitentes com esse erro, é provável que o dispositivo esteja retornando um valor nulo (nil). Isso ocorre quando não há resposta na consulta; nesses casos, verifique nos logs do equipamento a existência de alguma falha.

 

Erro Ssh error occured: Key exchange init failed stack traceback
Causa

Este erro ocorre durante a tentativa de conexão SSH entre o Monsta e um dispositivo remoto (geralmente modelos mais antigos de switches, roteadores ou rádios). Ele indica que o Monsta e o dispositivo não conseguiram entrar em acordo sobre qual algoritmo de troca de chaves (Key Exchange) utilizar, pois o dispositivo utiliza padrões que hoje são considerados legados ou inseguros por bibliotecas modernas.

Solução

O Monsta utiliza bibliotecas de criptografia de última geração. A falha na troca de chaves (Key Exchange) é um alerta de que o seu dispositivo remoto está operando com padrões de segurança obsoletos. A correção definitiva é a atualização do dispositivo monitorado para que suporte algoritmos de criptografia seguros.

 

Erro No route to host (os error 113) stack traceback
Causa

O erro os error 113 é um código de erro de rede do sistema operacional que indica que o host de destino não pôde ser alcançado. O sistema operacional não sabe por qual interface de rede deve enviar o pacote para alcançar aquele IP específico.

Solução

Para resolver o erro, certifique-se de que a tabela de roteamento do sistema possui um caminho válido para o IP de destino e que o gateway padrão está configurado corretamente para encaminhar os pacotes fora da rede local.