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

# AWS IoT SiteWise パブリッシャーコンポーネントを設定する
<a name="configure-publisher-component"></a>

 AWS IoT SiteWise Edge ゲートウェイを作成してソフトウェアをインストールしたら、SiteWise Edge ゲートウェイがデータを AWS クラウドにエクスポートできるようにパブリッシャーコンポーネントを設定できます。パブリッシャーコンポーネントを使用して、追加機能を有効にしたり、デフォルト設定を設定したりできます。詳細については、「*AWS IoT Greengrass Version 2 開発者ガイド*」の「[AWS IoT SiteWise パブリッシャー](https://docs.aws.amazon.com/greengrass/v2/developerguide/iotsitewise-publisher-component.html)」を参照してください。

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

------
#### [ Console ]

1. [AWS IoT SiteWise コンソール](https://console.aws.amazon.com/iotsitewise/)に移動します。

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

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

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

1. **[発行の順序]** では、次のいずれかを選択します。
   + **[最も古いデータを最初に発行する]** – デフォルトでは、SiteWise Edge ゲートウェイは最も古いデータを最初にクラウドに発行します。
   + **[最も新しいデータを最初に発行する]** – SiteWise Edge ゲートウェイは最も新しいデータを最初にクラウドに発行します。

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

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

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

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

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

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

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

1. **[保存]** を選択します。

------
#### [ AWS CLI ]

[UpdateGatewayCapabilityConfiguration](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_UpdateGatewayCapabilityConfiguration.html) API を使用してパブリッシャーを設定します。

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

**Example : Classic Streams、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` に設定します。

------