Todos los eventos que ocurren en la pasarela, tanto durante el proceso de creación de la misma como durante su funcionamiento, son guardados para poder verificar que toda la plataforma funciona correctamente.
Si ocurre algún problema en la pasarela, estos eventos te ayudarán a determinar el origen del mismo y te darán las claves para solucionar la incidencia.
Eventos de pasarela:
CREATING
Es el primer evento que se genera en una pasarela y marca el inicio del proceso de creación de la misma. Sólo aparece una vez y no vuelve a repetirse durante toda la vida de la pasarela.
En condiciones normales estará activo durante unos pocos segundos, ya que el proceso de creación de la infraestructura de la pasarela en la nube comienza inmediatamente después.
GATEWAY_CLOUD_INFRASTRUCTURE_FAILED
Se genera si uno de los componentes del proceso de creación de la infraestructura de nube falla debido a un error interno en la plataforma.
Es un evento que aparece muy rara vez y en la mayoría de los casos requiere la eliminación de la pasarela para proceder a crearla de nuevo.
Si se produce este evento es, recomendable contactar con nuestro servicio de soporte, escribiendo un email a neuron@plexo.cloud.
GATEWAY_CLOUD_INFRASTRUCTURE_PROGRESSED
Este evento sólo se genera durante el proceso de creación de la pasarela.
Informa acerca de la evolución del proceso de configuración de la infraestructura en la nube, indicando que se encuentra en un estado de progreso hasta su finalización.
Es un evento que se repetirá en varias ocasiones durante el proceso de creación y que se ejecutará aproximadamente 2 minutos en total.
GATEWAY_CLOUD_INFRASTRUCTURE_STARTED
Este evento sucede durante las fases iniciales del proceso de creación e indica que se han empezado a crear y configurar los componentes que forman la estructura de la plataforma de la pasarela en la nube.
Este evento sólo aparecerá una vez durante el proceso de creación de la pasarela y el comportamiento esperado es que inmediatamente después aparezca el evento GATEWAY_CLOUD_INFRASTRUCTURE_PROGRESSED que nos indica que el proceso evoluciona con normalidad.
GATEWAY_CLOUD_INFRASTRUCTURE_SUCCEEDED
Confirma la creación completa y correcta de todos los componentes que forman la plataforma de la pasarela en la nube.
Este evento aparecerá sólo una vez durante el proceso de creación de la pasarela y siempre en las etapas iniciales del mismo.
GATEWAY_CONNECTION_STATUS_CHANGED
Este evento indica que se ha producido un cambio en el estado de conectividad de la pasarela, lo que puede afectar al proceso de recepción de información desde los sensores. Los valores que puede tomar son:
Estado | Descripción |
OFFLINE
| La pasarela ha perdido la conectividad:
|
ONLINE
| La pasarela tiene conectividad:
|
GATEWAY_CREATION_FAILED
Se genera cuando no se ha podido completar con éxito el proceso completo de creación de pasarela debido a algún fallo interno en alguno de los componentes de la misma.
Es un evento que aparecerá muy rara vez y en la mayoría de los casos implica la eliminación de la pasarela para volver a crearla de nuevo.
Si se produce este evento es, recomendable contactar con nuestro servicio de soporte, escribiendo un email a neuron@plexo.cloud.
GATEWAY_CREATION_STARTED
Indica el comienzo de la disponibilidad del software que contiene la lógica que gestionará la creación de la pasarela.
Se genera inmediatamente después del evento CREATING y su tiempo de vida es de muy pocos segundos, ya que precede al inicio de la creación de la infraestructura en la nube que incluirá los componentes de la pasarela.
GATEWAY_CREATION_SUCCEEDED
Señala la finalización correcta y completa de toda la infraestructura de la pasarela, tanto en la nube como en la parte local de la instalación.
También nos indica que se ha completado con éxito el proceso de validación y registro de la licencia de la pasarela, así como la instalación de Neuron Edge en nuestra CPU industrial.
Si teníamos instalados correctamente nuestros dispositivos, también se habrá completado el proceso de búsqueda y descubrimiento de los módulos, sensores y actuadores, por lo que deberíamos verlos en la pestaña "Resumen" en la sección Equipamiento de Neuron App.
GATEWAY_CREATION_UNREGISTERED
Nos indica que la infraestructura de la pasarela se ha creado correctamente, pero todavía no se ha completado el proceso de registro de la licencia.
El registro de la licencia se realiza durante el proceso de instalación de Neuron Edge en una CPU industrial y consiste en introducir el código que encontrarás en el paso 2 del proceso de instalación de una nueva pasarela.
Una vez introducido, Neuron Edge valida si el código es correcto y, en caso afirmativo, continúa con el proceso de instalación de la pasarela en la infraestructura local y con el descubrimiento de los dispositivos.
GATEWAY_DELETION_FAILED
Indica que el proceso de eliminación de una pasarela ha fallado. Podemos volver a intentar el proceso de eliminación, pero si el problema persiste, debemos contactar con el servicio de soporte enviando un email a neuron@plexo.cloud.
GATEWAY_DELETION_STARTED
Indica que ha comenzado el proceso de borrado de una pasarela. Este proceso significa que se borrará el código de registro (licencia) de la pasarela y se eliminará toda la infraestructura de la nube.
GATEWAY_DELETION_SUCCEEDED
Confirma la eliminación completa de la pasarela, así como de toda la infraestructura correspondiente en la nube. Esta operación no se puede deshacer y la eliminación es permanente.
GATEWAY_DEPLOYMENT_BUILD_STARTED
Indica que se ha creado la correspondiente infraestructura de la pasarela en la nube y se está iniciando el proceso de despliegue de la misma.
El proceso de despliegue consiste en la copia, de la nube a la instalación local, de los componentes de software que se van a ejecutar en la CPU industrial.
GATEWAY_DEPLOYMENT_PROGRESSED
Indica que el proceso de despliegue de los componentes software de la pasarela alojados en la nube se está realizando correctamente.
GATEWAY_DEPLOYMENT_SUCCEEDED
Marca la finalización correcta del proceso de despliegue de los componentes del software de la pasarela en la CPU industrial.
GATEWAY_DEPLOYMENT_FAILED
Este evento es mensaje de error en caso de producirse un fallo en el proceso de despliegue de alguno de los componentes software de la pasarela.
Para solucionarlo es posible realizar el despliegue de nuevo. Si el error persistiera, tendríamos que eliminar la pasarela y comenzar el proceso de creación de nuevo.
GATEWAY_DEVICE_CONNECTED
Este evento se produce cada vez que conectamos un nuevo dispositivo a un IO-Link Master instalado en nuestra red.
Una vez conectado el dispositivo, el sistema reconocerá automáticamente el modelo y características del mismo y aparecerá, también de forma automática, como conectado en el puerto correspondiente.
Podemos consultar e interactuar con el nuevo dispositivo desde el listado de equipos y desde los dispositivos que aparecen vinculados a nuestra pasarela.
GATEWAY_DEVICE_DISCONNECTED
Se produce cada vez que desconectamos un dispositivo de un IO-Link Master o bien cuando el dispositivo tiene algún problema de funcionamiento y no podemos acceder o comunicar con él.
Primero debemos comprobar que el cable que conecta el dispositivo con el IO-Link Master está en buen estado, sin cortes ni daños y que se encuentra correctamente conectado en el puerto correspondiente.
Si persiste el problema, podemos probar a conectar el mismo dispositivo utilizando otro cable o bien conectándolo en otro puerto libre del IO-Link Master. En ambos casos el sistema lo reconocerá de forma automática y lo mostrará.
GATEWAY_DEVICE_READING_FREQUENCY_CHANGED
Muestra el cambio en la frecuencia de lectura de algún sensor. Es un evento que siempre aparece como respuesta a un cambio realizado por un usuario en la frecuencia de lectura de un dispositivo.
El evento queda reflejado a modo de auditoría para dejar constancia del cambio intencionado, además muestra el identificador del sensor en el que se ha realizado el cambio y la nueva frecuencia establecida.
GATEWAY_DEVICES_ADDED
Nos informa de la correcta instalación de los dispositivos (sensores y actuadores) realizada tras el descubrimiento automático de los mismos.
Este evento nos garantiza la disponibilidad de los dispositivos para iniciar el proceso de monitorización de los mismos.
Uno de los atributos del evento nos muestra la colección completa de los dispositivos añadidos, identificados por sus modelos y números de serie.
GATEWAY_DEVICES_DELETED
Este evento se dispara cuando se elimina definitivamente un un módulo o un sensor de la plataforma.
Aunque eliminemos el dispositivo, los datos almacenados en los activos y asociados con él, permanecen disponibles para ser consultados.
GATEWAY_DEVICES_DISCOVERED
Avisa del descubrimiento de nuevos dispositivos dentro de la red de área local donde se encuentra nuestra CPU industrial.
Todos los dispositivos descubiertos (sensores y actuadores) son automáticamente añadidos a la colección de dispositivos disponibles para ser añadidos a la pasarela.
GATEWAY_DISCOVERY_FAILED
Se dispara cuando se produce un error durante el proceso de descubrimiento de dispositivos en la red de área local donde se encuentra nuestra CPU industrial.
Ante esta situación, verifica que al menos un módulo ha sido instalado, que tiene alimentación y conexión a internet. Si todo es correcto, vuelve a lanzar el proceso de descubrimiento de dispositivos de forma manual en la red de área local.
Si aún así, Neuron App no mostrara ningún dispositivo descubierto, comprueba que los servidores de red donde busca Neuron pertenecen a tu red y que tus IO-Link Masters son accesibles desde esa misma red.
Si no aparecen dispositivos o no son los correctos, ponte en contacto con nuestro servicio de soporte enviando un email a neuron@plexo.cloud.
GATEWAY_DISCOVERY_STARTED
Indica que se ha iniciado el proceso automático de descubrimiento de dispositivos en la red de área local donde se encuentra instalada la CPU industrial.
Asegúrate de que los módulos se encuentran conectados a la misma red de área local que la CPU industrial, de no ser así el proceso no podrá encontrar ningún dispositivo.
GATEWAY_DISCOVERY_SUCCEEDED
Indica la finalización del proceso de descubrimiento automático de dispositivos en una red de área local.
Si los dispositivos han sido instalados correctamente, el proceso los reconocerá automáticamente y continuará añadiendo los dispositivos descubiertos a la pasarela.
GATEWAY_EDGE_INFRASTRUCTURE_FAILED
Se genera si alguno de los componentes del software de Neuron Edge del proceso de creación de la infraestructura falla debido a un error interno en la plataforma.
Es un evento que aparecerá muy rara vez y en la mayoría de los casos implica la eliminación de la pasarela para volver a crearla de nuevo.
Si se produce este evento, nuestra recomendación es contactar con nuestro servicio de soporte, escribiendo un email a neuron@plexo.cloud.
GATEWAY_EDGE_INFRASTRUCTURE_PROGRESSED
Este evento solo se genera durante el proceso de creación de la pasarela e informa sobre de la evolución del proceso de creación del software de Neuron Edge, indicando que se encuentra en un estado de progreso hasta su finalización.
Es un evento que se repetirá en varias ocasiones durante el proceso de creación, siendo ese espacio de tiempo de su aparición de aproximadamente 2 minutos en total.
GATEWAY_EDGE_INFRASTRUCTURE_STARTED
Este evento aparece en las fases iniciales del proceso de creación e indica que se han empezado a crear y configurar los componentes software de Neuron Edge.
Sólo aparecerá una vez durante el proceso de creación de la pasarela y el comportamiento esperado es que inmediatamente después se muestre el evento GATEWAY_EDGE_INFRASTRUCTURE_PROGRESSED que nos indica que el proceso evoluciona con normalidad.
GATEWAY_EDGE_INFRASTRUCTURE_SUCCEEDED
Confirma la creación completa y correcta de todos los componentes software de Neuron Edge.
Este evento aparecerá sólo una vez durante el proceso de creación de la pasarela y siempre en las etapas iniciales del mismo.
GATEWAY_HOSTS_DISCOVERY_PROGRESSED
Este evento indica que el proceso de búsqueda de servidores para comprobar si hay módulos de comunicación ( IO-Link Masters ) en la red de área local progresa correctamente.
Es un proceso que puede tardar varios minutos dependiendo del número de servidores de nuestra red de área local.
En el listado de eventos de Neuron App aparecerán varios eventos de este tipo con información sobre el progreso, irán desde el 10% hasta mostrar que ha sido completado al 100%.
GATEWAY_HOSTS_DISCOVERY_STARTED
Señala el inicio del proceso de búsqueda de servidores para comprobar si hay módulos de comunicación ( IO-Link Masters ) en la red de área local.
El evento de descubrimiento automático de servidores aparece una única vez de forma automática y siempre que el usuario inicie un proceso de búsqueda manual.
GATEWAY_HOSTS_DISCOVERY_SUCCEEDED
Indica la finalización correcta del proceso de descubrimiento automático de módulos de comunicación (IO-Link Masters) en la red de área local.
A partir de este momento, el sistema establece comunicación con los módulos y comienza a descubrir los sensores y actuadores que hay conectados.
GATEWAY_LICENSE_REGISTRATION_FAILED
Este evento representa que el proceso de validación de la licencia de la pasarela ha fallado.
Para solucionar el error, comprueba no haber instalado el software de la pasarela en otro equipo y que has introducido correctamente el código de registro de la nueva pasarela en el asistente de instalación de Neuron Edge.
GATEWAY_LICENSE_REGISTRATION_STARTED
Indica el comienzo del registro de la licencia de la pasarela en la infraestructura de la nube para así poder iniciar el proceso de descubrimiento.
GATEWAY_LICENSE_REGISTRATION_SUCCEEDED
Este evento informa de la finalización correcta del proceso de registro de la pasarela.
Tras este evento, el sistema iniciaría el descubrimiento automático de módulos y dispositivos de la nueva pasarela.
GATEWAY_LICENSE_VALIDATION_FAILED
Este evento indica que la licencia que hemos introducido en el software de instalación de Neuron Edge no es correcta.
Por favor, comprueba que has copiado correctamente el código de registro de tu pasarela e intenta pegarlo utilizando las teclas Ctrl+V o bien Cmd+V.
GATEWAY_LICENSE_VALIDATION_SUCCEEDED
Nos indica que la licencia que has introducido en el código de registro es correcta y el sistema puede continuar con el proceso de instalación y descubrimiento.
GATEWAY_LICENSE_UNREGISTRATION_FAILED
No se ha podido completar el proceso de liberación de la licencia de la pasarela por lo que el sistema continúa funcionando con normalidad. Podemos volver a intentar la operación en unos minutos.
GATEWAY_LICENSE_UNREGISTRATION_STARTED
Indica que ha comenzado el proceso de liberación de la licencia de la pasarela. Este proceso permite reutilizar la licencia de la pasarela para volver a instalar Neuron Edge en el mismo equipo o en otro equipo diferente si lo que queremos es mover la pasarela a otra CPU diferente a la original.
GATEWAY_LICENSE_UNREGISTRATION_SUCCEEDED
Se ha liberado completamente la licencia de la pasarela. A partir de este momento, la pasarela deja de ingresar datos y podemos volver a utilizar el código de registro de la misma para instalar de nuevo el software de Neuron Edge en el mismo o en otro equipo.
Al liberar la licencia de la pasarela, no se elimina su infraestructura en la nube, por lo que mantenemos todos los datos históricos y de configuración de la misma.
GATEWAY_MAX_INGESTION_RATE_EXCEEDED
Este evento se dispara cuando en una pasarela LoRaWAN o MQTT establecemos la frecuencia de lectura de los sensores en la instalación física a un ratio que es superior a la frecuencia que tenemos contratada en Neuron para dichos sensores.
Ejemplo: Nuestra instalación física tiene dos sensores de temperatura que escriben sus datos en una pasarela a una frecuencia de 1 lectura cada 10 segundos para cada sensor. Si configuramos los sensores en Neuron con una frecuencia de 1 lectura cada minuto, estamos subiendo datos a una velocidad superior a la que hemos contratado, por lo que Neuron dispara este evento para avisarnos de que estamos superando el límite que hemos contratado. Si no subimos ese límite (estableciendo frecuencia de minuto para los sensores), el sistema se pondrá en modo "RESTRINGIDO" de forma que no se leerán los datos de los sensores hasta que ajustemos la frecuencia correcta de lectura en nuestra instalación física o seleccionemos la frecuencia correcta en Neuron.
GATEWAY_MODULE_POLLING_TIMEOUT
Este evento se dispara cuando una pasarela tiene una conexión defectuosa con uno de los módulos conectados a ella. Debes verificar la conectividad física entre tu pasarela y el módulo al que no se puede conectar.
Si la conexión física funciona correctamente, debes verificar que el software Neuron Edge está arrancado y que la imagen de Docker está levantada. Si todo es correcto, pero el problema de conectividad persiste, para la imagen de Docker de Neuron Edge y vuelve a iniciarla. Esta operación debería reiniciar toda la configuración de Neuron Edge y volver a establecer la comunicación con el módulo.
GATEWAY_MODULES_ADDED
Este evento confirma que se han podido añadir correctamente los módulos de comunicación ( IO-Link Masters ) a nuestra pasarela, por lo que el sistema puede iniciar automáticamente el descubrimiento de dispositivos.
GATEWAY_MODULES_DISCOVERED
Este evento nos avisa del descubrimiento de nuevos módulos de comunicaciones (IO-Link Masters) dentro de la red de área local donde se encuentra nuestra CPU industrial.
Todos los módulos descubiertos son automáticamente añadidos a la colección de módulos disponibles para ser añadidos a la pasarela.
GATEWAY_SERVER_CONNECTION_STATUS_CHANGED
Este evento indica que ha habido un cambio en el estado del servidor de software de la pasarela, normalmente una función Lambda, pasando de estado en ejecución a estado parado o viceversa.
Si el estado final es parado, significa que el proceso de ingestión de datos no está funcionando correctamente y debemos comprobar tanto la CPU como Docker y el estado del sistema operativo para poder continuar con la ingestión.
Si no tomamos ninguna acción, la ingestión de datos no se reanudará automáticamente ya que esta incidencia es crítica e impide que la pila de comunicaciones que se ejecuta en la infraestructura local pueda funcionar.
GATEWAY_SOFTWARE_INSTALLATION_SUCCEEDED
Este evento indica que se ha completado correctamente la instalación de Neuron Edge en tu CPU industrial.
A partir de este momento comienza el proceso de identificación de servidores y descubrimiento de módulos y sensores.
GATEWAY_STATUS_CHANGED
Este evento indica un cambio de estado en la comunicación con el punto final en la nube. El cambio puede ser de ONLINE a OFFLINE o viceversa.
Si el estado final es OFFLINE, significa que se ha perdido la comunicación con la nube y no se subirán datos. Deberías verificar la conexión de red física, la configuración del protocolo de red y, finalmente, la disponibilidad del punto final en la nube.
Si no tomas ninguna acción, la ingestión no se reanudará automáticamente y no verás datos disponibles hasta que resuelvas el problema y el estado cambie a ONLINE.
GATEWAY_TELEMETRY_DATA_UPDATED
Este evento indica que se han generado datos de telemetría del software de la pasarela con información sobre consumo de memoria, número de mensajes procesados, etc.
Esta información permite monitorizar el correcto funcionamiento del software de pasarela local y anticipar potenciales problemas como la falta de memoria o espacio en disco.
GATEWAY_THROTTLING_TIME_ELAPSED
Este evento indica que ha finalizado el tiempo de restricción de lectura de datos de la pasarela (por un exceso de frecuencia de lectura en pasarelas MQTT), y la pasarela vuelve a ingestar datos con normalidad.
Si tienes problemas con la instalación de tu pasarela o quieres conocer detalles avanzados sobre alguno de los eventos, ponte en contacto con nuestro departamento de soporte enviando un email a neuron@plexo.cloud