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: Erro: Descrição do sintoma ou mensagem de log. Causa Provável: O que geralmente dispara esse comportamento. 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.