IP ディテクター - AWS IoT Greengrass
バージョンタイプオペレーティングシステム要件依存関係構成ローカルログファイル変更ログ

翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

IP ディテクター

IP ディテクターコンポーネント (aws.greengrass.clientdevices.IPDetector) は以下の処理を行います。

  • Greengrass コアデバイスのローカルネットワーク接続情報を監視します。この情報には、コアデバイスのネットワークエンドポイントとMQTTブローカーが動作するポートが含まれます。

  • AWS IoT Greengrass クラウドサービスのコアデバイスの接続情報を更新します。

クライアントデバイスは Greengrass クラウドディスカバリを使用して、関連するコアデバイスの接続情報を取得できます。その後クライアントデバイスは、正常に接続されるまで各コアデバイスへの接続を試みることができます。

注記

クライアントデバイスは、Greengrass コアデバイスに接続してMQTTメッセージとデータを処理に送信するローカル IoT デバイスです。詳細については、「ローカル IoT デバイスとやり取りする」を参照してください。

IP ディテクターコンポーネントは、コアデバイスの既存の接続情報を検出した情報に置き換えます。このコンポーネントは既存の情報を削除するため、IP ディテクターコンポーネントを使用するか、接続情報を手動で管理するか選択できます。

バージョン

このコンポーネントには、次のバージョンがあります。

  • 2.2.x

  • 2.2.x

  • 2.1.x

  • 2.0.x

タイプ

このコンポーネントはプラグインコンポーネント (aws.greengrass.plugin) です。Greengrass nucleus は、nucleus と同じ Java 仮想マシン (JVM) でこのコンポーネントを実行します。コアデバイスでこのコンポーネントのバージョンを変更するとき、nucleus が再起動します。

このコンポーネントは、Greengrass nucleus と同じログファイルを使用します。詳細については、「AWS IoT Greengrass ログのモニタリング」を参照してください。

詳細については、「コンポーネントタイプ」を参照してください。

オペレーティングシステム

このコンポーネントは、次のオペレーティングシステムを実行するコアデバイスにインストールできます。

  • Linux

  • Windows

要件

このコンポーネントには次の要件があります。

  • Greengrass サービスロールを に関連付け AWS アカウント 、 iot:GetThingShadowおよび のiot:UpdateThingShadowアクセス許可を付与する必要があります。

  • コアデバイスの AWS IoT ポリシーは、 アクセスgreengrass:UpdateConnectivityInfo許可を許可する必要があります。詳細については、「データプレーンオペレーションの AWS IoT ポリシー」および「クライアントデバイスをサポートするための最低限の AWS IoT ポリシー」を参照してください。

  • デフォルトのポート 8883 以外のポートを使用するようにコアデバイスのMQTTブローカーコンポーネントを設定する場合は、IP ディテクター v2.1.0 以降を使用する必要があります。ブローカーが動作するポートを報告するように設定します。

  • 複雑なネットワーク設定がある場合、IP ディテクターコンポーネントは、クライアントデバイスがコアデバイスに接続できるエンドポイントを識別できない場合があります。IP ディテクターコンポーネントがエンドポイントを管理できない場合、代わりにコア デバイス エンドポイントを手動で管理する必要があります。例えば、コアデバイスがMQTTブローカーポートを転送するルーターの背後にある場合は、ルーターの IP アドレスをコアデバイスのエンドポイントとして指定する必要があります。詳細については、「コアデバイスのエンドポイントを管理」を参照してください。

  • IP ディテクターコンポーネントは、 で実行できますVPC。

依存関係

コンポーネントをデプロイすると、 はその依存関係の互換性のあるバージョン AWS IoT Greengrass もデプロイします。つまり、コンポーネントを正常にデプロイするには、コンポーネントとその依存関係のすべての要件を満たす必要があります。このセクションでは、このコンポーネントのリリースされたバージョンの依存関係と、各依存関係に対するコンポーネントのバージョンを定義するセマンティックバージョン制約をリスト表示しています。コンポーネントの各バージョンの依存関係は、AWS IoT Greengrass コンソールでも確認できます。コンポーネントの詳細ページで [Dependencies] (依存関係) リストを確認します。

2.2.0

次の表に、このコンポーネントのバージョン 2.2.0 の依存関係を示します。

依存関係 互換性のあるバージョン 依存関係タイプ
Greengrass nucleus >=2.2.0 <2.14.0 ソフト
2.2.0

次の表に、このコンポーネントのバージョン 2.2.0 の依存関係を示します。

依存関係 互換性のあるバージョン 依存関係タイプ
Greengrass nucleus >=2.2.0 <2.14.0 ソフト
2.1.8 – 2.1.9

次の表に、このコンポーネントのバージョン 2.1.8 および 2.1.9 の依存関係を示します。

依存関係 互換性のあるバージョン 依存関係タイプ
Greengrass nucleus >=2.2.0 <2.13.0 ソフト
2.1.7

次の表に、このコンポーネントのバージョン 2.1.7 に関する依存関係を示します。

依存関係 互換性のあるバージョン 依存関係タイプ
Greengrass nucleus >=2.2.0 <2.12.0 ソフト
2.1.6

次の表に、このコンポーネントのバージョン 2.1.6 の依存関係を示します。

依存関係 互換性のあるバージョン 依存関係タイプ
Greengrass nucleus >=2.2.0 <2.11.0 ソフト
2.1.5

次の表に、このコンポーネントのバージョン 2.1.5 の依存関係を示します。

依存関係 互換性のあるバージョン 依存関係タイプ
Greengrass nucleus >=2.2.0 <2.10.0 ソフト
2.1.4

次の表に、このコンポーネントのバージョン 2.1.4 の依存関係を示します。

依存関係 互換性のあるバージョン 依存関係タイプ
Greengrass nucleus >=2.2.0 <2.9.0 ソフト
2.1.3

次の表に、このコンポーネントのバージョン 2.1.3 の依存関係を示します。

依存関係 互換性のあるバージョン 依存関係タイプ
Greengrass nucleus >=2.2.0 <2.8.0 ソフト
2.1.2

次の表に、このコンポーネントのバージョン 2.1.2 の依存関係を示します。

依存関係 互換性のあるバージョン 依存関係タイプ
Greengrass nucleus >=2.2.0 <2.7.0 ソフト
2.1.1

次の表に、このコンポーネントのバージョン 2.1.1 の依存関係を示します。

依存関係 互換性のあるバージョン 依存関係タイプ
Greengrass nucleus >=2.2.0 <2.6.0 ソフト
2.1.0 and 2.0.2

次の表に、このコンポーネントのバージョン 2.1.0 および 2.0.2 の依存関係を示します。

依存関係 互換性のあるバージョン 依存関係タイプ
Greengrass nucleus >=2.2.0 <2.5.0 ソフト
2.0.1

次の表に、このコンポーネントのバージョン 2.0.1 の依存関係を示します。

依存関係 互換性のあるバージョン 依存関係タイプ
Greengrass nucleus >=2.2.0 <2.4.0 ソフト
2.0.0

次の表に、このコンポーネントのバージョン 2.0.0 の依存関係を示します。

依存関係 互換性のあるバージョン 依存関係タイプ
Greengrass nucleus >=2.2.0 <2.3.0 ソフト

コンポーネントの依存関係の詳細については、「コンポーネント recipe のリファレンス」を参照してください。

構成

このコンポーネントには、コンポーネントのデプロイ時にカスタマイズできる次の設定パラメータが用意されています。

2.2.x
defaultPort

（オプション) このコンポーネントが IP アドレスを検出したときにレポートするMQTTブローカーポート。デフォルトのポート 8883 とは異なるポートを使用するようにMQTTブローカーを設定する場合は、このパラメータを指定する必要があります。

デフォルト: 8883

includeIPv4LoopbackAddrs

（オプション) このオプションを有効にすると、IPv4ループバックアドレスを検出してレポートできます。これらは、localhost など、IP アドレスであり、デバイスが自身と通信できる場所です。このオプションは、コアデバイスとクライアントデバイスを同じシステムで実行するテスト環境で使用します。

デフォルト: false

（オプション) このオプションを有効にすると、IPv4リンクローカルアドレス を検出してレポートできます。このオプションは、コアデバイスのネットワークに Dynamic Host Configuration Protocol (DHCP) または静的に割り当てられた IP アドレスがない場合に使用します。

デフォルト: false

includeIPv6LoopbackAddrs

（オプション) このオプションを有効にすると、IPv6ループバックアドレスを検出してレポートできます。これらは、localhost など、IP アドレスであり、デバイスが自身と通信できる場所です。このオプションは、コアデバイスとクライアントデバイスを同じシステムで実行するテスト環境で使用します。このオプションを使用するにはincludeIPv4Addrs、 を に設定falseしtrue、 includeIPv6Addrsを に設定する必要があります。

デフォルト: false

（オプション) このオプションを有効にすると、IPv6リンクローカルアドレス を検出してレポートできます。このオプションは、コアデバイスのネットワークに Dynamic Host Configuration Protocol (DHCP) または静的に割り当てられた IP アドレスがない場合に使用します。このオプションを使用するにはincludeIPv4Addrs、 を に設定falseしtrue、 includeIPv6Addrsを に設定する必要があります。

デフォルト: false

includeIPv4Addrs

（オプション) デフォルトは に設定されますtrue。このオプションを有効にすると、コアデバイスにあるIPv4アドレスを発行できます。

デフォルト: true

includeIPv6Addrs

（オプション) このオプションを有効にして、コアデバイスにあるIPv6アドレスを発行できます。このオプションを使用するにはfalse、 includeIPv4Addrsに設定します。

デフォルト: false

2.1.x
defaultPort

（オプション) このコンポーネントが IP アドレスを検出したときにレポートするMQTTブローカーポート。デフォルトのポート 8883 とは異なるポートを使用するようにMQTTブローカーを設定する場合は、このパラメータを指定する必要があります。

デフォルト: 8883

includeIPv4LoopbackAddrs

（オプション) このオプションを有効にすると、IPv4ループバックアドレスを検出してレポートできます。これらは、localhost など、IP アドレスであり、デバイスが自身と通信できる場所です。このオプションは、コアデバイスとクライアントデバイスを同じシステムで実行するテスト環境で使用します。

デフォルト: false

（オプション) このオプションを有効にすると、IPv4リンクローカルアドレス を検出してレポートできます。このオプションは、コアデバイスのネットワークに Dynamic Host Configuration Protocol (DHCP) または静的に割り当てられた IP アドレスがない場合に使用します。

デフォルト: false

2.0.x
includeIPv4LoopbackAddrs

（オプション) このオプションを有効にすると、IPv4ループバックアドレスを検出してレポートできます。これらは、localhost など、IP アドレスであり、デバイスが自身と通信できる場所です。このオプションは、コアデバイスとクライアントデバイスを同じシステムで実行するテスト環境で使用します。

デフォルト: false

（オプション) このオプションを有効にすると、IPv4リンクローカルアドレス を検出してレポートできます。このオプションは、コアデバイスのネットワークに Dynamic Host Configuration Protocol (DHCP) または静的に割り当てられた IP アドレスがない場合に使用します。

デフォルト: false

ローカルログファイル

このコンポーネントは、Greengrass nucleus コンポーネントと同じログファイルを使用します。

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.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

当初のバージョン