nucleus テレメトリエミッタ

nucleus テレメトリエミッタコンポーネント (aws.greengrass.telemetry.NucleusEmitter) は、システムヘルステレメトリデータを収集して、ローカルトピックと AWS IoT Core MQTT トピックに継続的にパブリッシュします。このコンポーネントは、Greengrass コアデバイスでリアル タイム システム テレメトリの収集を可能にします。システムテレメトリデータを Amazon に発行する Greengrass テレメトリエージェントの詳細については EventBridge、「」を参照してくださいAWS IoT Greengrass コアデバイスからシステムヘルステレメトリデータを収集する。

デフォルトで、nucleus テレメトリエミッタコンポーネントは 60 秒ごとにテレメトリデータを次のローカルパブリッシュ/サブスクライブトピックにパブリッシュします。

$local/greengrass/telemetry

nucleus テレメトリエミッタコンポーネントは、デフォルトで AWS IoT Core MQTT トピックにパブリッシュしません。このコンポーネントをデプロイするとき、 AWS IoT Core MQTT トピックにパブリッシュするように設定できます。MQTT トピックを使用してデータを AWS クラウド にパブリッシュすることには、AWS IoT Core 価格設定が適用されます。

AWS IoT Greengrass はいくつかのコミュニティコンポーネントを提供し、InfluxDB と Grafana を使用してコアデバイスでローカルにテレメトリデータを分析と可視化するうえで役立ちます。これらのコンポーネントは、nucleus エミッタコンポーネントのテレメトリデータを使用します。詳細については、InfluxDB パブリッシャーコンポーネントの「README」を参照してください。

バージョン

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

タイプ

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

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

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

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

依存関係

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

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

構成

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

{
  "pubSubPublish": "true",
  "mqttTopic": "greengrass/myTelemetry",
  "telemetryPublishIntervalMs": 5000
}

出力データ

このコンポーネントは、次のトピックにテレメトリメトリクスをJSON 配列としてパブリッシュします。

ローカルトピック: $local/greengrass/telemetry

必要に応じて、テレメトリメトリクスを AWS IoT Core MQTT トピックにパブリッシュすることもできます。トピックの詳細については、「AWS IoT Core デベロッパーガイド」の「MQTT トピック」を参照してください。

[
  {
    "A": "Average",
    "N": "CpuUsage",
    "NS": "SystemMetrics",
    "TS": 1627597331445,
    "U": "Percent",
    "V": 26.21981271562346
  },
  {
    "A": "Count",
    "N": "TotalNumberOfFDs",
    "NS": "SystemMetrics",
    "TS": 1627597331445,
    "U": "Count",
    "V": 7316
  },
  {
    "A": "Count",
    "N": "SystemMemUsage",
    "NS": "SystemMetrics",
    "TS": 1627597331445,
    "U": "Megabytes",
    "V": 10098
  },
  {
    "A": "Count",
    "N": "NumberOfComponentsStarting",
    "NS": "GreengrassComponents",
    "TS": 1627597331446,
    "U": "Count",
    "V": 0
  },
  {
    "A": "Count",
    "N": "NumberOfComponentsInstalled",
    "NS": "GreengrassComponents",
    "TS": 1627597331446,
    "U": "Count",
    "V": 0
  },
  {
    "A": "Count",
    "N": "NumberOfComponentsStateless",
    "NS": "GreengrassComponents",
    "TS": 1627597331446,
    "U": "Count",
    "V": 0
  },
  {
    "A": "Count",
    "N": "NumberOfComponentsStopping",
    "NS": "GreengrassComponents",
    "TS": 1627597331446,
    "U": "Count",
    "V": 0
  },
  {
    "A": "Count",
    "N": "NumberOfComponentsBroken",
    "NS": "GreengrassComponents",
    "TS": 1627597331446,
    "U": "Count",
    "V": 0
  },
  {
    "A": "Count",
    "N": "NumberOfComponentsRunning",
    "NS": "GreengrassComponents",
    "TS": 1627597331446,
    "U": "Count",
    "V": 7
  },
  {
    "A": "Count",
    "N": "NumberOfComponentsErrored",
    "NS": "GreengrassComponents",
    "TS": 1627597331446,
    "U": "Count",
    "V": 0
  },
  {
    "A": "Count",
    "N": "NumberOfComponentsNew",
    "NS": "GreengrassComponents",
    "TS": 1627597331446,
    "U": "Count",
    "V": 0
  },
  {
    "A": "Count",
    "N": "NumberOfComponentsFinished",
    "NS": "GreengrassComponents",
    "TS": 1627597331446,
    "U": "Count",
    "V": 2
  }
]

nucleus エミッタは、次のメトリクスを発行します。

使用方法

システムヘルステレメトリデータを使用するには、nucleus エミッタがテレメトリデータをパブリッシュするトピックへサブスクライブし、必要に応じてそのデータに反応するカスタムコンポーネントを作成できます。nucleus エミッタコンポーネントには、テレメトリデータをローカルトピックにパブリッシュするオプションが用意されているため、そのトピックをサブスクライブし、パブリッシュされたデータを使用してコアデバイスでローカルに動作させることができます。次に、クラウドへの接続が制限されている場合でも、コアデバイスはテレメトリデータに反応できます。

例えば、テレメトリデータの $local/greengrass/telemetry トピックを参照し、ストリームマネージャーコンポーネントにデータを送信するようにコンポーネントを設定して、データを AWS クラウド にストリーミングできます。このようなコンポーネントの作成方法の詳細については、「ローカルメッセージをパブリッシュ/サブスクライブする」と「ストリームマネージャーを使用するカスタムコンポーネントを作成する」を参照してください。

ローカルログファイル

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

変更ログ

次の表は、コンポーネントの各バージョンにおける変更を示します。