IP 偵測器 - AWS IoT Greengrass
版本類型作業系統請求相依性組態本機記錄檔Changelog

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

IP 偵測器

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

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

  • 在AWS IoT Greengrass雲服務中更新核心設備的連接信息。

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

注意

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

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

注意

IP 偵測器元件僅偵測 IPv4 位址。

版本

此元件具有下列版本：

  • 2.1.x

  • 2.0.x

類型

這個組件是一個插件組件（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 位址指定為核心裝置的端點。如需詳細資訊，請參閱管理核心裝置端點。

相依性

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

2.1.7

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

組態

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

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

Changelog

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

版本

變更

2.1.7

 版本更新了 Greengrass 核 2.11.0 版本釋放。

2.1.6

 版本更新了 Greengrass 核 2.10.0 版本釋放。

2.1.5

 版本更新 Greengrass 2.9.0 版本釋放。

2.1.4

 版本更新 Greengrass 2.8.0 版本的版本。

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

初始版本。