Histórico de Eventos do Sistema
O Portal de Telemetria disponibiliza um histórico associado a eventos registrados pela própria plataforma em alguns cenários pertinentes.
São exemplos desses eventos a conexão/desconexão de Conectores, eventos associados a cadastro/atualização/remoção de recursos, erros de aquisição ou escrita em Dados, etc.
Ao acessar a página de histórico de eventos do sistema(através do botão “” no menu lateral esquerdo) é apresentada uma tabela com as seguintes informações:
Indentificador |
Descrição |
|---|---|
Data e hora |
Data e hora em que ocorreu o evento |
Mensagem |
Mensagem do evento |
Evento |
Identificação do evento |
Sub-evento |
Identificação do subevento |
Detalhe |
Eventuais detalhes do evento |
Conector |
Conector associado ao evento, se existir |
Dado |
Dado relacionado ao sistema, se existir |
Usuário |
Usuário associado ao evento, se existir |
Filtros
Na página de histórico de eventos do sistema, são disponibilizados alguns filtros para facilitar a busca por informações. Os filtros são os seguintes:
Intervalo: permite filtrar os eventos por um determinado período:
Hoje: filtra pelos registros entre às 00:00(meia-noite) do dia atual até o horário corrente;
Ontem: filtra pelos registros entre às 00:00(meia-noite) e ás 23:59 do dia anterior;
Últimas 24 horas: filtra pelos registros das últimas 24 horas em relação ao horário corrente(filtro default do histórico);
Últimos 7 dias: filtra pelos registros dos últimos 7 dias(uma semana) em relação a data/hora corrente;
Este mês: filtra pelos registros entre às 00:00(meia-noite) do primeiro dia do mês atual até o horário corrente;
Customizar: permite selecionar um período(data/hora inicial e final) para o filtro(limitado a 7 dias).
Conector: permite filtrar eventos associados a um determinado Conector;
Dado: permite filtrar eventos associados a um determinado dado do Conector selecionado;
Evento: permite filtrar por eventos por um determinado tipo;
Pesquisar: permite filtrar eventos que contenham um determinado texto;
Atenção
Para utilizar o filtro de Intervalo e a opção de Customizar, será necessário especificar um período(data/hora inicial e final).
Atualmente, são aplicadas a seguintes limitações na seleção de um período:
Período Máximo(diferença entre a data/hora inicial e final): Até 7 dias.
Data mais antiga: até 365 dias em relação a data atual(na qual representa a retenção máxima padrão de registros do Portal).
Esta interface disponibiliza os seguintes opções de filtros para auxiliar no processo de busca de histórico de Eventos de Sistema:
Também há a opção de download de um arquivo(CSV ou XLSX) dos resultados através do ícone .
Atenção
Atualmente, o período máximo por consulta no histórico de eventos de sistema é de 7 dias.
Gráfico de Conexões
Caso no intervalo consultado/filtrado contiver algum evento de conexão e/ou desconexão de Conectores, será apresentado um botão com o ícone ao lado das opções de filtro para que se possa visualizar esses eventos de maneira gráfica.
Inclusive, é possível apresentar esses eventos para mais de um Conector, sendo útil para comparar o estado de conexão entre eles.
Visualização
A visualização do gráfico de conexões pode ser ativada ou desativada, clicando no botão com o ícone :
Ativada: o botão é apresentado na cor azul;
Desativada: o botão é apresentado na cor cinza.
Caso ativada a visualização dos eventos de conexão na forma de gráfico, é apresentada uma série(linha) para cada Conector no formato de uma onda quadrada, onde o nível baixo indica o evento de offline(desconectado) e o nível alto indica o evento de Online(conforme indicado na legenda do gráfico).
Atenção
É crucial notar que os períodos de conexão/desconexão exibidos no gráfico são determinados pelo período de filtragem das informações. Portanto, os eventos mostrados no início do gráfico podem não refletir precisamente o momento em que a conexão ou desconexão começou, pois isso pode ter ocorrido antes do período filtrado.
Da mesma forma, os eventos exibidos no final do gráfico podem não indicar precisamente quando a conexão ou desconexão terminou, já que isso pode ter ocorrido após o período filtrado.
Eventos de sistema
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 |
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 |