Detector de IP - AWS IoT Greengrass
VersionesTipoSistema operativoRequisitosDependenciasConfiguraciónArchivo de registro localRegistros de cambios

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

Detector de IP

El componente detector de IP (aws.greengrass.clientdevices.IPDetector) hace lo siguiente:

  • Supervisa la información de conectividad de red del dispositivo principal de Greengrass. Esta información incluye los puntos de conexión de la red del dispositivo principal y el puerto en el que opera un agente de MQTT.

  • Actualiza la información de conectividad del dispositivo principal en el servicio en la AWS IoT Greengrass nube.

Los dispositivos de cliente pueden usar la detección en la nube de Greengrass para recuperar la información de conectividad de sus dispositivos principales asociados. A continuación, los dispositivos de cliente pueden intentar conectarse a cada dispositivo principal hasta que se conecten correctamente.

nota

Los dispositivos de cliente son dispositivos IoT locales que se conectan a un dispositivo principal de Greengrass para enviar mensajes MQTT y datos para su procesamiento. Para obtener más información, consulte Interacción con dispositivos IoT locales.

El componente detector de IP reemplaza la información de conectividad existente de un dispositivo principal por la información que detecta. Como este componente elimina la información existente, puede utilizar el componente detector de IP o administrar manualmente la información de conectividad.

Versiones

Este componente tiene las siguientes versiones:

  • 2.2.x

  • 2.1.x

  • 2.0.x

Tipo

Este componente es un componente de complemento (aws.greengrass.plugin). El núcleo de Greengrass ejecuta este componente en la misma máquina virtual Java (JVM) que el núcleo. El núcleo se reinicia al cambiar la versión de este componente en el dispositivo principal.

Este componente usa el mismo archivo de registro que el núcleo de Greengrass. Para obtener más información, consulte Supervise AWS IoT Greengrass los registros.

Para obtener más información, consulte Tipos de componentes.

Sistema operativo

Este componente se puede instalar en los dispositivos principales que ejecutan los siguientes sistemas operativos:

  • Linux

  • Windows

Requisitos

Este componente tiene los siguientes requisitos:

  • El rol de servicio de Greengrass debe estar asociado a sus permisos Cuenta de AWS y permitir los permisos iot:GetThingShadow yiot:UpdateThingShadow.

  • La AWS IoT política del dispositivo principal debe permitir el greengrass:UpdateConnectivityInfo permiso. Para obtener más información, consulte AWS IoT políticas para las operaciones del plano de datos y AWS IoT Política mínima de compatibilidad con los dispositivos cliente.

  • Si configura el componente agente MQTT del dispositivo principal para que utilice un puerto que no sea el puerto 8883 predeterminado, debe usar el detector de IP versión 2.1.0 o posterior. Configúrelo para que indique el puerto en el que opera el agente.

  • Si tiene una configuración de red compleja, es posible que el componente detector de IP no pueda identificar los puntos de conexión en los que los dispositivos de cliente se pueden conectar al dispositivo principal. Si el componente detector de IP no puede administrar los puntos de conexión, debe administrar manualmente los puntos de conexión del dispositivo principal. Por ejemplo, si el dispositivo principal está detrás de un enrutador que le reenvía el puerto de agente MQTT, debe especificar la dirección IP del enrutador como punto de conexión del dispositivo principal. Para obtener más información, consulte Administración de puntos de conexión del dispositivo principal.

  • Se admite que el componente detector de IP se ejecute en una VPC.

Dependencias

Al implementar un componente, AWS IoT Greengrass también despliega versiones compatibles de sus dependencias. Esto significa que debe cumplir los requisitos del componente y de todas sus dependencias para poder implementar el componente correctamente. En esta sección, se enumeran las dependencias de las versiones publicadas de este componente y las restricciones de las versiones semánticas que definen las versiones de los componentes para cada dependencia. También puede ver las dependencias de cada versión del componente en la consola de AWS IoT Greengrass. En la página de detalles del componente, busque la lista de Dependencias.

2.2.1

En la siguiente tabla, se muestran las dependencias de la versión 2.2.1 de este componente.

Dependencia Versiones compatibles Tipo de dependencia
Núcleo de Greengrass >=2.2.0 <2.15.0 Flexible
2.2.0

En la siguiente tabla, se muestran las dependencias de la versión 2.2.0 de este componente.

Dependencia Versiones compatibles Tipo de dependencia
Núcleo de Greengrass >=2.2.0 <2.14.0 Flexible
2.1.8 – 2.1.9

En la siguiente tabla, se muestran las dependencias de las versiones 2.1.8 y 2.1.9 de este componente.

Dependencia Versiones compatibles Tipo de dependencia
Núcleo de Greengrass >=2.2.0 <2.13.0 Flexible
2.1.7

En la siguiente tabla, se muestran las dependencias de la versión 2.1.7 de este componente.

Dependencia Versiones compatibles Tipo de dependencia
Núcleo de Greengrass >=2.2.0 <2.12.0 Flexible
2.1.6

En la siguiente tabla, se muestran las dependencias de la versión 2.1.6 de este componente.

Dependencia Versiones compatibles Tipo de dependencia
Núcleo de Greengrass >=2.2.0 <2.11.0 Flexible
2.1.5

En la siguiente tabla, se muestran las dependencias de la versión 2.1.5 de este componente.

Dependencia Versiones compatibles Tipo de dependencia
Núcleo de Greengrass >=2.2.0 <2.10.0 Flexible
2.1.4

En la siguiente tabla, se muestran las dependencias de la versión 2.1.4 de este componente.

Dependencia Versiones compatibles Tipo de dependencia
Núcleo de Greengrass >=2.2.0 <2.9.0 Flexible
2.1.3

En la siguiente tabla, se muestran las dependencias de la versión 2.1.3 de este componente.

Dependencia Versiones compatibles Tipo de dependencia
Núcleo de Greengrass >=2.2.0 <2.8.0 Flexible
2.1.2

En la siguiente tabla, se muestran las dependencias de la versión 2.1.2 de este componente.

Dependencia Versiones compatibles Tipo de dependencia
Núcleo de Greengrass >=2.2.0 <2.7.0 Flexible
2.1.1

En la siguiente tabla, se muestran las dependencias de la versión 2.1.1 de este componente.

Dependencia Versiones compatibles Tipo de dependencia
Núcleo de Greengrass >=2.2.0 <2.6.0 Flexible
2.1.0 and 2.0.2

En la siguiente tabla, se muestran las dependencias de las versiones 2.1.0 y 2.0.2 de este componente.

Dependencia Versiones compatibles Tipo de dependencia
Núcleo de Greengrass >=2.2.0 <2.5.0 Flexible
2.0.1

En la siguiente tabla, se muestran las dependencias de la versión 2.0.1 de este componente.

Dependencia Versiones compatibles Tipo de dependencia
Núcleo de Greengrass >=2.2.0 <2.4.0 Flexible
2.0.0

En la siguiente tabla, se muestran las dependencias de la versión 2.0.0 de este componente.

Dependencia Versiones compatibles Tipo de dependencia
Núcleo de Greengrass >=2.2.0 <2.3.0 Flexible

Para obtener más información sobre las dependencias del componente, consulte la referencia de receta de componentes.

Configuración

Este componente ofrece los siguientes parámetros de configuración que puede personalizar cuando implemente el componente.

2.2.x
defaultPort

(Opcional) El puerto del agente de MQTT para informar cuando este componente detecta direcciones IP. Debe especificar este parámetro si configura el agente MQTT para que utilice un puerto diferente al puerto predeterminado 8883.

Valor predeterminado: 8883

includeIPv4LoopbackAddrs

(Opcional) Puede activar esta opción para detectar y reportar direcciones de bucle invertido. IPv4 Estas son direcciones IP, por ejemplo, localhost, donde un dispositivo puede comunicarse consigo mismo. Utilice esta opción en entornos de prueba en los que el dispositivo principal y el dispositivo de cliente se ejecuten en el mismo sistema.

Valor predeterminado: false

(Opcional) Puede activar esta opción para detectar e informar sobre las direcciones locales de los IPv4 enlaces. Utilice esta opción si la red del dispositivo principal no tiene el Protocolo de configuración dinámica de host (DHCP) ni direcciones IP asignadas de forma estática.

Valor predeterminado: false

includeIPv6LoopbackAddrs

(Opcional) Puede activar esta opción para detectar e informar sobre las direcciones de IPv6 bucle invertido. Estas son direcciones IP, por ejemplo, localhost, donde un dispositivo puede comunicarse consigo mismo. Utilice esta opción en entornos de prueba en los que el dispositivo principal y el dispositivo de cliente se ejecuten en el mismo sistema. Debe configurar includeIPv4Addrs en false y includeIPv6Addrs en true para utilizar esta opción.

Valor predeterminado: false

(Opcional) Puede activar esta opción para detectar e informar sobre las direcciones locales de los IPv6 enlaces. Utilice esta opción si la red del dispositivo principal no tiene el Protocolo de configuración dinámica de host (DHCP) ni direcciones IP asignadas de forma estática. Debe configurar includeIPv4Addrs en false y includeIPv6Addrs en true para utilizar esta opción.

Valor predeterminado: false

includeIPv4Addrs

(Opcional) De forma predeterminada, la opción se establece en true. Puede activar esta opción para publicar IPv4 las direcciones que se encuentran en el dispositivo principal.

Valor predeterminado: true

includeIPv6Addrs

(Opcional) Puede activar esta opción para publicar IPv6 las direcciones que se encuentran en el dispositivo principal. Configure includeIPv4Addrs en false para usar esta opción.

Valor predeterminado: false

2.1.x
defaultPort

(Opcional) El puerto del agente de MQTT para informar cuando este componente detecta direcciones IP. Debe especificar este parámetro si configura el agente MQTT para que utilice un puerto diferente al puerto predeterminado 8883.

Valor predeterminado: 8883

includeIPv4LoopbackAddrs

(Opcional) Puede activar esta opción para detectar y reportar las direcciones de IPv4 bucle invertido. Estas son direcciones IP, por ejemplo, localhost, donde un dispositivo puede comunicarse consigo mismo. Utilice esta opción en entornos de prueba en los que el dispositivo principal y el dispositivo de cliente se ejecuten en el mismo sistema.

Valor predeterminado: false

(Opcional) Puede activar esta opción para detectar e informar sobre las direcciones locales de los IPv4 enlaces. Utilice esta opción si la red del dispositivo principal no tiene el Protocolo de configuración dinámica de host (DHCP) ni direcciones IP asignadas de forma estática.

Valor predeterminado: false

2.0.x
includeIPv4LoopbackAddrs

(Opcional) Puede activar esta opción para detectar e informar sobre las direcciones de IPv4 bucle invertido. Estas son direcciones IP, por ejemplo, localhost, donde un dispositivo puede comunicarse consigo mismo. Utilice esta opción en entornos de prueba en los que el dispositivo principal y el dispositivo de cliente se ejecuten en el mismo sistema.

Valor predeterminado: false

(Opcional) Puede activar esta opción para detectar e informar sobre las direcciones locales de los IPv4 enlaces. Utilice esta opción si la red del dispositivo principal no tiene el Protocolo de configuración dinámica de host (DHCP) ni direcciones IP asignadas de forma estática.

Valor predeterminado: false

Archivo de registro local

Este componente utiliza el mismo archivo de registro que el componente núcleo de Greengrass.

Linux
/greengrass/v2/logs/greengrass.log
Windows
C:\greengrass\v2\logs\greengrass.log
Visualización de los registros de este componente

  • Ejecute el siguiente comando en el dispositivo de núcleo para ver el archivo de registro de este componente en tiempo real. Sustituya /greengrass/v2 o C:\greengrass\v2 por la ruta a la carpeta AWS IoT Greengrass raíz.

    Linux
    sudo tail -f /greengrass/v2/logs/greengrass.log
    Windows (PowerShell)
    Get-Content C:\greengrass\v2\logs\greengrass.log -Tail 10 -Wait

Registros de cambios

En la siguiente tabla, se describen los cambios en cada versión del componente.

Versión

Cambios

2.2.1

Versión actualizada para la versión 2.14.0 de Greengrass nucleus.

2.2.0

Versión actualizada para el lanzamiento de la versión 2.13.0 del núcleo de Greengrass.

Nuevas características

  • Añade soporte para. IPv6 Ahora puede usarlo IPv6 para mensajería local.

2.1.9
Mejoras y correcciones de errores

  • Ajusta el paso de IP adquirido para enviar solo los registros a nivel del registro de depuración.

2.1.8

 Versión actualizada para el lanzamiento de la versión 2.12.0 del núcleo de Greengrass.

2.1.7

 Versión actualizada para el lanzamiento de la versión 2.11.0 del núcleo de Greengrass.

2.1.6

 Versión actualizada para el lanzamiento de la versión 2.10.0 del núcleo de Greengrass.

2.1.5

 Versión actualizada para el lanzamiento de la versión 2.9.0 del núcleo de Greengrass.

2.1.4

 Versión actualizada para el lanzamiento de la versión 2.8.0 del núcleo de Greengrass.

2.1.3

Versión actualizada para el lanzamiento de la versión 2.7.0 del núcleo de Greengrass.

2.1.2
Mejoras y correcciones de errores

  • Mejora los mensajes de error que este componente registra en determinados escenarios.

  • Versión actualizada para el lanzamiento de la versión 2.6.0 del núcleo de Greengrass.

2.1.1

Versión actualizada para el lanzamiento de la versión 2.5.0 del núcleo de Greengrass.

2.1.0
Mejoras

  • Agrega el parámetro defaultPort, que le permite utilizar un puerto de agente MQTT no predeterminado.

  • Actualizaciones para que los mensajes de registro sean más claros.

2.0.2

Versión actualizada para el lanzamiento de la versión 2.4.0 del núcleo de Greengrass.

2.0.1

Versión actualizada para el lanzamiento de la versión 2.3.0 del núcleo de Greengrass.

2.0.0

Versión inicial.