IP 偵測器 - AWS IoT Greengrass
版本Type作業系統要求相依性組態本機日誌檔案變更記錄

本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

IP 偵測器

IP 偵測器元件 (aws.greengrass.clientdevices.IPDetector) 會執行下列動作：

  • 監控 Greengrass 核心裝置的網路連線資訊。此資訊包括核心裝置的網路端點，以及MQTT代理程式操作所在的連接埠。

  • 在 AWS IoT Greengrass 雲端服務中更新核心裝置的連線資訊。

用戶端裝置可以使用 Greengrass 雲端探索來擷取相關聯的核心裝置的連線資訊。然後，用戶端裝置可以嘗試連線到每個核心裝置，直到成功連線為止。

注意

用戶端裝置是連線至 Greengrass 核心裝置的本機 IoT 裝置，用於傳送訊息MQTT和資料以進行處理。如需詳細資訊，請參閱與本機 IoT 裝置互動。

IP 偵測器元件會將核心裝置的現有連線資訊取代為其偵測到的資訊。由於此元件會移除現有資訊，您可以使用 IP 偵測器元件，或手動管理連線資訊。

版本

此元件具有下列版本：

  • 2.2.x 版本

  • 2.1.x

  • 2.0.x

Type

此元件是外掛程式元件 (aws.greengrass.plugin)。Greengrass 核會在與核相同的 Java 虛擬機器 (JVM) 中執行此元件。當您在核心裝置上變更此元件的版本時，核會重新啟動。

此元件使用與 Greengrass 核相同的日誌檔案。如需詳細資訊，請參閱監控AWS IoT Greengrass日誌。

如需詳細資訊，請參閱元件類型。

作業系統

此元件可以安裝在執行下列作業系統的核心裝置上：

  • Linux

  • Windows

要求

此元件有下列需求：

  • Greengrass 服務角色必須與您的 相關聯， AWS 帳戶 並允許 iot:GetThingShadow和 iot:UpdateThingShadow許可。

  • 核心裝置的 AWS IoT 政策必須允許 greengrass:UpdateConnectivityInfo許可。如需詳細資訊，請參閱 資料平面操作的AWS IoT 政策 和 支援用戶端裝置的最低AWS IoT原則。

  • 如果您將核心裝置的MQTT代理程式元件設定為使用預設連接埠 8883 以外的連接埠，則必須使用 IP 偵測器 v2.1.0 或更新版本。將其設定為報告代理程式操作所在的連接埠。

  • 如果您有複雜的網路設定，IP 偵測器元件可能無法識別用戶端裝置可以連接到核心裝置的端點。如果 IP 偵測器元件無法管理端點，您必須改為手動管理核心裝置端點。例如，如果核心裝置位於轉送MQTT代理程式連接埠的路由器後方，您必須將路由器的 IP 地址指定為核心裝置的端點。如需詳細資訊，請參閱管理核心裝置端點。

  • IP 偵測器元件支援在 中執行VPC。

相依性

部署元件時， AWS IoT Greengrass 也會部署其相依性的相容版本。這表示您必須符合元件及其所有相依性的要求，才能成功部署元件。本節列出此元件發行版本的相依性，以及為每個相依性定義元件版本的語意版本限制。您也可以在AWS IoT Greengrass 主控台中檢視每個版本元件的相依性。在元件詳細資訊頁面上，尋找相依性清單。

2.2.1

下表列出此元件 2.2.1 版的相依性。

相依性 相容版本 相依性類型
Greengrass 核 >=2.2.0 <2.15.0 軟式
2.2.0

下表列出此元件 2.2.0 版的相依性。

相依性 相容版本 相依性類型
Greengrass 核 >=2.2.0 <2.14.0 軟式
2.1.8 – 2.1.9

下表列出此元件 2.1.8 和 2.1.9 版的相依性。

相依性 相容版本 相依性類型
Greengrass 核 >=2.2.0 <2.13.0 軟式
2.1.7

下表列出此元件 2.1.7 版的相依性。

相依性 相容版本 相依性類型
Greengrass 核 >=2.2.0 <2.12.0 軟式
2.1.6

下表列出此元件 2.1.6 版的相依性。

相依性 相容版本 相依性類型
Greengrass 核 >=2.2.0 <2.11.0 軟式
2.1.5

下表列出此元件 2.1.5 版的相依性。

相依性 相容版本 相依性類型
Greengrass 核 >=2.2.0 <2.10.0 軟式
2.1.4

下表列出此元件 2.1.4 版的相依性。

相依性 相容版本 相依性類型
Greengrass 核 >=2.2.0 <2.9.0 軟式
2.1.3

下表列出此元件 2.1.3 版的相依性。

相依性 相容版本 相依性類型
Greengrass 核 >=2.2.0 <2.8.0 軟式
2.1.2

下表列出此元件 2.1.2 版的相依性。

相依性 相容版本 相依性類型
Greengrass 核 >=2.2.0 <2.7.0 軟式
2.1.1

下表列出此元件 2.1.1 版的相依性。

相依性 相容版本 相依性類型
Greengrass 核 >=2.2.0 <2.6.0 軟式
2.1.0 and 2.0.2

下表列出此元件 2.1.0 和 2.0.2 版的相依性。

相依性 相容版本 相依性類型
Greengrass 核 >=2.2.0 <2.5.0 軟式
2.0.1

下表列出此元件 2.0.1 版的相依性。

相依性 相容版本 相依性類型
Greengrass 核 >=2.2.0 <2.4.0 軟式
2.0.0

下表列出此元件 2.0.0 版的相依性。

相依性 相容版本 相依性類型
Greengrass 核 >=2.2.0 <2.3.0 軟式

如需元件相依性的詳細資訊，請參閱元件配方參考。

組態

此元件提供下列組態參數，您可以在部署元件時自訂這些參數。

2.2.x
defaultPort

（選用） 此元件偵測到 IP 地址時要報告的MQTT代理程式連接埠。如果您將MQTT代理程式設定為使用與預設連接埠 8883 不同的連接埠，則必須指定此參數。

預設：8883

includeIPv4LoopbackAddrs

（選用） 您可以啟用此選項來偵測和報告回IPv4傳地址。這些是 IP 地址，例如 localhost，其中裝置可以與自己通訊。在核心裝置和用戶端裝置在相同系統上執行的測試環境中使用此選項。

預設：false

（選用） 您可以啟用此選項來偵測和報告IPv4連結本機地址。如果核心裝置的網路沒有動態主機組態通訊協定 (DHCP) 或靜態指派的 IP 地址，請使用此選項。

預設：false

includeIPv6LoopbackAddrs

（選用） 您可以啟用此選項來偵測和報告回IPv6傳地址。這些是 IP 地址，例如 localhost，其中裝置可以與自己通訊。在核心裝置和用戶端裝置在相同系統上執行的測試環境中使用此選項。您必須將 includeIPv4Addrs 設為 false和 includeIPv6Addrs ，true才能使用此選項。

預設：false

（選用） 您可以啟用此選項來偵測和報告IPv6連結本機地址。如果核心裝置的網路沒有動態主機組態通訊協定 (DHCP) 或靜態指派的 IP 地址，請使用此選項。您必須將 includeIPv4Addrs 設定為 false和 includeIPv6Addrs ，true才能使用此選項。

預設：false

includeIPv4Addrs

（選用） 預設值設為 true。您可以啟用此選項來發佈核心裝置上找到IPv4的地址。

預設：true

includeIPv6Addrs

（選用） 您可以啟用此選項來發佈核心裝置上找到IPv6的地址。includeIPv4Addrs設定為 false 以使用此選項。

預設：false

2.1.x
defaultPort

（選用） 此元件偵測到 IP 地址時要報告的MQTT代理程式連接埠。如果您將MQTT代理程式設定為使用與預設連接埠 8883 不同的連接埠，則必須指定此參數。

預設：8883

includeIPv4LoopbackAddrs

（選用） 您可以啟用此選項來偵測和報告回IPv4傳地址。這些是 IP 地址，例如 localhost，其中裝置可以與自己通訊。在核心裝置和用戶端裝置在相同系統上執行的測試環境中使用此選項。

預設：false

（選用） 您可以啟用此選項來偵測和報告IPv4連結本機地址。如果核心裝置的網路沒有動態主機組態通訊協定 (DHCP) 或靜態指派的 IP 地址，請使用此選項。

預設：false

2.0.x
includeIPv4LoopbackAddrs

（選用） 您可以啟用此選項來偵測和報告回IPv4傳地址。這些是 IP 地址，例如 localhost，其中裝置可以與自己通訊。在核心裝置和用戶端裝置在相同系統上執行的測試環境中使用此選項。

預設：false

（選用） 您可以啟用此選項來偵測和報告IPv4連結本機地址。如果核心裝置的網路沒有動態主機組態通訊協定 (DHCP) 或靜態指派的 IP 地址，請使用此選項。

預設：false

本機日誌檔案

此元件使用與 Greengrass 核元件相同的日誌檔案。

Linux
/greengrass/v2/logs/greengrass.log
Windows
C:\greengrass\v2\logs\greengrass.log
檢視此元件的日誌

  • 在核心裝置上執行下列命令，以即時檢視此元件的日誌檔案。將 /greengrass/v2或 取代C:\greengrass\v2為 AWS IoT Greengrass 根資料夾的路徑。

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

變更記錄

下表說明每個版本元件的變更。

版本

變更

2.2.1

針對 Greengrass nucleus 2.14.0 版更新版本。

2.2.0

針對 Greengrass nucleus 2.13.0 版更新版本。

新功能

  • 新增 IPv6 支援。您現在可以將 IPv6用於本機訊息。

2.1.9
錯誤修正和改善

  • 調整 IP 取得的步驟，以僅在偵錯日誌層級傳送日誌。

2.1.8

 針對 Greengrass nucleus 2.12.0 版更新版本。

2.1.7

 針對 Greengrass nucleus 2.11.0 版更新版本。

2.1.6

 針對 Greengrass nucleus 2.10.0 版更新版本。

2.1.5

 針對 Greengrass nucleus 2.9.0 版更新版本。

2.1.4

 針對 Greengrass nucleus 2.8.0 版更新版本。

2.1.3

針對 Greengrass nucleus 2.7.0 版更新版本。

2.1.2
錯誤修正和改善

  • 改善此元件在特定案例中記錄的錯誤訊息。

  • 針對 Greengrass nucleus 2.6.0 版更新版本。

2.1.1

針對 Greengrass nucleus 2.5.0 版更新版本。

2.1.0
改善項目

  • 新增 defaultPort 參數，可讓您使用非預設MQTT代理程式連接埠。

  • 更新以更清楚日誌訊息。

2.0.2

針對 Greengrass nucleus 2.4.0 版更新版本。

2.0.1

針對 Greengrass nucleus 2.3.0 版更新版本。

2.0.0

初始版本。