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:GetThingShadow和iot: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控制台. 在组件详细信息页面上，查找依赖项list。

2.1.3

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

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

下表列出了此组件版本 2.1.2 的依赖项。

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

下表列出了此组件版本 2.1.0 的依赖项。

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

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

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

下表列出了此组件版本 2.0 的依赖项。

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

下表列出了此组件版本 2.0.0 的依赖项。

依赖关系 兼容的版本 依赖关系类型
Greengrass 核心 >=2.0 <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

查看此组件的日志

  • 在核心设备上运行以下命令以实时查看该组件的日志文件。Replace/greengrass/v2要么C:\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.3

更新为Greengrass 核版本 2.7.0。

2.1.2
错误修复和改进

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

  • 更新为Greengrass 核版本 2.6.0。

2.1.1

更新为Greengrass 核版本 2.5.0。

2.1.0
改进

  • 添加defaultPort参数，此允许您使用非默认 MQTT 代理端口。

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

2.0.2

更新为Greengrass 核版本 2.4.0。

2.0.1

更新为Greengrass 核版本 2.3.0。

2.0.0

初始版本。