IonPulse Agent
O IonPulse Agent conecta o ACCELERO à plataforma IonPulse, retransmitindo (relay) em tempo real os eventos de acesso, alarmes (ocorrências) e reports periódicos de operação para um ou mais destinos externos. A comunicação é feita por MQTT, e cada instalação do ACCELERO pode publicar para vários endpoints ao mesmo tempo.
Além do envio de dados, o plugin disponibiliza um fluxo de login remoto — que permite à plataforma IonPulse abrir uma sessão temporária no ACCELERO com um perfil pré-definido — e a entrega de fotos pré-assinadas das pessoas associadas aos eventos.
Esta integração é disponibilizada como plugin (ionpulseagent — IonPulse Agent) e precisa ser instalada e habilitada pela equipe técnica da IONGRADE. Consulte o suporte para verificar compatibilidade com a sua versão do ACCELERO.
Versão atual do plugin: 0.0.9.
O manifest.json do plugin declara compatibility como lista vazia, ou seja, não há versão mínima do ACCELERO fixada no código. Confirme com a IONGRADE a faixa de versões suportada antes de publicar.
:::
O que o plugin faz
Com o IonPulse Agent ativo, o ACCELERO passa a publicar seus eventos para a plataforma IonPulse conforme o que cada endpoint estiver configurado para receber.
| Funcionalidade | O que acontece no ACCELERO |
|---|---|
| Eventos de acesso | Cada log de evento (logevento) é capturado e publicado para os endpoints que assinam o tipo Eventos de acesso |
| Alarmes | Ocorrências criadas, reconhecidas, tratadas e normalizadas são publicadas como alarmes para os endpoints que assinam Alarmes |
| Reports periódicos | A cada hora, o plugin publica um resumo operacional (status geral, licença, acessos do último dia e ocupação por área) para os endpoints que assinam Reports periódicos |
| Login remoto | A plataforma IonPulse pode solicitar uma URL de auto-login que abre uma sessão temporária no ACCELERO com um perfil pré-definido (Administradores ou Usuários) |
| Fotos pré-assinadas | Junto aos eventos de acesso, a foto da pessoa é entregue por uma URL pré-assinada com validade restrita |
Centraliza na plataforma IonPulse a visão consolidada de acessos, alarmes e saúde operacional de uma ou várias instalações ACCELERO, sem que a plataforma precise consultar diretamente o banco de cada site.
O plugin publica dados do ACCELERO para fora (MQTT) e expõe endpoints HTTP que a plataforma IonPulse consome (login remoto e fotos). O ACCELERO é a origem dos dados.
Configuração
Caminho de acesso: Configurações > IonPulse
A tela possui duas abas: Endpoints e Operadores.
Tela Configurações > IonPulse mostrando as abas Endpoints e Operadores.
Aba Endpoints
Lista e gerencia os destinos para os quais o ACCELERO publica seus eventos.
Aba Endpoints com a tabela de endpoints cadastrados (colunas ID, Eventos compartilhados, Ações) e o formulário Novo endpoint com o campo String de configuração.
Cadastrar um endpoint: clique em Novo endpoint e informe a String de configuração — um texto fornecido pela plataforma IonPulse que já traz, codificados, os dados de conexão MQTT (host, porta, usuário, senha e tópico) e a identificação do site (ID e nome). Clique em Adicionar para salvar.
| Coluna da tabela | Conteúdo |
|---|---|
| ID | Identificador do site/endpoint, extraído da string de configuração |
| Eventos compartilhados | Multi-seleção dos tipos de evento que este endpoint recebe: Eventos de acesso, Alarmes e Reports periódicos |
| Ações | Botão Salvar (persiste a seleção de eventos do endpoint) |
Para excluir endpoints, marque as linhas desejadas e use Mais ações > Excluir.
A string é validada no momento do cadastro: ela precisa conter os dados MQTT (host, port, username, password, topic) e a identificação do site (id). Strings incompletas são recusadas com a mensagem "String de configuração inválida!".
Cada endpoint só recebe os tipos marcados em Eventos compartilhados. Um endpoint sem nenhum tipo marcado não recebe dados, mesmo estando cadastrado.
Aba Operadores
Define quais perfis serão atribuídos às sessões abertas pelo fluxo de login remoto (ver Login remoto).
Aba Operadores com o título "Perfis a atribuir durante login remoto" e os campos Administradores e Usuários.
| Campo | Descrição |
|---|---|
| Administradores | Perfil do ACCELERO atribuído quando a plataforma solicita um login remoto com nível admin |
| Usuários | Perfil do ACCELERO atribuído quando a plataforma solicita um login remoto com nível user |
Clique em Salvar para persistir os perfis.
Se o perfil correspondente não estiver configurado, a solicitação de login remoto é rejeitada. Configure os dois perfis antes de habilitar o login remoto na plataforma IonPulse.
Reports periódicos
A cada hora, o plugin monta um resumo operacional e o publica para os endpoints que assinam Reports periódicos. O conteúdo considera uma janela retroativa de 1 dia para os dados de acesso.
| Bloco | Conteúdo |
|---|---|
| Geral | Status geral dos jobs/processos do ACCELERO |
| Licença | Informações da licença do ACCELERO |
| Acessos | Contagem de eventos de acesso por tipo de evento no último dia |
| Ocupação | Quantidade de pessoas por área, separando visitantes de não visitantes |
Os reports periódicos não têm campos próprios na tela de configuração — basta marcar Reports periódicos em Eventos compartilhados no endpoint desejado.
Alarmes (ocorrências)
Quando uma ocorrência muda de estado, o plugin publica um alarme para os endpoints que assinam Alarmes. Os estados acompanhados são:
| Estado da ocorrência | Tipo reportado | Status do alarme |
|---|---|---|
| Criada | criada | created |
| Reconhecida | reconhecida | updated |
| Tratada | tratada | updated |
| Normalizada | normalizada | resolved |
Cada alarme carrega um identificador (ocorrencia-<ID da ocorrência>), um título (descrição do tipo de ocorrência + estado) e uma mensagem com o detalhe mais relevante conforme o tipo da ocorrência (controlador, gateway, operador, região, dispositivo de elevador, etc.).
Tipos como controlador offline, gateway offline, coação, falha de chamada de elevador, login com senha incorreta e ocorrências de Synapsis (permanência, alarme, redzone) têm a mensagem ajustada para destacar o item mais relevante. Demais tipos enviam os dados completos da ocorrência.
Eventos de acesso e fotos pré-assinadas
Os eventos de acesso (logeventos) são capturados e publicados para os endpoints que assinam Eventos de acesso.
Quando o evento traz a foto da pessoa, o plugin substitui o caminho interno da imagem por uma URL pré-assinada, válida apenas para aquela combinação de foto e chave temporária. Assim, a plataforma IonPulse consegue exibir a foto sem ter acesso direto ao armazenamento de imagens do ACCELERO.
Se a foto não existir no armazenamento, a URL pré-assinada retorna uma imagem padrão de "sem foto".
Login remoto
O login remoto permite que a plataforma IonPulse abra uma sessão temporária no ACCELERO — por exemplo, para um operador acessar o painel de um site específico a partir da plataforma central.
Como funciona
- A plataforma IonPulse solicita um login remoto informando o nível desejado (
adminouuser) e a origem (o endpoint), autenticando com o token do endpoint. - O ACCELERO cria um usuário temporário oculto e o vincula ao perfil configurado na aba Operadores para aquele nível.
- O ACCELERO devolve uma URL de auto-login de uso único e com validade curta.
- Ao abrir essa URL, o operador entra autenticado no ACCELERO e é redirecionado para a tela inicial.
Os usuários criados pelo login remoto são marcados como temporários/ocultos e são removidos automaticamente quando o ACCELERO faz a limpeza de usuários descartados — não poluem o cadastro de operadores.
O login remoto só funciona se os perfis Administradores e Usuários estiverem definidos na aba Operadores e se o endpoint tiver um token válido configurado (parte da string de configuração da plataforma IonPulse).
Casos de uso
Habilitar o relay de eventos para a plataforma IonPulse
- Solicite à IONGRADE a instalação do plugin
ionpulseagent. - Na plataforma IonPulse, gere a string de configuração do site.
- Em
Configurações > IonPulse > Endpoints, clique em Novo endpoint e cole a string. - Marque em Eventos compartilhados quais tipos o endpoint deve receber (Eventos de acesso, Alarmes, Reports periódicos) e clique em Salvar.
- Acompanhe na plataforma IonPulse a chegada dos primeiros eventos.
Habilitar o login remoto a partir da plataforma
- Em
Configurações > IonPulse > Operadores, selecione os perfis Administradores e Usuários. - Clique em Salvar.
- Na plataforma IonPulse, acione o login remoto do site — a sessão temporária é aberta com o perfil correspondente.
Encaminhar alarmes para monitoramento central
- Cadastre o endpoint do centro de monitoramento.
- Marque apenas Alarmes em Eventos compartilhados.
- As ocorrências do ACCELERO passam a aparecer como alarmes na plataforma IonPulse conforme mudam de estado.
Boas práticas
- Marque só o necessário: habilite em cada endpoint apenas os tipos de evento que a plataforma realmente consome, evitando tráfego desnecessário.
- Perfis dedicados para login remoto: crie perfis específicos (ex: "IonPulse Admin", "IonPulse Operador") em vez de reaproveitar perfis nominais, para deixar claro o que cada sessão remota pode fazer.
- Token sob controle: a string de configuração contém credenciais MQTT e o token de login remoto — trate-a como dado sensível.
- Vários endpoints: use múltiplos endpoints quando precisar enviar os mesmos eventos para destinos diferentes (ex: plataforma principal + centro de monitoramento).
Troubleshooting
A plataforma não recebe eventos
Possíveis causas:
- Endpoint cadastrado sem nenhum tipo marcado em Eventos compartilhados.
- String de configuração com dados MQTT incorretos (host, porta, usuário, senha ou tópico).
- Serviços de background do plugin não reiniciados após a alteração.
Solução:
- Em
Configurações > IonPulse > Endpoints, confirme os tipos marcados no endpoint. - Revalide a string de configuração junto à plataforma IonPulse.
- Se persistir, contate o suporte IONGRADE para verificar os processos de relay.
O login remoto é rejeitado
Possíveis causas:
- Perfil Administradores ou Usuários não configurado na aba Operadores.
- Token do endpoint inválido ou divergente do esperado pela plataforma.
Solução:
- Defina os dois perfis na aba Operadores e salve.
- Confirme com a IONGRADE/plataforma IonPulse o token associado ao endpoint.
Fotos não aparecem na plataforma
Possíveis causas:
- A pessoa do evento não tem foto cadastrada (retorna imagem padrão de "sem foto").
- A URL pré-assinada expirou antes de ser consumida.
Solução:
- Verifique se a pessoa tem foto no cadastro.
- Garanta que a plataforma consome a URL logo após receber o evento.
Integração com outros módulos
Ocorrências
Os alarmes publicados derivam diretamente das ocorrências do ACCELERO — criação, reconhecimento, tratamento e normalização disparam o envio.
Logs e Eventos
O relay de Eventos de acesso depende dos logs e eventos gerados pelas passagens nos controladores.
Operadores e Perfis
O login remoto cria sessões temporárias vinculadas a perfis; os operadores temporários são removidos automaticamente após o uso.
Próximos Passos
- Painel de Ocorrências — Entenda as ocorrências que viram alarmes
- Logs e Monitoramento — Veja quais eventos de acesso são publicados
- Perfis — Configure os perfis usados no login remoto
- Operadores — Entenda como as sessões temporárias se relacionam aos operadores
- Plugins — Saiba mais sobre o sistema de plugins do ACCELERO