View a markdown version of this page

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

翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

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

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

注記

パブリッシャーの設定は、使用しているゲートウェイのタイプによって異なります。Classic ストリーム、V2 ゲートウェイの場合は、 iotsitewise:publisher:2名前空間を使用します。MQTT 対応 V3 ゲートウェイの場合は、 iotsitewise:publisher:3名前空間を使用します。

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. [保存] を選択します。

AWS CLI

UpdateGatewayCapabilityConfiguration API を使用してパブリッシャーを設定します。

capabilityNamespace パラメータを iotsitewise:publisher:2 に設定します。

例: Classic Stream、V2 ゲートウェイのパブリッシャー設定

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

{
    "SiteWisePublisherConfiguration": {                               
        "publishingOrder": "TIME_ORDER",
        "enableCompression": true,
        "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
                }
            }
        ]
    }
}

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

SiteWisePublisherConfiguration
publishingOrder

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

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

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

enableCompression

公開前にデータを圧縮trueするには、これを に設定します。データ圧縮により、帯域幅の使用量を減らすことができます。

dropPolicy

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

cutoffAge

日、時間、分で指定された、公開されるデータの最大期間。例えば、7d、1d7h16m です。指定したよりも古いデータは送信されませんAWS IoT SiteWise。

カットオフ期間より前のデータはクラウドに公開されません。カットオフ期間は 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 に設定します。