IP 探测器 - Amazon IoT Greengrass
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异,请参阅中国的 Amazon Web Services 服务入门

本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。

IP 探测器

IP 检测器组件 (aws.greengrass.clientdevices.IPDetector) 执行以下操作:

  • 监控 Greengrass 核心设备的网络连接信息。此信息包括核心设备的网络终端节点和 MQTT 代理运行的端口。

  • 更新Amazon IoT Greengrass云服务中核心设备的连接信息。

客户端设备可以使用 Greengrass 云发现来检索关联核心设备的连接信息。然后,客户端设备可以尝试连接到每台核心设备,直到成功连接。

注意

客户端设备是连接到 Greengrass 核心设备以发送 MQTT 消息和数据进行处理的本地 IoT 设备。有关更多信息,请参阅与本地 IoT 设备互动

IP 探测器组件用其检测到的信息替换核心设备的现有连接信息。由于此组件会删除现有信息,因此您可以使用 IP 检测器组件,也可以手动管理连接信息。

注意

IP 检测器组件仅检测 IPv4 地址。

版本

此组件有以下版本:

  • 2.1.x

  • 2.0.x

类型

这个组件是一个插件组件 (aws.greengrass.plugin)。Greengrass 核心在与核心相同的 Java 虚拟机 (JVM) 中运行此组件。当您在核心设备上更改此组件的版本时,nucleus 会重新启动。

此组件使用与 Greengrass 核相同的日志文件。有关更多信息,请参阅监控Amazon IoT Greengrass日志

有关更多信息,请参阅组件类型

操作系统

此组件可以安装在运行以下操作系统的核心设备上:

  • Linux

  • Windows

要求

此组件有以下要求:

  • Greengrass 服务角色必须与您的关联Amazon Web Services 账户并允许iot:GetThingShadowiot:UpdateThingShadow权限。

  • 核心设备的Amazon IoT策略必须允许该greengrass:UpdateConnectivityInfo权限。有关更多信息,请参阅 数据层面操作的 Amazon IoT 策略支持客户端设备的最低Amazon IoT策略

  • 如果您将核心设备的 MQTT 代理组件配置为使用默认端口 8883 以外的端口,则必须使用 IP 检测器 v2.1.0 或更高版本。将其配置为报告代理运行的端口。

  • 如果您的网络设置很复杂,IP 检测器组件可能无法识别客户端设备可以连接到核心设备的端点。如果 IP 检测器组件无法管理端点,则必须手动管理核心设备端点。例如,如果核心设备位于向其转发 MQTT 代理端口的路由器后面,则必须将该路由器的 IP 地址指定为核心设备的端点。有关更多信息,请参阅管理核心设备终端节点

附属物

部署组件时,Amazon IoT Greengrass还会部署其依赖项的兼容版本。这意味着您必须满足组件及其所有依赖项的要求才能成功部署该组件。本节列出了此组件已发布版本的依赖关系以及为每个依赖项定义组件版本的语义版本约束。您还可以在Amazon IoT Greengrass控制台中查看每个版本组件的依赖关系。在组件详细信息页面上,查找 “依赖关系” 列表。

2.1.5

下表列出了此组件版本 2.1.5 的依赖关系。

依赖关系 兼容的版本 依赖关系类型
Greengrass 核 >=2.2.0 <3.0.0 软性
2.1.4

下表列出了此组件版本 2.1.4 的依赖关系。

依赖关系 兼容的版本 依赖关系类型
Greengrass 核 >=2.0 软性
2.1.3

下表列出了此组件版本 2.1.3 的依赖关系。

依赖关系 兼容的版本 依赖关系类型
Greengrass 核 >=2.0 软性
2.1.2

下表列出了此组件版本 2.1.2

依赖关系 兼容的版本 依赖关系类型
Greengrass 核 >=2.0 软性
2.1.1

下表列出了此组件版本 2.1.1 版。

依赖关系 兼容的版本 依赖关系类型
Greengrass 核 >=2.0 软性
2.1.0 and 2.0.2

下表列出了此组件版本 2.1.0 和 2.0.2 的依赖关系。

依赖关系 兼容的版本 依赖关系类型
Greengrass 核 >=2.0 软性
2.0.1

下表列出了此组件版本 2.0.1 的依赖关系。

依赖关系 兼容的版本 依赖关系类型
Greengrass 核 >=2.0 软性
2.0.0

下表列出了此组件 2.0.0 版的依赖关系。

依赖关系 兼容的版本 依赖关系类型
Greengrass 核 >=2.0 软性

有关组件依赖关系的更多信息,请参阅组件配方参考

配置

此组件提供以下配置参数,您可以在部署组件时对其进行自定义。

2.1.x
defaultPort

(可选)此组件检测到 IP 地址时要报告的 MQTT 代理端口。 如果您将 MQTT 代理配置为使用与默认端口 8883 不同的端口,则必须指定此参数。

默认值:8883

includeIPv4LoopbackAddrs

(可选)您可以启用此选项来检测和报告 IPv4 环回地址。 这些是 IP 地址,例如localhost,设备可以与自身通信的地方。在核心设备和客户端设备在同一系统上运行的测试环境中使用此选项。

默认值:false

includeIPv4LinkLocalAddrs

(可选)您可以启用此选项来检测和报告 IPv4 链路本地地址。 如果核心设备的网络没有动态主机配置协议 (DHCP) 或静态分配的 IP 地址,请使用此选项。

默认值:false

2.0.x
includeIPv4LoopbackAddrs

(可选)您可以启用此选项来检测和报告 IPv4 环回地址。 这些是 IP 地址,例如localhost,设备可以与自身通信的地方。在核心设备和客户端设备在同一系统上运行的测试环境中使用此选项。

默认值:false

includeIPv4LinkLocalAddrs

(可选)您可以启用此选项来检测和报告 IPv4 链路本地地址。 如果核心设备的网络没有动态主机配置协议 (DHCP) 或静态分配的 IP 地址,请使用此选项。

默认值:false

本地日志文件

此组件使用与 Greengrass 核心组件相同的日志文件。

Linux
/greengrass/v2/logs/greengrass.log
Windows
C:\greengrass\v2\logs\greengrass.log
查看此组件的日志
  • 在核心设备上运行以下命令以实时查看此组件的日志文件。将 /greengrass/v2C:\greengrass\v2 替换为Amazon IoT Greengrass根文件夹的路径。

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

更改日志

下表说明每个版本的组件中所做更改。

Version

变更

2.1.5

Greengrass 9.0

2.1.4

Greengrass 8.0

2.1.3

Greengrass 7.0

2.1.2

缺陷修复和改进
  • 改进了此组件在某些情况下记录的错误消息。

  • Greengrass 6.0

2.1.1

Greengrass 5.0

2.1.0

改进
  • 添加defaultPort参数,使您能够使用非默认 MQTT 代理端口。

  • 更新使日志消息更加清晰。

2.0.2

版本 2.4.0 witGreengrass Nucle 版本 2.4.0

2.0.1

Greengrass 3.0

2.0.0

初始版本。