翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。 # nucleus テレメトリエミッタ nucleus テレメトリエミッタコンポーネント (`aws.greengrass.telemetry.NucleusEmitter`) は、システムヘルステレメトリデータを収集し、ローカルトピックと AWS IoT Core MQTT トピックに継続的に発行します。このコンポーネントは、Greengrass コアデバイスでリアルタイムシステムテレメトリの収集を可能にします。システムテレメトリデータを Amazon EventBridge にパブリッシュする Greengrass テレメトリエージェントの情報については、「[AWS IoT Greengrass コアデバイスからシステムヘルステレメトリデータを収集する](telemetry.md)」を参照してください。デフォルトで、nucleus テレメトリエミッタコンポーネントは 60 秒ごとにテレメトリデータを次のローカルパブリッシュ/サブスクライブトピックにパブリッシュします。 ``` $local/greengrass/telemetry ``` nucleus テレメトリエミッタコンポーネントは、デフォルトでは AWS IoT Core MQTT トピックに発行されません。このコンポーネントは、デプロイ時に AWS IoT Core MQTT トピックに発行するように設定できます。MQTT トピックを使用してにデータを発行 AWS クラウドするには、[AWS IoT Core 料金](https://aws.amazon.com/iot-core/pricing/)が適用されます。 AWS IoT Greengrass には、InfluxDB と Grafana を使用してコアデバイスでテレメトリデータをローカルに分析および視覚化するのに役立つ[コミュニティコンポーネント](greengrass-software-catalog.md)がいくつか用意されています。これらのコンポーネントは、nucleus エミッタコンポーネントのテレメトリデータを使用します。詳細については、[InfluxDB パブリッシャーコンポーネント](https://github.com/awslabs/aws-greengrass-labs-telemetry-influxdbpublisher)の「README」を参照してください。 **Topics** + [バージョン](#nucleus-emitter-component-versions) + [タイプ](#nucleus-emitter-component-type) + [オペレーティングシステム](#nucleus-emitter-component-os-support) + [依存関係](#nucleus-emitter-component-dependencies) + [設定](#nucleus-emitter-component-configuration) + [出力データ](#nucleus-emitter-component-output-data) + [使用方法](#nucleus-emitter-component-usage) + [ローカルログファイル](#nucleus-emitter-component-log-file) + [変更ログ](#nucleus-emitter-component-changelog) ## バージョンこのコンポーネントには、次のバージョンがあります。 + 1.0.x ## タイプこのコンポーネントはプラグインコンポーネント (`aws.greengrass.plugin`) です。[Greengrass nucleus](greengrass-nucleus-component.md) は、nucleus と同じ Java バーチャルマシン (JVM) でこのコンポーネントを実行します。コアデバイスでこのコンポーネントのバージョンを変更するとき、nucleus が再起動します。このコンポーネントは、Greengrass nucleus と同じログファイルを使用します。詳細については、「[AWS IoT Greengrass ログのモニタリング](monitor-logs.md)」を参照してください。詳細については、「[コンポーネントタイプ](develop-greengrass-components.md#component-types)」を参照してください。 ## オペレーティングシステムこのコンポーネントは、次のオペレーティングシステムを実行するコアデバイスにインストールできます。 + Linux + Server ## 依存関係コンポーネントをデプロイすると、は互換性のあるバージョンの依存関係 AWS IoT Greengrass もデプロイします。つまり、コンポーネントを正常にデプロイするには、コンポーネントとその依存関係のすべての要件を満たす必要があります。このセクションでは、このコンポーネントの[リリースされたバージョン](#nucleus-emitter-component-changelog)の依存関係と、各依存関係に対するコンポーネントのバージョンを定義するセマンティックバージョン制約をリスト表示しています。コンポーネントの各バージョンの依存関係は、[AWS IoT Greengrass コンソール](https://console.aws.amazon.com//greengrass)でも確認できます。コンポーネントの詳細ページで **[Dependencies]** (依存関係) リストを確認します。 ------ #### [ 1.0.12 ] 次の表に、このコンポーネントのバージョン 1.0.12 の依存関係を示します。 | 依存関係 | 互換性のあるバージョン | 依存関係タイプ | | --- | --- | --- | | [Greengrass nucleus](greengrass-nucleus-component.md) | >=2.4.0 <2.17.0 | ソフト | ------ #### [ 1.0.11 ] 次の表に、このコンポーネントのバージョン 1.0.11 の依存関係を示します。 | 依存関係 | 互換性のあるバージョン | 依存関係タイプ | | --- | --- | --- | | [Greengrass nucleus](greengrass-nucleus-component.md) | >=2.4.0 <2.16.0 | ハード | ------ #### [ 1.0.10 ] 次の表に、このコンポーネントのバージョン 1.0.10 の依存関係を示します。 | 依存関係 | 互換性のあるバージョン | 依存関係タイプ | | --- | --- | --- | | [Greengrass nucleus](greengrass-nucleus-component.md) | >=2.4.0 <2.15.0 | ハード | ------ #### [ 1.0.9 ] 次の表に、このコンポーネントのバージョン 1.0.9 の依存関係を示します。 | 依存関係 | 互換性のあるバージョン | 依存関係タイプ | | --- | --- | --- | | [Greengrass nucleus](greengrass-nucleus-component.md) | >=2.4.0 <2.14.0 | ハード | ------ #### [ 1.0.8 ] 次の表に、このコンポーネントのバージョン 1.0.8 の依存関係を示します。 | 依存関係 | 互換性のあるバージョン | 依存関係タイプ | | --- | --- | --- | | [Greengrass nucleus](greengrass-nucleus-component.md) | >=2.4.0 <2.13.0 | ハード | ------ #### [ 1.0.7 ] 次の表に、このコンポーネントのバージョン 1.0.7 の依存関係を示します。 | 依存関係 | 互換性のあるバージョン | 依存関係タイプ | | --- | --- | --- | | [Greengrass nucleus](greengrass-nucleus-component.md) | >=2.4.0 <2.12.0 | ハード | ------ #### [ 1.0.6 ] 次の表に、このコンポーネントのバージョン 1.0.6 の依存関係を示します。 | 依存関係 | 互換性のあるバージョン | 依存関係タイプ | | --- | --- | --- | | [Greengrass nucleus](greengrass-nucleus-component.md) | >=2.4.0 <2.11.0 | ハード | ------ #### [ 1.0.5 ] 次の表に、このコンポーネントのバージョン 1.0.5 の依存関係を示します。 | 依存関係 | 互換性のあるバージョン | 依存関係タイプ | | --- | --- | --- | | [Greengrass nucleus](greengrass-nucleus-component.md) | >=2.4.0 <2.10.0 | ハード | ------ #### [ 1.0.4 ] 次の表に、このコンポーネントのバージョン 1.0.4 の依存関係を示します。 | 依存関係 | 互換性のあるバージョン | 依存関係タイプ | | --- | --- | --- | | [Greengrass nucleus](greengrass-nucleus-component.md) | >=2.4.0 <2.9.0 | ハード | ------ #### [ 1.0.3 ] 次の表に、このコンポーネントのバージョン 1.0.3 の依存関係を示します。 | 依存関係 | 互換性のあるバージョン | 依存関係タイプ | | --- | --- | --- | | [Greengrass nucleus](greengrass-nucleus-component.md) | >=2.4.0 <2.8.0 | ハード | ------ #### [ 1.0.2 ] 次の表に、このコンポーネントのバージョン 1.0.2 の依存関係を示します。 | 依存関係 | 互換性のあるバージョン | 依存関係タイプ | | --- | --- | --- | | [Greengrass nucleus](greengrass-nucleus-component.md) | >=2.4.0 <2.7.0 | ハード | ------ #### [ 1.0.1 ] 次の表に、このコンポーネントのバージョン 1.0.1 の依存関係を示します。 | 依存関係 | 互換性のあるバージョン | 依存関係タイプ | | --- | --- | --- | | [Greengrass nucleus](greengrass-nucleus-component.md) | >=2.4.0 <2.6.0 | ハード | ------ #### [ 1.0.0 ] 次の表に、このコンポーネントのバージョン 1.0.0 の依存関係を示します。 | 依存関係 | 互換性のあるバージョン | 依存関係タイプ | | --- | --- | --- | | [Greengrass nucleus](greengrass-nucleus-component.md) | >=2.4.0 <2.5.0 | ハード | ------ コンポーネントの依存関係の詳細については、「[コンポーネント recipe のリファレンス](component-recipe-reference.md#recipe-reference-component-dependencies)」を参照してください。 ## 設定このコンポーネントには、コンポーネントのデプロイ時にカスタマイズできる次の設定パラメータが用意されています。 `pubSubPublish` (オプション) テレメトリデータを `$local/greengrass/telemetry` トピックにパブリッシュするかどうか定義します。サポートされている値は`true` および `false` です。デフォルト: `true` `mqttTopic` (オプション) このコンポーネントがテレメトリデータを発行する AWS IoT Core MQTT トピック。この値を、テレメトリデータを発行する AWS IoT Core MQTT トピックに設定します。この値が空のとき、nucleus エミッタはテレメトリデータを AWS クラウドにパブリッシュしません。 MQTT トピックを使用してにデータを発行 AWS クラウドするには、[AWS IoT Core 料金](https://aws.amazon.com/iot-core/pricing/)が適用されます。デフォルト: `""` `telemetryPublishIntervalMs` (オプション) コンポーネントがテレメトリーデータをパブリッシュする間隔 (ミリ秒単位)。この値をサポートされている最小値よりも低く設定する場合、コンポーネントは代わりに最小値を使用します。パブリッシュ間隔を短くすると、コアデバイスの CPU 使用率が高くなります。デフォルトのパブリッシュ間隔から開始して、デバイスの CPU 使用率に基づいて調整することをお勧めします。最小: `500` デフォルト: `60000` **Example 例: 設定マージの更新** 次の例は、 `$local/greengrass/telemetry`トピックと `greengrass/myTelemetry` AWS IoT Core MQTT トピックに 5 秒ごとにテレメトリデータを公開できるようにする設定マージ更新の例を示しています。 ``` { "pubSubPublish": "true", "mqttTopic": "greengrass/myTelemetry", "telemetryPublishIntervalMs": 5000 } ``` ## 出力データこのコンポーネントは、次のトピックにテレメトリメトリクスを JSON 配列としてパブリッシュします。 **ローカルトピック:** `$local/greengrass/telemetry` オプションで、テレメトリメトリクスを AWS IoT Core MQTT トピックに発行することもできます。トピックの詳細については、「*AWS IoT Core デベロッパーガイド*」の「[MQTT topics](https://docs.aws.amazon.com/iot/latest/developerguide/topics.html)」を参照してください。 **Example データの例** ``` [ { "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 } ] ``` 出力配列には、次のプロパティを持つメトリクスのリストが含まれています。 `A` メトリクスの集計タイプ。 `CpuUsage` メトリクスの場合、メトリクスのパブリッシュ値は、前回のパブリッシュイベント以降の平均 CPU 使用率であるため、このプロパティは `Average` に設定されます。他のすべてのメトリクスの場合、nucleus エミッタはメトリクス値を集計せず、さらにこのプロパティは `Count` に設定されます。 `N` メトリクスの名前。 `NS` メトリクスの名前空間。 `TS` データが収集された時刻のタイムスタンプ。 `U` メトリクス値の単位。 `V` メトリクスの値。 nucleus エミッタは、次のメトリクスを発行します。 | 名前 | 説明 | | --- | --- | | **システム** | | `SystemMemUsage` | オペレーティングシステムを含む、Greengrass コアデバイスのすべてのアプリケーションで現在使用されているメモリの量。 | | `CpuUsage` | オペレーティングシステムを含む Greengrass コアデバイスのすべてのアプリケーションで現在使用されている CPU の量。 | | `TotalNumberOfFDs` | Greengrass コアデバイスのオペレーティングシステムによって保存されているファイルディスクリプタの数。1 つのファイルディスクリプタは、1 つのオープンファイルを一意に識別します。 | | **Greengrass nucleus** | | `NumberOfComponentsRunning` | Greengrass コアデバイスで実行されているコンポーネント数。 | | `NumberOfComponentsErrored` | Greengrass コアデバイスでエラー状態にあるコンポーネントの数。 | | `NumberOfComponentsInstalled` | Greengrass コアデバイスでインストールされているコンポーネントの数。 | | `NumberOfComponentsStarting` | Greengrass コアデバイスで開始されているコンポーネントの数。 | | `NumberOfComponentsNew` | Greengrass コアデバイスで新しくなったコンポーネントの数。 | | `NumberOfComponentsStopping` | Greengrass コアデバイスで停止しているコンポーネントの数。 | | `NumberOfComponentsFinished` | Greengrass コアデバイスで終了するコンポーネントの数。 | | `NumberOfComponentsBroken` | Greengrass コアデバイスで壊れているコンポーネントの数。 | | `NumberOfComponentsStateless` | Greengrass コアデバイスでステートレスであるコンポーネントの数。 | ## 使用方法システムヘルステレメトリデータを使用するには、nucleus エミッタがテレメトリデータをパブリッシュするトピックへサブスクライブし、必要に応じてそのデータに反応するカスタムコンポーネントを作成できます。nucleus エミッタコンポーネントには、テレメトリデータをローカルトピックにパブリッシュするオプションが用意されているため、そのトピックをサブスクライブし、パブリッシュされたデータを使用してコアデバイスでローカルに動作させることができます。次に、クラウドへの接続が制限されている場合でも、コアデバイスはテレメトリデータに反応できます。例えば、テレメトリデータの `$local/greengrass/telemetry` トピックを参照し、ストリームマネージャーコンポーネントにデータを送信するようにコンポーネントを設定して、データを AWS クラウドにストリーミングできます。このようなコンポーネントの作成方法の詳細については、「[ローカルメッセージをパブリッシュ/サブスクライブする](ipc-publish-subscribe.md)」と「[ストリームマネージャーを使用するカスタムコンポーネントを作成する](use-stream-manager-in-custom-components.md)」を参照してください。 ## ローカルログファイルこのコンポーネントは、[Greengrass nucleus](greengrass-nucleus-component.md) コンポーネントと同じログファイルを使用します。 ------ #### [ Linux ] ``` /greengrass/v2/logs/greengrass.log ``` ------ #### [ Windows ] ``` C:\greengrass\v2\logs\greengrass.log ``` ------ **このコンポーネントのログを確認するには** + コアデバイスに次のコマンドを実行して、このコンポーネントのログファイルをリアルタイムに確認します。`/greengrass/v2` または *C:\$1greengrass\$1v2* を 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 ``` ------ ## 変更ログ次の表は、コンポーネントの各バージョンにおける変更を示します。 | **バージョン** | **変更** | | --- | --- | | 1.0.13 | Greengrass nucleus バージョン 2.17.0 リリースのコンポーネントバージョンを更新します。 | | 1.0.12 | Greengrass nucleus バージョン 2.16.0 リリース用にバージョンが更新されました。 | | 1.0.11 | Greengrass nucleus バージョン 2.15.0 リリース用にバージョンが更新されました。 | | 1.0.10 | Greengrass nucleus バージョン 2.14.0 リリース用にバージョンが更新されました。 | | 1.0.9 | Greengrass nucleus バージョン 2.13.0 のリリース用にバージョンが更新されました。 | | 1.0.8 | Greengrass nucleus バージョン 2.12.0 のリリース用にバージョンが更新されました。 | | 1.0.7 | Greengrass nucleus バージョン 2.11.0 のリリース用にバージョンが更新されました。 | | 1.0.6 | Greengrass nucleus バージョン 2.10.0 のリリース用にバージョンが更新されました。 | | 1.0.5 | Greengrass nucleus バージョン 2.9.0 のリリース用にバージョンが更新されました。 | | 1.0.4 | Greengrass nucleus バージョン 2.8.0 のリリース用にバージョンが更新されました。 | | 1.0.3 | Greengrass nucleus バージョン 2.7.0 のリリース用にバージョンが更新されました。 | | 1.0.2 | Greengrass nucleus バージョン 2.6.0 のリリース用にバージョンが更新されました。 | | 1.0.1 | Greengrass nucleus バージョン 2.5.0 のリリース用にバージョンが更新されました。 | | 1.0.0 | 当初のバージョン |