AWS IoT SiteWise パブリッシャーコンポーネントを設定する

AWS IoT SiteWise Edge ゲートウェイを作成してソフトウェアをインストールしたら、SiteWise Edge ゲートウェイがデータを AWS クラウドにエクスポートできるようにパブリッシャーコンポーネントを設定できます。パブリッシャーコンポーネントを使用して、追加機能を有効にしたり、デフォルト設定を設定したりできます。詳細については、「AWS IoT Greengrass Version 2 開発者ガイド」の「AWS IoT SiteWise パブリッシャー」を参照してください。

Console

1. AWS IoT SiteWise コンソールに移動します。

2. ナビゲーションペインで、[Edge ゲートウェイ] を選択します。

3. パブリッシャーを設定する SiteWise Edge ゲートウェイを選択します。

4. [パブリッシャーの設定] セクションで、[編集] を選択します。

5. [発行の順序] では、次のいずれかを選択します。

   • [最も古いデータを最初に発行する] – デフォルトでは、SiteWise Edge ゲートウェイは最も古いデータを最初にクラウドに発行します。

   • [最も新しいデータを最初に発行する] – SiteWise Edge ゲートウェイは最も新しいデータを最初にクラウドに発行します。

6. (オプション) SiteWise Edge ゲートウェイがデータを圧縮しないようにする場合は、[データのアップロード時に圧縮をアクティブ化] の選択を解除します。

7. (オプション) 古いデータを発行しない場合は、[期限切れデータを除外する] を選択し、以下を実行します。

   1. [カットオフ期間] には、値を入力して、単位を選択します。カットオフ期間は 5 分から 7 日の間でなければなりません。例えば、カットオフ期間が 3 日間の場合、3 日間より前のデータはクラウドに発行されません。

8. (オプション) ローカルデバイスでのデータの処理方法に関するカスタム設定を設定するには、[ローカルストレージ設定] を選択し、以下を実行します。

   1. [保持期間] には、数値を入力して単位を選択します。保持期間は 1 分から 30 日の間で、ローテーション期間と同じかそれ以上でなければなりません。例えば、保持期間が 14 日間の場合、SiteWise Edge ゲートウェイは、データを 14 日間保存した後、指定されたカットオフ期間より前のデータをエッジから削除します。

   2. [ローテーション期間] には、数値を入力して単位を選択します。ローテーション期間は 1 分より大きく、保持期間と同じかそれ以下でなければなりません。例えば、ローテーション期間が 2 日間の場合、SiteWise Edge ゲートウェイは、カットオフ期間より前のデータをバッチ処理して 1 つのファイルとして保存します。 AWS IoT Greengrass V2を介したセルフホストゲートウェイの場合、SiteWise Edge ゲートウェイは 2 日に 1 回、データのバッチを次のローカルディレクトリに転送します。/greengrass/v2/work/aws.iot.SiteWiseEdgePublisher/exports

   3. [ストレージ容量] には、1 以上の値を入力します。ストレージ容量が 2 GB の場合、SiteWise Edge ゲートウェイは、ローカルのデー保存量が 2 GB を超えると、データの削除を開始します。

9. [Save] を選択します。

AWS CLI

UpdateGatewayCapabilityConfiguration API を使用してパブリッシャーを設定できます。capabilityNamespace パラメータを iotsitewise:publisher:2 に設定します。

パブリッシャーには以下の設定パラメータがあり、カスタマイズすることができます。

SiteWisePublisherConfiguration

publishingOrder

データがクラウドに公開される順序。このパラメーターは、次のいずれかの値をとることができます。

• TIME_ORDER (古い順にデータを公開) – デフォルトでは、データは古い順にクラウドに公開されます。

• RECENT_DATA (新しい順にデータを最初) – データは新しい順にクラウドに公開されます。

dropPolicy

(オプション) クラウドに公開するデータを制御するポリシー。

cutoffAge

カットオフ期間より前のデータはクラウドに公開されません。カットオフ期間は 5 分から 7 日の間でなければなりません。

dカットオフ期間を指定すると mと h、を使用できます。m は分数、hは時数、dは日数を表します。

exportPolicy

(オプション) エッジのデータストレージを管理するポリシー。このポリシーは、カットオフ期間より前のデータに適用されます。

retentionPeriod

SiteWise Edge ゲートウェイは、指定された保持期間の間データを保存した後、カットオフ期間より前のデータをローカルストレージから削除します。保持期間は 1 分から 30 日の間で、ローテーション期間と同じかそれ以上でなければなりません。

d保持期間を指定すると、mと h、を使用できます。m は分数、hは時数、dは日数を表します。

rotationPeriod

カットオフ期間より前のデータをバッチ処理して 1 つのファイルとして保存する時間間隔。SiteWise Edge ゲートウェイは、各ローテーション期間の終了時に 1 バッチ分のデータを以下のローカルディレクトリ (/greengrass/v2/work/aws.iot.SiteWiseEdgePublisher/exports) に転送します。ローテーション期間は 1 分より大きく、保持期間と同じかそれ以下でなければなりません。

ローテーション期間を指定すると、mと h、dを使用できます。m は分数、hは時数、dは日数を表します。

exportSizeLimitGB

ローカルに保存されるデータの最大許容サイズ (GB 単位)。このクォータを超えた場合、SiteWise Edge ゲートウェイは、ローカルに保存されているデータのサイズがクォータ以下になるまで、最も古いデータから削除を開始します。このパラメータの値は、1 以上である必要があります。

SiteWiseS3PublisherConfiguration

accessRoleArn

発行先の Amazon S3 バケットを管理するアクセス AWS IoT SiteWise 許可を に付与するアクセスロール。

streamToS3ConfigMapping

ストリームを Amazon S3 設定にマッピングする設定の配列。

streamName

Amazon S3 設定から読み取られ、発行されるストリーム。

targetBucketArn

発行先のバケット ARN。

publishPolicy

publishFrequency

SiteWise Edge ゲートウェイが Amazon S3 バケットに発行する頻度。

localSizeLimitGB

ローカルディスクに書き込まれるファイルの最大サイズ。このしきい値を超えると、パブリッシャーはバッファされたすべてのデータを宛先に発行します。

siteWiseImportPolicy

enableSiteWiseStorageImport

Amazon S3 バケットから AWS IoT SiteWise ストレージにデータをインポートtrueするには、これを に設定します。

enableDeleteAfterImport

AWS IoT SiteWise ストレージへの取り込み後に Amazon S3 バケット内のファイルを削除するには、これを true に設定します。

例 パブリッシャー設定:

パブリッシャーの名前空間: iotsitewise:publisher:2

{
    "SiteWisePublisherConfiguration": {                               
        "publishingOrder": "TIME_ORDER",
        "dropPolicy": {
            "cutoffAge": "7d",
            "exportPolicy": {
                "retentionPeriod": "7d",
                "rotationPeriod": "6h",
                "exportSizeLimitGB": 10
            }
        }
    },
    "SiteWiseS3PublisherConfiguration": {
        "accessRoleArn": "arn:aws:iam:123456789012:role/roleName",
        "streamToS3ConfigMapping": [
            {
                "streamName": "S3_OPC-UA_Data_Collector",
                "targetBucketArn": "arn:aws:s3:::amzn-s3-demo-bucket/dataCollector",
                "publishPolicy": {
                    "publishFrequency": "10m",
                    "localSizeLimitGB": 10
                },
                "siteWiseImportPolicy": {
                    "enableSiteWiseStorageImport": true,
                    "enableDeleteAfterImport": true
                }
            }
        ]
    }
}