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

# AWS IoT SiteWise Edge リアルタイム送信先を追加する
<a name="destinations-real-time"></a>

リアルタイム送信先タイプを使用すると、デバイスやゲートウェイから IoT データをリアルタイムで AWS IoT SiteWise ストレージに直接ストリーミングできます。このオプションは、バッチ処理やバッファリングを必要とせずに、生成時にデータの即時取り込みと処理を必要とするユースケースに最適です。データが継続的にストリーミングされるため、各ゲートウェイで設定できるリアルタイム送信先は 1 つだけです AWS IoT SiteWise。

**注記**  
TQVs重複すると、二重課金が発生する可能性があります。

**リアルタイム送信先を追加するには**

 AWS IoT SiteWise コンソールまたは AWS CLI を使用して、SiteWise Edge MQTT 対応ゲートウェイにリアルタイムの送信先を追加します。

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

1. [AWS IoT SiteWise コンソール](https://console.aws.amazon.com/iotsitewise/) を開きます。

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

1. 送信先を追加するゲートウェイを選択します。

1. 送信**先** セクションで、送信**先の追加** を選択します。

1. **送信先の追加**ページで、送信**先の詳細**を入力します。

   1. 送信先名フィールドの送信**先の名前**。

   1. **送信先タイプの****AWS IoT SiteWise リアルタイム**を選択します。

1. ゲートウェイの発行順序を設定するには、**発行順序**を**古いデータを最初に発行**するか**、最新のデータを最初に発行**します。デフォルトでは、ゲートウェイは最も古いデータを最初に公開します。

1. **最大バッチ待機時間**を使用して、パブリッシャーがデータのバッチを送信する前に待機する最大時間を設定します AWS IoT SiteWise。この設定はエイリアスごとに適用されます。データは、次のいずれかになるまでローカルに保存されます。
   + 設定時間が経過した、または
   + エイリアスに対して 10 個の time-quality-value (TQV) エントリが受信されます

   どの条件が満たされても、最初にバッチがクラウドに送信されます。

1. アップロードされたデータを圧縮するには、**データのアップロード時に圧縮を有効にする**チェックボックスをオンにします。クラウドにアップロードする前にゲートウェイにデータを圧縮させると、帯域幅の使用量が減少します。

1. 期限切れのパブリッシャーデータをフィルタリングするには、**期限切れのデータを除外**チェックボックスをオンにします。この選択は、アクティブデータと現在のデータのみを に送信します AWS IoT SiteWise。

1. **カットオフ期間**フィールドに、データセット内でデータが期限切れと見なされる頻度を入力します。データが分単位または日単位でカウントされるかどうかを判断できます。最小カットオフ期間は 5 分です。最大カットオフ期間は 7 日間です。

1. 必要に応じて、**ローカルストレージの設定**を行います。

   1. **保持期間**の頻度を設定する – ゲートウェイがカットオフ期間より古いデータをローカルに保存する時間。最小保持期間は 1 分です。

      最大保持期間は 30 日間で、ローテーション期間以上です。

   1. **ローテーション期間**の設定 – 1 つのファイルのカットオフ期間より古いデータを保存するときに指定する時間間隔。ゲートウェイは、各ローテーション期間の終了時に 1 バッチ分のデータをローカルディレクトリ (`/greengrass/v2/work/aws.iot.SiteWiseEdgePublisher/exports`) に転送します。

      保持期間は 1 分以上で、保持期間と同じである必要があります。

   1. **ストレージ容量 (GB)** 値を指定して、ローカルに保存されるデータの最大サイズを GB 単位で設定します。データが決定された最大ローカルストレージサイズを超える場合、ゲートウェイは最初に最も古いデータの削除を開始します。ゲートウェイは、ローカルに保存されているデータのサイズがクォータ以下になるまで削除を続けます。

      ストレージ容量は 1 GB 以上である必要があります。

1. パスフィルターを送信先に追加します。詳細については、[AWS IoT SiteWise Edge 送信先にパスフィルターを追加する](destinations-add-path-filters.md) を参照してください。

詳細については、「[送信先タイプ](gw-destinations.md#destination-types)」を参照してください。

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

**Example : AWS IoT SiteWise 新しいリアルタイム送信先を作成する**  
[UpdateGatewayCapabilityConfiguration](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_UpdateGatewayCapabilityConfiguration.html) API を使用してパブリッシャーを設定します。  
`capabilityNamespace` パラメータを `iotsitewise:publisher:3` に設定します。  

```
{
    "sources": [
        {
            "type": "MQTT"
        }
    ],
    "destinations": [
        {
            "type": "SITEWISE_REALTIME",
            "name": "your-destination-name",
            "config": {
                "publishingOrder": "TIME_ORDER",
                "enableCompression": true,
                "maxBatchWaitTime": "10s"
            },
            "filters": [
                {
                    "type": "PATH",
                    "config": {
                        "paths": [
                            "#"
                        ]
                    }
                }
            ]
        }
    ]
}
```

既存の AWS IoT SiteWise リアルタイム送信先を更新するには、まず `DescribeGatewayCapabilityConfiguration` API を使用して を検索します`destinationId`。

**Example : AWS IoT SiteWise リアルタイム送信先を更新する**  
[UpdateGatewayCapabilityConfiguration](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_UpdateGatewayCapabilityConfiguration.html) API を使用してパブリッシャーを設定します。  
`capabilityNamespace` パラメータを `iotsitewise:publisher:3` に設定します。  

```
{
    "sources": [
        {
            "type": "MQTT"
        }
    ],
    "destinations": [
        {
            "id": "your-existing-destination-id",
            "type": "SITEWISE_REALTIME",
            "name": "your-destination-name",
            "config": {
                "publishingOrder": "TIME_ORDER",
                "enableCompression": true,
                "dropPolicy": {
                    "cutoffAge": "7d",
                    "exportPolicy": {
                        "retentionPeriod": "7d",
                        "rotationPeriod": "6h",
                        "exportSizeLimitGB": 10
                    }
                },
                "maxBatchWaitTime": "10s"
            },
            "filters": [
                {
                    "type": "PATH",
                    "config": {
                        "paths": [
                            "#"
                        ]
                    }
                }
            ]
        }
    ]
}
```

以下の設定オプションは、 `iotsitewise:publisher:3`名前空間を使用するゲートウェイに固有です。

`sources`  
産業機器から にデータを転送するためのデータソースを定義します AWS IoT SiteWise。MQTT 対応ゲートウェイの場合は、 を使用します`MQTT`。  
タイプ: オブジェクトの配列  
必須: はい

`destinations`  
データの送信先を定義します。送信先は、Amazon S3 を使用してリアルタイムまたはバッファリングされます。少なくとも 1 つの送信先オブジェクトが必要ですが、空の配列を追加できます。ゲートウェイごとに 1 つのリアルタイム送信先を設定できます。詳細については、「[AWS IoT SiteWise Edge の送信先を理解する](gw-destinations.md#source-destination)」を参照してください。  
タイプ: オブジェクトの配列  
必須: はい    
`id`  
送信先の一意の識別子。既存の送信先 ID を指定するか、空白のままにすることができます。ID を指定しない場合、UUID はデフォルトで生成されます。  
タイプ: 文字列  
必須: いいえ  
`type`  
タイプ: 宛先 オプションには、 `SITEWISE_REALTIME`と があります`SITEWISE_BUFFERED`。  
+ `SITEWISE_REALTIME` – データをリアルタイムでストレージに直接 AWS IoT SiteWise 送信します。
+ `SITEWISE_BUFFERED` – Parquet 形式でデータをバッチで Amazon S3 に送信し、 AWS IoT SiteWise ストレージにインポートします。
タイプ: 文字列  
必須: はい  
`name`  
送信先の一意の名前。  
タイプ: 文字列  
必須: はい  
`config`  
JSON 形式の送信先タイプに固有の設定。設定は、リアルタイム送信先とバッファされた送信先によって異なります。  
型: オブジェクト  
必須: はい    
publishingOrder  
データが公開される順序を決定します。データはタイムスタンプに基づいて発行されます。オプションには、 `TIME_ORDER`と が含まれます`RECENT_DATA`。  
+ `TIME_ORDER` (デフォルト) — 古いデータを最初に公開します。
+ `RECENT_DATA` – 最新のデータを最初に公開します。
タイプ: 文字列  
必須: いいえ  
enableCompression  
に設定すると`true`、送信前のデータ圧縮が有効になります AWS IoT SiteWise。クラウドにアップロードする前にゲートウェイにデータを圧縮させると、帯域幅の使用量が減少します。デフォルト値は `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 以上である必要があります。

    タイプ: 整数

    必須: いいえ  
`maxBatchWaitTime`  
パブリッシャーがデータのバッチを送信する前に待機する最大時間を設定します AWS IoT SiteWise。この設定はエイリアスごとに適用されます。データは、次のいずれかになるまでローカルに保存されます。  
+ 設定時間が経過した、または 
+ エイリアスに対して 10 個の time-quality-value (TQV) エントリが受信されます
`m`カットオフ時間を指定する`d`には、、`h`、および を使用します。`m` は分数、`h`は時数、`d`は日数を表します。  
タイプ: 文字列  
必須: いいえ

`filters`  
データに適用するフィルタ。少なくとも 1 つのフィルターが必要です。  
タイプ: 文字列  
必須: はい    
`type`  
フィルターのタイプ。`PATH` を使用します。  
タイプ: 文字列  
必須: はい  
`config`  
JSON 形式のフィルタータイプに固有の設定。少なくとも 1 つのオブジェクトが必要ですが、配列は空にすることができます。  
型: オブジェクト  
必須: はい  
+ `paths`

  パスフィルターの配列。詳細については、「[AWS IoT SiteWise Edge 送信先のパスフィルターを理解するUnderstand path filters](gw-destinations.md#destinations-path-filters)」を参照してください。デフォルトのパスは `#` です。

  型: 文字列の配列

  必須: はい

------