Greengrass コアデバイスのステータスを確認する - AWS IoT Greengrass
コアデバイスのヘルス状態を確認するコアデバイスグループのヘルス状態を確認するコアデバイスのコンポーネントステータスを確認する

Greengrass コアデバイスのステータスを確認する

Greengrass コアデバイスは、ソフトウェアコンポーネントのステータスを AWS IoT Greengrass に報告します。各デバイスのヘルスサマリーと、各デバイス上にある各コンポーネントのステータスを確認することができます。

コアデバイスのヘルスステータスは次のとおりです。

  • HEALTHY - AWS IoT Greengrass Core ソフトウェアとすべてのコンポーネントが、コアデバイス上で問題なく実行されています。

  • UNHEALTHY - AWS IoT Greengrass Core ソフトウェアまたはコンポーネントが、コアデバイス上でエラー状態にあります。

注記

AWS IoT Greengrass は、ステータス更新を AWS クラウド に送信するタスクを各デバイスに任せています。デバイス上で AWS IoT Greengrass Core ソフトウェアが動作していない場合、またはデバイスが AWS クラウド に接続されていない場合、報告されたデバイスのステータスが現在のステータスを反映していない可能性があります。ステータスのタイムスタンプは、デバイスのステータスが最後に更新された日時を示しています。

コアデバイスは、次のタイミングでステータス更新を送信します。

  • AWS IoT Greengrass Core ソフトウェアが開始したとき

  • コアデバイスが AWS クラウド からデプロイを受信したとき

  • Greengrass nucleus 2.12.2 以前では、コアデバイスのコンポーネントのステータスが ERRORED または BROKEN になると、コアデバイスはステータス更新を送信します。

  • Greengrass nucleus 2.12.3 以降では、コアデバイス上のコンポーネントのステータスが ERRORED、BROKEN、RUNNING または FINISHED になると、コアデバイスはステータス更新を送信します。

  • ユーザーが設定した定期的な間隔 (デフォルトでは 24 時間)

AWS IoT Greengrass Core v2.7.0 以降では、ローカルとクラウドの両方のデプロイが発生すると、コアデバイスがステータスの更新を送信します

コアデバイスのヘルス状態を確認する

個々のコアデバイスのステータスを確認できます。

コアデバイスのステータスを確認するには (AWS CLI)

  • 次のコマンドを実行し、デバイスのステータスを取得します。coreDeviceName をクエリするコアデバイスの名前に置き換えます。

    aws greengrassv2 get-core-device --core-device-thing-name coreDeviceName

    レスポンスには、ステータスを含めたコアデバイスに関する情報が含まれています。

コアデバイスグループのヘルス状態を確認する

コアデバイスのグループ (モノグループ) のステータスを確認できます。

デバイスグループのステータスを確認するには (AWS CLI)

  • 次のコマンドを実行し、複数のコアデバイスのステータスを取得します。コマンド内の ARN を、クエリするモノグループの ARN に置き換えます。

    aws greengrassv2 list-core-devices --thing-group-arn "arn:aws:iot:region:account-id:thinggroup/thingGroupName"

    レスポンスには、モノグループのコアデバイスのリストが含まれています。リストの各エントリには、コアデバイスのステータスが含まれます。

コアデバイスのコンポーネントステータスを確認する

コアデバイス上のソフトウェアコンポーネントのステータス (ライフサイクルステータスなど) を確認できます。コンポーネントのライフサイクルステータスの詳細については、「AWS IoT Greengrass コンポーネントを開発する」を参照してください。

コアデバイス上のコンポーネントのステータスを確認するには (AWS CLI)

  • 次のコマンドを実行し、コアデバイス上のコンポーネントのステータスを取得します。coreDeviceName をクエリするコアデバイスの名前に置き換えます。

    aws greengrassv2 list-installed-components --core-device-thing-name coreDeviceName

    レスポンスには、コアデバイスで実行されるコンポーネントのリストが含まれています。リスト内の各エントリには、コンポーネントのライフサイクル状態が含まれています。これには、データのステータスがどの程度最新であるか、および Greengrass コアデバイスが特定のコンポーネントを含むメッセージを最後にクラウドに送信した日時が含まれます。レスポンスには、コンポーネントを Greengrass コアデバイスに導入した最新のデプロイソースも含まれています。

    注記

    このコマンドは、Greengrass コアデバイスが実行するコンポーネントのページ分割されたリストを取得します。デフォルトでは、このリストには、他のコンポーネントの依存関係の中でデプロイされるコンポーネントは含まれません。topologyFilter パラメータを ALL に設定することで、応答に依存関係を含めることができます。