バージョン Type オペレーティングシステム要件依存関係設定入力データローカルログファイルトラブルシューティングとデバッグライセンス変更ログ関連情報

IoT SiteWise パブリッシャー

IoT SiteWise パブリッシャーコンポーネント (aws.iot.SiteWiseEdgePublisher) を使用すると、 AWS IoT SiteWise ゲートウェイはエッジからにデータをエクスポートできます AWS クラウド。

AWS IoT SiteWise ゲートウェイの詳細については、「 AWS IoT SiteWise ユーザーガイド」の「エッジ AWS IoT SiteWise でのの使用」を参照してください。

バージョン

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

3.1.x
3.0.x
2.4.x
2.3.x
2.2.x
2.1.x
2.0.x

Type

このコンポーネントはジェネリックコンポーネント (aws.greengrass.generic) です。Greengrass nucleus は、コンポーネントのライフサイクルスクリプトを実行します。

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

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

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

Linux
Windows

要件

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

Greengrass コアデバイスは、次のいずれかのプラットフォームで実行する必要があります。
- os: Ubuntu 18.04 以降
  
  アーキテクチャ: x86_64 (AMD64) または ARMv8 (Aarch64)
- os: Red Hat Enterprise Linux (RHEL) 8
  
  アーキテクチャ: x86_64 (AMD64) または ARMv8 (Aarch64)
- os: Amazon Linux 2
  
  アーキテクチャ: x86_64 (AMD64) または ARMv8 (Aarch64)
- os: Debian 11
  
  アーキテクチャ: x86_64 (AMD64) または ARMv8 (Aarch64)
- os: Windows Server 2019 以降
  
  アーキテクチャ: x86_64 (AMD64）
Greengrass コアデバイスはインターネットに接続する必要があります。
Greengrass コアデバイスは、iotsitewise:BatchPutAssetPropertyValue アクションを実行する権限を付与されている必要があります。詳細については、「コアデバイスが AWS サービスとやり取りすることを許可する」を参照してください。
例アクセス許可ポリシー
```
{
    "Version": "2012-10-17",
    "Statement": [
        {
            "Effect": "Allow",
            "Action": "iotsitewise:BatchPutAssetPropertyValue",
            "Resource": "*"
        }
    ]
}
```

エンドポイントおよびポート

このコンポーネントは、基本的な操作に必要なエンドポイントとポートに加えて、次のエンドポイントとポートに対し、アウトバウンドリクエストを実行できる必要があります。詳細については、「プロキシまたはファイアウォールを介したデバイストラフィックを許可する」を参照してください。

エンドポイント	ポート	必要	説明
`data.iotsitewise.region.amazonaws.com`	443	あり	データの発行先 AWS IoT SiteWise。

依存関係

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

次の表に、このコンポーネントのバージョン 2.0.x から 2.2.x までの依存関係を示します。

依存関係	互換性のあるバージョン	依存関係タイプ
Greengrass nucleus	>=2.3.0<3.0.0	ハード
ストリームマネージャー	>=2.0.10<3.0.0	ハード

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

設定

このコンポーネントに設定パラメータはありません。

AWS IoT SiteWise コンソールまたはを使用してAPI、IoT SiteWise パブリッシャーコンポーネントを設定できます。詳細については、「AWS IoT SiteWise ユーザーガイド」の「ステップ 3: パブリッシャーの設定 (オプション)」を参照してください。

入力データ

このコンポーネントは、 AWS IoT Greengrass ストリームマネージャーからPutAssetPropertyValueEntryメッセージを読み取ります。詳細については、AWS IoT SiteWise API リファレンスの「PutAssetPropertyValueEntry」を参照してください。

ローカルログファイル

このコンポーネントは次のログファイルを使用します。

このコンポーネントのログを確認するには

コアデバイスに次のコマンドを実行して、このコンポーネントのログファイルをリアルタイムに確認します。/greengrass/v2 またはを AWS IoT Greengrass ルートフォルダへのパスC:\greengrass\v2に置き換えます。
Linux
```
sudo tail -f /greengrass/v2/logs/aws.iot.SiteWiseEdgePublisher.log
```
Windows (PowerShell)
```
Get-Content C:\greengrass\v2\logs\aws.iot.SiteWiseEdgePublisher.log -Tail 10 -Wait
```

トラブルシューティングとデバッグ

このコンポーネントには、お客様が問題を特定して解決するのに役立つ新しいイベントログが含まれています。ログファイルはローカルログファイルとは別のもので、次の場所にあります。/greengrass/v2 またはを AWS IoT Greengrass ルートフォルダへのパスC:\greengrass\v2に置き換えます。

このログには、詳細情報とトラブルシューティングの手順が含まれています。トラブルシューティングに関する情報は診断結果とともに提供され、問題の解決方法の説明と、場合によっては詳細情報へのリンクが含まれます。診断情報には次のものが含まれます。

重要度レベル
Timestamp
イベント固有の追加情報

例ログの例


accountBeingThrottled:
  Summary: Data upload speed slowed due to quota limits
  Level: WARN
  Timestamp: '2023-06-09T21:30:24.654Z'
  Description: The IoT SiteWise Publisher is limited to the "Rate of data points ingested"
    quota for a customers account. See the associated documentation and associated
    metric for the number of requests that were limited for more information. Note
    that this may be temporary and not require any change, although if the issue continues
    you may need to request an increase for the mentioned quota.
  FurtherInformation:
  - https://docs.aws.amazon.com/iot-sitewise/latest/userguide/quotas.html
  - https://docs.aws.amazon.com/iot-sitewise/latest/userguide/troubleshooting-gateway.html#gateway-issue-data-streams
  AssociatedMetrics:
  - Name: TotalErrorCount
    Description: The total number of errors of this type that occurred.
    Value: 327724.0
  AssociatedData:
  - Name: AggregatePropertyAliases
    Description: The aggregated property aliases of the throttled data.
    FileLocation: /greengrass/v2/work/aws.iot.SiteWiseEdgePublisher/./logs/data/AggregatePropertyAliases_1686346224654.log

ライセンス

このコンポーネントは、Greengrass Core ソフトウェアライセンス契約に従ってリリースされています。

変更ログ

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

バージョン	変更
3.1.4	バグ修正と機能向上オフライン後に起動時間が発生する longer-than-expected可能性がある問題を修正しました。
3.1.3	バグ修正と機能向上にあるイベントログファイル`/greengrass/v2/work/aws.iot.SiteWiseEdgePublisher/logs/IoTSiteWisePublisherEvents.log`が作成されても、イベントがログに記録されない問題を修正しました。 MQTT ブローカーとの接続をモニタリングするための以下の CloudWatch メトリクスを追加します。 `IoTSiteWisePublisher.IsConnectedToMqttBroker` `IoTSiteWisePublisher.NumberOfSubscriptionsToMqttBroker` `IoTSiteWisePublisher.NumberOfUniqueMqttTopicsReceived` `IoTSiteWisePublisher.MqttMessageReceivedSuccessCount` `IoTSiteWisePublisher.MqttReceivedSuccessBytes` ゲートウェイメトリクスの詳細については、「AWS IoT Greengrass Version 2 ゲートウェイメトリクス」を参照してください。 S3 への parquet ファイルのアップロードが失敗しても `BatchCreateJob`APIが呼び出される問題を修正しました。
3.1.2	バグ修正と機能向上バージョン 3.1.1 で導入されたCPU使用量が多い問題を修正しました。
3.1.1	警告バージョン 3.1.1 は 2024 年 3 月 12 日に廃止されました。このバージョンの改善は、このコンポーネントのそれ以降のバージョンで利用できます。バグ修正と機能向上エラーが発生したときに影響を受けるデータエイリアスを識別する追加のログ記録を追加しました。取り込まれたデータの有効期間に対する制限のローカル適用 AWS IoT SiteWise APIを追加します。複数の Amazon S3 送信先がある場合に、パブリッシャーが StreamManager ストリームのチェックポイントを混在させる問題を修正しました。パブリッシャーが StreamManager ストリームから読み取る方法に関するパフォーマンスのボトルネックを修正しました。
3.1.0	新機能 Amazon S3 にデータを parquet ファイルとして公開するサポートを追加しました。 AWS IoT SiteWise バッファされた取り込みのサポートを追加しました。
3.0.0	バグ修正と機能向上プロキシサポートに関連する問題を修正しました。新機能 MQTT ブローカーからのデータ取り込みのサポートを有効にします。
2.4.1	バグ修正と機能向上コンポーネントが Java Corretto 11 バージョン 11.0.20.8.1 以降で動作できるようにします。コンポーネントバージョン 2.4.0 および 2.3.3 を Java Corretto バージョン 11.0.20.8.1 とともに使用すると、`"Could not find or load main class"` エラーメッセージが表示されます。
2.4.0	新機能新しいイベントログを追加して、問題の特定と修正を容易にしています。バグ修正と機能向上パブリッシャーのチェックポイントリカバリを改善しました。
2.3.3	バグ修正と機能向上高スループットへの対応を改善しました。
2.3.2	バグ修正と機能向上 Publisher 設定のダウンロード時のHTTPプロキシサポートを修正しました。
2.3.1	新機能 Linux ARMv8アーキテクチャに Data Collection Pack をインストールするためのサポートを追加しました。 Linux の最小要件ARMv8：メモリ: 4 GB CPU: ARM Cortex-A72 または同等の仕様
2.2.3	バグ修正と機能向上再試行可能な例外リストにない汎用例外の再試行を削除します。
2.2.2	バグ修正と機能向上 HTTP プロキシサーバー AWS IoT SiteWise を介してへのデータアップロードサポートを再導入します。
2.2.1	注記このバージョンはHTTPプロキシ設定をサポートしていません。バージョン 2.2.2 以降では、この機能のサポートが再導入されています。新機能このコンポーネントにサポートを追加して、データを AWS IoT SiteWiseにアップロードするときに圧縮を切り替えます。
2.2.0	注記このバージョンはHTTPプロキシ設定をサポートしていません。バージョン 2.2.2 以降では、この機能のサポートが再導入されています。新機能データを圧縮してから AWS IoT SiteWise サービスに送信するようにこのコンポーネントを更新。ほとんどの場合、この変更により、コンポーネントの以前のバージョンと比較して、帯域幅の使用量が 75% 削減されます。ほとんどの場合、この変更によりCPU使用量が最大 5% 増加します。大量のデータを処理するゲートウェイでは、この変更によりCPU使用量が最大 15% 増加する可能性があります。この変更は、 AWS IoT SiteWise サービス料金やサービスクォータの使用には影響しません。 Windows Server 2019 以降のサポートを追加。バグ修正と機能向上チェックポイントファイルが破損しているときにこのコンポーネントを起動できない問題を修正。
2.1.4	バグ修正と機能向上 Java バージョン 8 との互換性を修正。
2.1.3	警告このバージョンは、米国東部 (オハイオ）、カナダ (中部）、 AWS GovCloud および (米国東部) の各リージョンを除き、利用できなくなりました。このコンポーネントバージョンを実行するには Java バージョン 11 以上が必要です。このバージョンの改善は、このコンポーネントのそれ以降のバージョンで利用できます。バグ修正と機能向上サポートされていないデバイスにこのコンポーネントをデプロイするときのエラーメッセージが改善。データのアップロードが失敗したときにエラーをログに記録するように更新。
2.1.2	バグ修正と機能向上データの有効期限が切れ次第、期限切れのデータエクスポート機能を呼び出すように更新。
2.1.1	バグ修正と機能向上。
2.1.0	新機能最新のデータをクラウドに最初に公開するためのサポートを追加。期限切れのデータをクラウドに公開しないためのサポートを追加。期限切れのデータをローカルに保存するためのサポートを追加。バグ修正と機能向上ディスク I/O とそれに対応するレイテンシーを削減。
2.0.2	バグ修正と機能向上。
2.0.1	当初のバージョン