Eventos
Abaixo, segue uma tabela detalhando os principais eventos de sistema classificados em algumas categorias:
Conectividade
Mensagem do Evento |
Significado |
Sugestões |
|---|---|---|
Conector online(conectado) |
O Conector abriu conexão com o Portal de Telemetria e foi identificado com sucesso |
|
Conector offline(desconectado) |
O Conector não está mais conectado ao Portal de Telemetria |
Avalie se o conector possui acesso a internet ou avalie possíveis instabilidades na conexão do Conector com o Portal(conexões físicas, internet, planos de dados, modem 3G/4G, etc) |
Identificada nova tentativa de conexão para o Conector |
Portal identificou uma nova conexão para o Conector e irá validar se a conexão atual está OK(trocando informações) |
Avaliar possíveis instabilidades na conexão do Conector com o Portal(conexões físicas, internet, planos de dados, modem 3G/4G, etc) que eventualmente devido a timings de rede, podem configurar este cenário |
Já existe uma conexão ativa para o Conector |
Portal identificou que após a tentativa de uma segunda conexão do Conector, a conexão atual não está OK. Conexão atual é fechada para habilitar a segunda conexão |
|
Habilitada nova conexão para o Conector |
Portal “efetiva” a nova conexão do Conector após identificar que a conexão atual não está mais OK(trocando informações) |
|
Nova tentativa de conexão offline(desconectada) |
A nova tentativa de conexão não está mais conectada ao Portal de Telemetria |
|
Token id XYZ conectado |
Indica que o token está conectado ao Portal de Telemetria, ou seja, o equipamento está sendo acessado remotamente via HIstudio ou SPDSW |
|
Token id XYZ desconectado |
Indica que o token foi desconectado do Portal de Telemetria |
O Portal preenche automaticamente esta coluna com informações sobre o tipo de desconexão. Veja os tipos abaixo para entender melhor cada cenário.
Tipos de Desconexão
A coluna de detalhes dos eventos de desconexão pode apresentar as seguintes informações:
Conexão não comportada (interrupção abrupta)
Ocorre quando a conexão é interrompida de forma inesperada, sem que o cliente (Conector) tenha enviado uma solicitação formal para encerrá-la. Este tipo de desconexão é identificado pela biblioteca de rede utilizada no coletor do Portal e geralmente indica problemas de infraestrutura ou falhas inesperadas no equipamento remoto.
A biblioteca de rede do coletor do Portal monitora constantemente o estado das conexões TCP/IP estabelecidas com os Conectores. Quando uma conexão é perdida sem o procedimento normal de encerramento (handshake de finalização TCP), a biblioteca classifica automaticamente como “conexão não comportada”.
Cenários comuns em que este tipo de desconexão pode ocorrer:
Perda/Queda repentina da rede celular: Situações onde o sinal 3G/4G é perdido abruptamente, seja por problemas de cobertura, interferências ou instabilidades da operadora. O socket permanece aberto no Portal, mas o canal físico de comunicação foi interrompido sem aviso;
Desligamento abrupto do CLP: Quando o controlador é desligado sem seguir o procedimento adequado de shutdown, seja por falta de energia, acionamento do botão de desligamento ou reset forçado. Nestes casos, o sistema operacional do equipamento não tem tempo de fechar corretamente as conexões ativas;
Travamento do equipamento remoto: Ocorre quando o CLP, roteador ou modem “trava” devido a erros de software, sobrecarga de processamento ou falhas de hardware, impedindo que o encerramento correto do socket seja realizado;
Problemas em equipamentos de rede intermediários: Falhas em switches, roteadores ou modems entre o Conector e o Portal podem causar a perda abrupta da conexão sem que nenhuma das pontas seja notificada adequadamente.
Conexão comportada (encerramento correto)
Ocorre quando o cliente (Conector) fecha o socket de maneira adequada, seguindo o protocolo de comunicação TCP/IP. A conexão é finalizada de forma controlada e esperada, através do procedimento correto de handshake de encerramento.
Em uma desconexão comportada, o Conector envia ao Portal uma solicitação formal de encerramento (FIN - Finish), o Portal confirma o recebimento (ACK - Acknowledgment), e ambos os lados concordam que a conexão será finalizada. Este é o procedimento padrão definido no protocolo TCP para encerrar conexões de forma limpa e ordenada.
Cenários comuns em que este tipo de desconexão pode ocorrer:
Desligamento controlado do CLP ou dispositivo: Quando o equipamento é desligado seguindo o procedimento adequado de shutdown, permitindo que o sistema operacional finalize todos os processos e conexões de rede antes de desligar completamente;
Finalização correta da comunicação pelo software cliente: O software Conector pode encerrar a conexão de forma programada após completar suas tarefas ou em resposta a comandos do usuário, sempre seguindo o protocolo correto;
Encerramento programado da conexão: Em alguns casos, a aplicação pode estar configurada para desconectar periodicamente e reconectar, seja para renovação de credenciais, atualização de parâmetros ou manutenção preventiva da conexão;
Reinicialização planejada do sistema: Durante manutenções programadas, atualizações de firmware ou reboot controlado do equipamento, as conexões são finalizadas adequadamente antes do sistema ser reiniciado.
Timeout de comunicação
Ocorre quando o Portal envia um comando ao equipamento (como leitura ou escrita de memória, sincronização de data/hora, ou coleta de dados) e não recebe resposta dentro do tempo esperado. O tempo de espera (timeout) atual é de aproximadamente 1 minuto (60 segundos).
Quando o Portal envia qualquer comando ao Conector, ele inicia um temporizador de 60 segundos aguardando a resposta. Este mecanismo de timeout é essencial para evitar que o sistema fique indefinidamente esperando por uma resposta que pode nunca chegar. Após o período de timeout sem receber resposta, o Portal automaticamente encerra a conexão e registra o evento.
O timeout pode ocorrer por diversos motivos relacionados à comunicação ou ao estado do equipamento:
Latência excessiva na rede: Quando o tempo de resposta entre o Conector e o Portal está muito alto devido a congestionamento de rede, qualidade ruim do sinal de internet ou sobrecarga em equipamentos intermediários;
Equipamento sobrecarregado: O CLP pode estar executando processamento intensivo, atendendo múltiplas requisições simultâneas, ou com recursos limitados (CPU/memória), fazendo com que não consiga processar e responder aos comandos do Portal dentro do tempo esperado;
Travamento parcial do sistema: Diferente do travamento completo, o equipamento pode estar “semi-responsivo”, mantendo a conexão de rede ativa mas sem conseguir processar comandos adequadamente;
Problemas no protocolo de comunicação: Erros na implementação do protocolo MODBUS ou SCPHI, incompatibilidades de versão ou corrupção de pacotes podem impedir que as respostas cheguem corretamente ao Portal;
Perda intermitente de pacotes: A conexão pode estar estabelecida, mas com perda significativa de pacotes de dados, fazendo com que os comandos ou suas respostas se percam no caminho;
Firewall ou regras de rede restritivas: Configurações de segurança muito restritivas podem estar bloqueando ou atrasando excessivamente certos tipos de tráfego.
Data/hora do Conector
Mensagem do Evento |
Significado |
Sugestões |
|---|---|---|
Data/hora atualizada no conector: DD/MM/YYYY hh:mm:ss |
Portal atualizou a data/hora no Conector |
Este procedimento é feito na conexão do Conector e cada 1 hora caso detectada que a data/hora do Conector possui uma diferença igual ou superior a +/- 5 segundos em relação a data/hora do servidor do Portal |
Erro na leitura de data/hora no conector: conversão de data/hora |
Portal não conseguiu converter o valor de data/hora lido do Conector |
Avaliar com o Histudio ou com SPDSW a condição do relógio/calendário do equipamento |
Erro na leitura de data/hora no conector. Código de retorno do protocolo: X |
Houve uma falha retornada pelo protocolo de comunicação(MODBUS ou SCPHI) na leitura da data/hora do Conector. X representa o código de erro retornado pelo protocolo |
Avaliar possíveis instabilidades na conexão do Conector com o Portal(conexões físicas, internet, planos de dados, modem 3G/4G, etc) que podem interromper a conexão durante a leitura |
Comandos do usuário
Mensagem do Evento |
Significado |
Sugestões |
|---|---|---|
Criação de comando de escrita em dado |
Indica a criação de um comando de escrita no dado por parte do usuário |
|
Envio do comando de escrita |
Portal realizou a escrita com sucesso no dado indicado |
|
Erro em escrita de valor X na memoria Coil Status endereço Y dispositivo Z |
Ocorreu uma falha de escrita de valor em dado, onde X é o valor que deveria ser escrito, Y é o endereço do dado e Z é o endereço do Dispositivo |
Avaliar se o Conector remoto permite escrita no endereço configurado no dado ou entrar em contato com o time de suporte técnico da HI Tecnologia |
Erro ao realizar leitura após comando de escrita em NOME DADO. Código de retorno do protocolo: X |
Ocorreu uma falha na leitura do dado no conector após um comando de escrita(caso esteja configurado o modo de leitura após uma escrita na configuração do dado) |
Entrar em contato com o time de suporte técnico da HI Tecnologia |
Falha ao processar comandos de escrita em dados |
Portal de Telemetria identificou uma falha genérica no envio de comandos de escrita para o conector |
Entrar em contato com o time de suporte técnico da HI Tecnologia |
Comando de reconhecimento de alarme executado com sucesso |
Usuário executou um comando de reconhecimento de alarme no recurso indicado |
Leitura(coleta) de Dados
Mensagem do Evento |
Significado |
Sugestões |
|---|---|---|
Erro de leitura no dado Holding Register endereço Y dispositivo Z |
Ocorreu uma falha de leitura de valor de um dado, onde Y é o endereço do dado e Z é o endereço do Dispositivo |
Avaliar se o controlador remoto permite ou possui o endereço configurado no dado para leitura |
Valor lido para o dado(V) é inferior ao valor mínimo permitido(M) |
Valor lido para o Dado é menor que o valor mínimo permitido(conforme configurado no dado), onde V é o valor lido e M é o valor mínimo configurado |
Reconfigurar o valor de limite mínimo para leitura do dado no Portal ou avaliar no programa do controlador o motivo do valor estar fora do esperado |
Valor lido para o dado(V) é superior ao valor máximo permitido(M) |
Valor lido para o Dado é maior que o valor máximo permitido(conforme configurado no dado), onde V é o valor lido e M é o valor máximo configurado |
Reconfigurar o valor de limite máximo para leitura do dado no Portal ou avaliar no programa do controlador o motivo do valor estar fora do esperado |
Histórico de Dados HABILITADO para o Dispositivo: X |
Indica que o Histórico de Dados do Dispositivo X, onde X é o nome do Dispositivo, está apto a receber registros devido a condição configurada no mesmo para tal estar verdadeira |
Avaliar a configuração da condição do Dado ativador de histórico. Ex: Caso seu valor seja “verdadeiro”, habilita o registro no Histórico de Dados, ou seja, serão registradas novas informações no Histórico |
Histórico de Dados DESABILITADO para o Dispositivo: X |
Indica que o Histórico de Dados do Dispositivo X, onde X é o nome do Dispositivo, não está apto a receber registros devido a condição configurada no mesmo para tal estar falsa |
Avaliar a configuração da condição do Dado ativador de histórico. Ex: Caso seu valor seja “falso”, desabilita o registro no Histórico de Dados, ou seja, não serão registradas novas informações no Histórico |
Leitura de registros da base local coleta
Mensagem do Evento |
Significado |
Sugestões |
|---|---|---|
ID do dado inválido(não existe cadastro para o Dado com este ID) em X de Y registros. (ids: [1, 2… ]) |
ID do dado na base local de coleta não está cadastrado no portal de Telemetria |
Cadastrar o dado para o ID indicado ou alterar o programa do controlador para não gerar eventos com esse ID |
Formato de data/hora inválido em X de Y registros. (ids: [1, 2… ]) |
Data/hora de registro do dado na base local de coleta possui um conteúdo inválido (ex.: minutos =100, segundos=70, horas=30) |
Um cenário que pode causar este erro é quando o equipamento gera o buffer em um formato e no cadastro do dispositivo é definido uma versão diferente |
Data/hora inválida informada no registro em X de Y registros. (ids: [1, 2… ]) |
Data/hora de registro do dado na base local de coleta possui um conteúdo inválido (ex.: minutos =100, segundos=70, horas=30) |
Um cenário que pode causar este erro é quando o equipamento gera o buffer em um formato e no cadastro do dispositivo é definido uma versão diferente |
Data/hora do Dado igual a data/hora do último registro em X de Y registros. (ids: [1, 2… ]) |
Data/hora associada ao dado na base local de coleta, é igual a data/hora da última aquisição para o dado. Neste caso, o portal descarta essa aquisição |
Corrigir o programa do controlador que possivelmente deve estar gerando registros com a mesma data/hora |
Data/hora muito antiga em X de Y registros. (ids: [1, 2… ]) |
Data/hora de registro do dado na base local de coleta é inferior a 01/04/2018 (Data de liberação do recurso de base local do Portal de Telemetria) |
Avaliar se o programa do controlador está gerando os registros com data/hora incorreta(por algum detalhe na lógica ou no relógio/calendário do controlador) |
Data/hora adiantada (em relação a data/hora do servidor em X de Y registros. (ids: [1, 2… ]) |
Data/hora de registro do dado na base local de coleta é superior a um minuto em relação a data/hora do servidor do sistema de coleta. |
Avaliar se o programa do controlador está gerando os registros com data/hora incorreta(por algum detalhe na lógica ou no relógio/calendário do controlador) |
Data/hora atrasada (anterior ao último valor registrado) em X de Y registros. (ids: [1, 2… ]) |
Data/hora de registro do dado na base local de coleta é anterior data/hora do último registrado coletado para o dado |
Avaliar se o programa do controlador está gerando os registros com data/hora incorreta(por algum detalhe na lógica ou no relógio/calendário do controlador) |
Valor do dado não é numérico em X de Y registros. (ids: [1, 2… ]) |
Portal identificou um erro na conversão do valor do dado presente na base local de coleta para o formato configurado para o dado(NaN para valores reais por exemplo) |
Avaliar se o tipo de memória configurado para o dado no Portal está correto de fato e caso sim, avaliar no programa de aplicação do controlador como o valor está sendo inserido na base |
Erro na execução do cálculo em X de Y registros. (ids: [1, 2… ]) |
Portal identificou um erro no cálculo configurado para o(s) dado(s) |
Avaliar os parâmetros de cálculo configurados para o dado ou entrar em contato com o time de suporte técnico da HI Tecnologia. |
Falha na verificação de alarmes em X de Y registros. (ids: [1, 2… ]) |
Houve uma falha genérica no tratamento de verificação de alarmes associados a dados da base local de coleta no conector |
Entrar em contato com o time de suporte técnico da HI Tecnologia |
Erro indefinido em X de Y registros. (ids: [”—“]) |
Ocorreu um erro que não pode ser identificado (ou Portal de Telemetria não possui um tratamento para o erro). |
Entrar em contato com o time de suporte técnico da HI Tecnologia |
Valor lido para o dado(V) é inferior ao valor mínimo permitido(M) em X de Y registros. (ids: [1, 2… ]) |
Valor lido para o Dado é menor que o valor mínimo permitido(conforme configurado no dado), onde V é o valor lido e M é o valor mínimo configurado |
Reconfigurar o valor de limite mínimo para leitura do dado no Portal ou avaliar no programa do controlador o motivo do valor estar fora do esperado |
Valor lido para o dado(V) é superior ao valor máximo permitido(M) em X de Y registros. (ids: [1, 2… ]) |
Valor lido para o Dado é maior que o valor máximo permitido(conforme configurado no dado), onde V é o valor lido e M é o valor máximo configurado |
Reconfigurar o valor de limite máximo para leitura do dado no Portal ou avaliar no programa do controlador o motivo do valor estar fora do esperado |
Falha ao processar registros da base local |
Portal de Telemetria identificou uma falha genérica no tratamento de leitura da base local de coleta do conector |
Entrar em contato com o time de suporte técnico da HI Tecnologia. |
Erro na leitura do buffer de coleta local. Código de retorno do protocolo: X |
Houve uma falha retornada pelo protocolo de comunicação(MODBUS/SCPHI) no comando de leitura da base local de coleta. X representa o código de erro retornado pelo protocolo |
Avaliar se o controlador remoto permite a leitura dos endereços configurados para a base local. Avaliar também cenários de instabilidade na conexão |
Tamanho (X) em bytes da String informada no registro é maior que o tamanho (Y) configurado para o Dado |
A string informada no do dado na base local de coleta possui um tamanho(número de caracteres) maior que o informado no cadastro deste Dado no Portal |
Ajustar o tamanho do Dado associado a string no Portal para que fique compatível com a string que está sendo inserida na base de coleta local pelo programa de aplicação do CLP |
Tamanho do Vetor “X” informado no registro diferente do tamanho configurado para o Dado (Y) |
O tamanho do Vetor informado no dado na base local de coleta possui um tamanho(número de elementos) diferente do tamanho informado no cadastro deste Dado no Portal |
Ajustar o tamanho do Dado associado ao vetor no Portal para que fique compatível com o vetor que está sendo inserido na base de coleta local pelo programa de aplicação do CLP |
Tipo de memória do Dado (X) é incompatível com Tipo IEC (Y) da variável utilizada no registro |
O Tipo de Memória configurado para Dado, por exemplo, Holding Register é incompatível com o tipo da variável, por exemplo, BOOL, utilizada para gerar o registro |
Ajustar a configuração do Tipo de Memória do Dado em seu cadastro no Portal ou verificar se a variável correta está sendo utilizada no registro para o ID deste Dado no programa de aplicação |