翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
# 送信先とパスフィルター
AWS IoT SiteWise Edge の送信先は、産業用データがエッジデバイスからクラウドにどのように流れるかを管理するための柔軟で効率的な方法を提供します。このセクションでは、送信先を設定し、パスフィルターを使用して特定のデータストリームをルーティングし、ユースケースに適した送信先タイプを選択する方法について説明します。
でホストされている AWS IoT SiteWise Edge アプリケーションと組み合わせて使用するセルフホスト MQTT 対応、V3 ゲートウェイ、およびゲートウェイで、送信先とパスフィルターを使用できますSiemens Industrial Edge。送信先とパスフィルターは、 Classic Streams、V2 ゲートウェイでは機能しません。
**Topics**
+ [AWS IoT SiteWise Edge の送信先を理解する](#source-destination)
+ [AWS IoT SiteWise Edge 送信先のパスフィルターを理解する](#destinations-path-filters)
+ [AWS IoT SiteWise Edge リアルタイム送信先を追加する](destinations-real-time.md)
+ [Amazon S3 を使用して AWS IoT SiteWise バッファされた送信先を追加する](destinations-buffered.md)
+ [AWS IoT SiteWise Edge 送信先にパスフィルターを追加する](destinations-add-path-filters.md)
+ [AWS IoT SiteWise Edge の送信先を管理する](destinations-manage.md)
## AWS IoT SiteWise Edge の送信先を理解する
AWS IoT SiteWise Edge の送信先を使用して、ソースデータの送信先を決定します。コスト効率、低レイテンシー、ストレージ要件など、必要な特定の特性に基づいてデータ送信先を選択できます。、当社のパートナー AWS IoT SiteWise、またはカスタムアプリケーションによってキャプチャされたデバイスデータを統合して、エッジでパスフィルター (トピック) を発行およびサブスクライブします。その後、デバイスデータをモデル化、転送、クラウドに保存できます。
**注記**
セルフホストゲートウェイのすべての送信先機能を最大限に活用するには、最新バージョンの IoT SiteWise パブリッシャーと IoT SiteWise OPC UA コレクターにアップグレードします。ストリームのサポートは、既存のセットアップとの互換性を維持するために、 Classic ストリーム、V2 ゲートウェイで継続されます。詳細については、[AWS IoT SiteWise Edge 用のクラシックストリーム、V2 ゲートウェイ](classic-streams-v2-gateway.md)を参照してください。
**Topics**
+ [SiteWise Edge の送信先がデータ管理を強化する方法](#how-destinations-work)
+ [送信先タイプ](#destination-types)
+ [ゲートウェイバージョン間で送信先機能を比較する](#destinations-vs-publisher-component)
+ [送信先の制限](#destinations-limitiations)
+ [SiteWise Edge 送信先のユースケース](#destinations-use-cases)
### SiteWise Edge の送信先がデータ管理を強化する方法
エッジから AWS IoT SiteWise にリアルタイムで、または Amazon S3 を使用してバッチでデータをエクスポートします。
送信先により AWS IoT SiteWise 、環境の柔軟性とスケーラビリティが向上します。送信先は一元化されたデータ管理モデルを実装し、ソースはデータを中央システムに発行します。送信先は、パスフィルターを使用してデータの送信先を決定します。送信先は、複数のパスフィルターをサブスクライブできます。
MQTT 対応ゲートウェイは、セルフホスト型か で実行されているかにかかわらずSiemens Industrial Edge、ローカル通信に MQTT を使用し、フィルターが に設定されたデフォルトのリアルタイム送信先が付属しています`#`。つまり、デフォルトでは、すべてのトピックのすべてのメッセージが AWS IoT SiteWise リアルタイム送信先に発行されます。詳細については、「[AWS IoT SiteWise Edge 送信先のパスフィルターを理解するUnderstand path filters](#destinations-path-filters)」を参照してください。各ゲートウェイに 1 つのリアルタイム送信先を追加できます。
### 送信先タイプ
ゲートウェイの送信先を設定する場合、2 つの主なオプションがあります。 を使用したリアルタイム設定と AWS IoT SiteWise、Amazon S3 を使用したバッファ設定です。各送信先タイプには、独自の設定と考慮事項のセットがあります。
**AWS IoT SiteWise リアルタイム設定**
これを選択すると、データを AWS IoT SiteWise ホット階層ストレージに直接送信し、リアルタイムでデータの取り込みとモニタリングを容易にします。リアルタイム設定は、特にゲートウェイでクラウドとの接続の問題が発生した場合に、データフローを管理します。接続が失われると、データはゲートウェイに一時的にローカルに保存されます。接続が再確立されると、保存されたデータは自動的にクラウドに送信されます。
ローカルに保存されるデータの最大量、再接続時にクラウドにデータを送信する速度、ストレージが容量に達した後にデータを削除するタイミングなど、データ公開プロセスのさまざまな側面を調整できます。
AWS IoT SiteWise ストレージ階層の詳細については、「」を参照してください[でデータストレージを管理する AWS IoT SiteWise](manage-data-storage.md)。
**AWS IoT SiteWise Amazon S3 設定を使用してバッファリング**
この送信先タイプを使用すると、ゲートウェイでローカルにデータをバッファし、定期的に Amazon S3 バケットにバッチで送信できます。データは効率的な Parquet 形式で保存され、分析ワークロード用に最適化されています。データが Amazon S3 に保存されたら、そのデータを にインポートして AWS IoT SiteWise 保存、処理、分析できます。
データをバッチで取り込み、履歴データを費用対効果の高い方法で保存するには、このオプションを選択します。任意の Amazon S3 バケットの場所と、Amazon S3 にデータをアップロードする頻度を設定できます。 AWS IoT SiteWiseへの取り込み後にデータを処理する方法を選択することもできます。SiteWise と Amazon S3 の両方でデータを使用できるようにするか、Amazon S3 から自動的にデータを削除するかを選択できます。
### ゲートウェイバージョン間で送信先機能を比較する
MQTT 対応ゲートウェイの送信先機能は、データフロー管理を合理化します。送信先は、さまざまなエンドポイントへのデータルーティングを一元的に設定することで、データ管理を簡素化します。このアプローチにより、複雑な個別のストリーム設定が不要になり、システム全体の柔軟性と管理が容易になります。
これに対して、Classic ストリーム、V2 ゲートウェイ、SiteWise Edge AWS IoT Greengrass は、データソースからパブリッシャーにストリーム経由でデータを送信し、データソースごとにデータ送信先を個別に設定します。
AWS IoT SiteWise 送信先機能を使用すると、パブリッシャーのルーティング設定が統合されます。送信先設定を使用すると、送信先とパスフィルターを一元的に管理できます。必要に応じて、送信先の追加、パスフィルターの管理、不要なフィルターや送信先の削除を簡単に行うことができます。
さらに、送信先機能は、産業用 IoT アプリケーションで広く使用されている業界標準プロトコルである MQTT (Message Queuing Telemetry Transport) を使用します。この MQTT の導入により AWS IoT SiteWise 、さまざまなデバイスやシステムとの統合が容易になります。
### 送信先の制限
SiteWise Edge ゲートウェイの送信先に関する現在の制限は次のとおりです。
+ データ処理パックは MQTT 対応ゲートウェイではサポートされていません。
+ データ型のサポートは AWS IoT SiteWise データ型に限定されます。データ型変換を有効にする方法については、「」を参照してください[サポートされていないデータ型の変換](string-conversion.md)。
### SiteWise Edge 送信先のユースケース
SiteWise Edge の送信先は、さまざまなアプリケーションで使用されます。主な例をいくつか示します。
**産業用オートメーション***リアルタイムモニタリングと予測メンテナンス*
産業環境では、ファクトリーフロアのセンサーとデバイスが SiteWise Edge にデータを発行できます。送信先は、関連するデータをフィルタリングしてルーティングするように設定できるため、マシンのパフォーマンスをリアルタイムでモニタリングおよび分析できます。パスフィルターを使用して関連する MQTT トピックにサブスクライブし、データを処理してから、処理されたデータを公開できます。このようにして、処理されたデータを AWS クラウド分析サービスまたはオンプレミスシステムに選択的にルーティングできます。その後、製造元は予測メンテナンス戦略を実装し、生産プロセスを最適化して、ダウンタイムを削減できます。
**スマートビル***エネルギー効率と占有率の最適化*
ビルディングオートメーションシステムは、データストリームを生成して、HVAC システム、照明、アクセスコントロールなど、ビルディングのさまざまな側面を監視および制御します。SiteWise Edge を使用すると、これらのデータストリームを取り込み、処理し、さまざまな送信先にルーティングできます。施設マネージャーは、関連するデータをフィルタリングして転送するように送信先を設定できます。これにより、データのプライバシーとコンプライアンスを確保しながら、エネルギー効率の測定や占有率の最適化などの高度な機能が可能になります。
これらのユースケースは、SiteWise Edge の Destinations 機能を活用して、さまざまな業界でデータを効率的に取り込み、処理し、ルーティングする方法を示しています。これにより、データのプライバシーとコンプライアンスを確保しながら、リアルタイムモニタリング、予測メンテナンス、エネルギー効率、リモート診断などの高度な機能が可能になります。
## AWS IoT SiteWise Edge 送信先のパスフィルターを理解する
**Topics**
+ [パスフィルターの要件](#path-filter-requirements)
+ [パスフィルターのベストプラクティス](#create-effective-path-filters)
+ [OPC UA サーバーのパスフィルター](#path-filters-opcua)
+ [パスフィルター名の特殊文字](#path-filters-special-characters)
各送信先は、 AWS IoT SiteWise または Amazon S3 にデータをルーティングするように設定されています。パスフィルターを使用すると、送信先の MQTT メッセージを受信するときにフィルタリングする特定のデータを選択できます。パスフィルターは、データストリームの論理名を表し、目的の MQTT トピックのサブスクリプションとして機能します。
MQTT では、データはトピックに編成されます。トピックは、スラッシュ () で区切られた階層文字列です`/`。たとえば、デバイスは温度データをトピック に発行する場合があります`home/livingroom/sensor1/temperature`。ここで、 `home/livingroom/sensor1`はセンサーのパスまたは論理名を表し、 `temperature`は発行されるデータ型を表します。
パスフィルターを使用して、ワイルドカード (`+` および ) を使用して特定のトピックまたはトピックの範囲をサブスクライブできます`#`。`+` ワイルドカードは、トピック階層の 1 つのレベルに一致します。たとえば、 `home/+/sensor1/temperature`は `home/livingroom/sensor1/temperature`と に一致します`home/bedroom/sensor1/temperature`。`#` ワイルドカードは、フィルターの最後に使用すると、複数のレベルに一致します。
パスフィルター名内の MQTT 仕様では通常許可されていないさまざまな文字を使用することもできます。これらの文字は、名前内で使用する場合、ワイルドカードとして機能しません。 は、元の命名構造を維持しながら MQTT コンプライアンスを確保するために、エンコードを使用してこれらの文字を AWS IoT SiteWise 変換します。この機能は、他のシステムからの既存の命名規則に対応するために特に役立ちます。詳細については、「[パスフィルター名の特殊文字](#path-filters-special-characters)」を参照してください。
適切なパスフィルターを慎重に選択することで、特定の送信先に送信されるデータを制御できます。パスフィルターを使用して、データフローを IoT システムの要件に合わせて調整します。
### パスフィルターの要件
を使用してパスフィルターを入力するときは AWS IoT SiteWise コンソール、次の点に注意してください。
+ パスフィルターは新しい行で区切られ、各行は個別のパスフィルターを表します。
+ 個々のパスフィルターは 1～65,535 バイトです。
+ パスフィルターを空白にすることはできません。
+ Null 値 (U\$10000) は使用できません。
+ 一度に最大 100 個のパスフィルターまたは 65,535 文字を入力できます。どちらか早い方の制限に達しています。
+ 全体的な制限は、ゲートウェイ上のすべての送信先の合計で 20,000 パスフィルターです。
+ パスフィルター名内で `%`、`#`、`+`、および `$`文字を使用できますが、 AWS IoT SiteWise は自動的に URI エンコーディングに変換します。
### パスフィルターのベストプラクティス
AWS IoT SiteWise 送信先のパスフィルターを作成するときは、データを効果的に管理するために以下の戦略を検討してください。
+ デバイス階層をミラーリングするようにフィルターを構造化します。例えば、製造設定 では、 は異なる生産ラインのすべてのマシンからデータを`factory/+/machine/#`キャプチャします。
+ デバイスタイプ、場所、または関数に特定のレベルを使用します。例えば、`factory/assembly-line/robot/temperature`。または、スマート農業では、 を使用して`farm/+/crop/+/moisture`、さまざまな分野のさまざまな作物の湿度レベルをモニタリングします。
+ ワイルドカードを戦略的に活用する: 単一レベルでバリエーション`+`に を使用し、後続のすべてのレベル`#`をキャプチャします。例えば、 は`building/+/+/energy-consumption`、建物内のさまざまなゾーンや床のエネルギー使用量を追跡します。これは、最初の がすべてのフロアを`+`キャプチャし、2 番目の がすべてのゾーンを`+`キャプチャすることを前提としています。
+ 関連するデータをキャプチャするのに十分なだけ、将来の変更に対応するのに十分な柔軟性を持つフィルターを作成して、特異性と柔軟性のバランスを取ります。たとえば、 `site/+/equipment-type/+/measurement`では、フィルター構造を変更せずに新しいサイトや機器タイプを追加することができます。
フィルターを徹底的にテストして、意図したデータをキャプチャし、IoT システムのアーキテクチャと目標に沿っていることを確認します。
### OPC UA サーバーのパスフィルター
OPC UA サーバーの場合、パスフィルターは OPC UA タグ名に対応している必要があります。パスフィルターの最終レベルは、OPC UA タグ名と完全に一致する必要があります。たとえば、OPC UA タグが の場合`Device1.Temperature`、パスフィルターは になります`factory/line1/Device1.Temperature`。などの前述のレベルでワイルドカードを使用して、複数の生産ラインでタグを`factory/+/Device1.Temperature`キャプチャできます。パスフィルター名に特殊文字がある場合は、[パスフィルター名の特殊文字](#path-filters-special-characters)「」を参照してください。
### パスフィルター名の特殊文字
AWS IoT SiteWise は、OPC UA などの産業用プロトコルで一般的に使用される文字に対応します。通常、標準 MQTT トピック名では許可されません。この機能は、産業システムと MQTT ベースのアーキテクチャのスムーズな統合を容易にします。
**注記**
特殊文字の処理は統合と移行に役立ちますが、互換性を高めるために、可能な場合は新しい実装の標準の MQTT 命名規則に従うことをお勧めします。
産業ソースからデータを受信すると、 は特殊文字の URI エンコードを使用してトピック名を AWS IoT SiteWise 正規化します。
+ `%` は になります `%25` (最初にエスケープ文字としてエンコードされます)
+ `#` が `%23` になります
+ `+` が `%2B` になります
+ `$` は になります `%24` (トピックの開始時にのみ)
このエンコーディングにより、これらの特別な MQTT 文字を含むソースデータを MQTT トピック名として安全に使用できると同時に、元の産業命名規則を維持できます。
**Example : パスフィルター名の特殊文字**
AWS IoT SiteWise パスフィルターで産業トピック名がどのように表示されるかの例を次に示します。
+ `Factory1/Line#2/Sensor+3` が `Factory1/Line%232/Sensor%2B3` になります
+ `Plant%A/Unit$1/Temp` が `Plant%25A/Unit%241/Temp` になります
+ `Site1/#Section/+Node` が `Site1/%23Section/%2BNode` になります
でサブスクリプションを作成したり、トピック名を表示したりすると AWS IoT SiteWise、エンコードされていない元のバージョンが表示されます。エンコードは自動的に処理され、MQTT コンプライアンスが確保されます。
# AWS IoT SiteWise Edge リアルタイム送信先を追加する
リアルタイム送信先タイプを使用すると、デバイスやゲートウェイから 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)」を参照してください。デフォルトのパスは `#` です。
型: 文字列の配列
必須: はい
------
# Amazon S3 を使用して AWS IoT SiteWise バッファされた送信先を追加する
バッファされた送信先タイプを使用すると、データをリアルタイムで必要と AWS IoT SiteWise しない場合に、取り込みコストを節約できます。これにより、IoT データを Amazon S3 バケットに一時的に保存してからインポートできます AWS IoT SiteWise。または、データを S3 にアップロードして保存することもできます。インポートする予定があるかどうかは関係ありません AWS IoT SiteWise。これは、デバイスやゲートウェイからデータをバッチ処理およびバッファしてから取り込む場合に便利です AWS IoT SiteWise。このオプションでは、データは設定された頻度で Parquet 形式で指定された S3 バケットにアップロードされます。その後、このデータを AWS IoT SiteWise ストレージにインポートして、さらなる分析と処理を行うことができます。
**Amazon S3 を使用してバッファされた送信先を追加するには**
AWS IoT SiteWise コンソールまたは AWS CLI を使用して、Amazon S3 を使用してデータをバッファする送信先を SiteWise Edge ゲートウェイに追加します。
------
#### [ Console ]
AWS マネジメントコンソール を使用して、Amazon S3 を使用してバッファされた AWS IoT SiteWise 送信先を追加します。
1. [AWS IoT SiteWise コンソール](https://console.aws.amazon.com/iotsitewise/) を開きます。
1. ナビゲーションペインで、**[Edge ゲートウェイ]** を選択します。
1. 送信先を追加するゲートウェイを選択します。
1. 送信**先** セクションで、送信**先の追加** を選択します。
1. **送信先の追加**ページで、送信**先の詳細**を入力します。
1. 送信先名フィールドの送信**先の名前**。
1. **AWS IoT SiteWise Amazon S3 for Destination type を使用してバッファされた** を選択します。Amazon S3 を使用して AWS IoT SiteWise バッファされた は、データを Parquet 形式でバッチで Amazon Simple Storage Service に送信し、データをストレージに AWS IoT SiteWise インポートします。 ****
1. ゲートウェイデータを保存する場所の Amazon S3 URL を入力します。パスを参照するには、**Browse S3 **を選択します。バケットが追加されたら、**表示**を選択してバケットを表示することもできます。
1. 時間枠を入力し、データのアップロード頻度の時間増分を選択して、ゲートウェイが Amazon S3 にデータをアップロードする頻度を指定します。 ****頻度値は 0 より大きく、30 日以下である必要があります。
1. **データストレージ設定**で、ゲートウェイデータをインポートした後の対処方法を決定します AWS IoT SiteWise。データストレージについては、次の 2 つの決定事項があります。
+ インポートしたデータを AWS IoT SiteWise ストレージにコピーする場合は、**データをストレージにコピー**チェックボックスをオンにします。このオプションは、設定された Amazon S3 バケットからインポートされたデータを AWS IoT SiteWise ストレージに複製します。
+ Amazon S3 バケットから AWS IoT SiteWise ストレージにデータをインポートすることを選択した場合は、インポートが完了した後にインポートされたデータを削除するかどうかを指定することもできます。**Amazon S3 からデータを削除**チェックボックスをオンにして、 AWS IoT SiteWise ストレージにインポートした後、設定された Amazon S3 バケットからインポートされた日付を削除します。
1. パスフィルターを送信先に追加します。詳細については、[AWS IoT SiteWise Edge 送信先にパスフィルターを追加する](destinations-add-path-filters.md) を参照してください。
------
#### [ AWS CLI ]
**Example : Amazon S3 を使用してバッファされた新しい 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_BUFFERED",
"name": "your-s3-destination-name",
"config": {
"targetBucketArn": "arn:aws:s3:::amzn-s3-demo-bucket/Optional/SomeFolder",
"publishPolicy": {
"publishFrequency": "15m",
"localSizeLimitGB": 10
},
"siteWiseImportPolicy": {
"enableSiteWiseStorageImport": true,
"enableDeleteAfterImport": true,
"bulkImportJobRoleArn": "arn:aws:iam::123456789012:role/your-role-name"
}
},
"filters": [
{
"type": "PATH",
"config": {
"paths": [
"#"
]
}
}
]
}
]
}
```
**Example : Amazon S3 を使用してバッファされた AWS IoT SiteWise 送信先を更新する**
既存の AWS IoT SiteWise リアルタイム送信先を更新するには、まず `DescribeGatewayCapabilityConfiguration` API を使用して を検索します`destinationId`。
パブリッシャーの名前空間: `iotsitewise:publisher:3`
```
{
"sources": [
{
"type": "MQTT"
}
],
"destinations": [
{
"id": "your-existing-destination-id",
"type": "SITEWISE_BUFFERED",
"name": "your-s3-destination-name",
"config": {
"targetBucketArn": "arn:aws:s3:::amzn-s3-demo-bucket/Optional/SomeFolder",
"publishPolicy": {
"publishFrequency": "15m",
"localSizeLimitGB": 10
},
"siteWiseImportPolicy": {
"enableSiteWiseStorageImport": true,
"enableDeleteAfterImport": true,
"bulkImportJobRoleArn": "arn:aws:iam::123456789012:role/your-role-name"
}
},
"filters": [
{
"type": "PATH",
"config": {
"paths": [
"#"
]
}
}
]
}
]
}
```
以下の設定オプションは、 `iotsitewise:publisher:3`名前空間を使用する MQTT 対応ゲートウェイに固有のものです。
`sources`
産業機器から にデータを転送するためのデータソースを定義します AWS IoT SiteWise。MQTT 対応ゲートウェイの場合は、 を使用します`MQTT`。
タイプ: オブジェクトの配列
必須: はい
`destinations`
データの送信先を定義します。送信先は、Amazon S3 を使用してリアルタイムまたはバッファリングされます。少なくとも 1 つの送信先オブジェクトが必要ですが、空の配列を追加できます。ゲートウェイごとに 1 つのリアルタイム送信先を設定できます。詳細については、「[AWS IoT SiteWise Edge の送信先を理解する](gw-destinations.md#source-destination)」を参照してください。
タイプ: オブジェクトの配列
必須: はい
`id`
送信先の一意の識別子。既存の送信先 ID を指定するか、空白のままにすると、送信先に対して新しい ID が自動的に生成されます。
タイプ: 文字列
必須: いいえ
`type`
タイプ: 宛先 オプションには、 `SITEWISE_REALTIME`と があります`SITEWISE_BUFFERED`。`SITEWISE_BUFFERED` を選択してください。
+ `SITEWISE_REALTIME` (デフォルト) – データをリアルタイムで AWS IoT SiteWise ストレージに直接送信します。詳細については、「[AWS IoT SiteWise Edge リアルタイム送信先を追加する](destinations-real-time.md)」を参照してください。
+ `SITEWISE_BUFFERED` – Parquet 形式でデータをバッチで Amazon S3 に送信し、 AWS IoT SiteWise ストレージにインポートします。
タイプ: 文字列
必須: はい
`name`
送信先の一意の名前。
タイプ: 文字列
必須: はい
`config`
JSON 形式の送信先タイプに固有の設定。設定は、リアルタイム送信先とバッファされた送信先によって異なります。
型: オブジェクト
必須: はい
`targetBucketArn`
発行先のバケット ARN。 AWS IoT SiteWise と Amazon S3 の両方 AWS リージョン に同じ を選択します。プレフィックスを選択する場合、1～255 文字である必要があります。
AWS IoT SiteWiseゲートウェイを含む は、指定された S3 バケット全体にアクセスできます。バッファされたデータインジェストには専用バケットを使用することをお勧めします。
タイプ: 文字列
必須: はい
`publishPolicy`
発行ポリシーの詳細。
型: オブジェクト
必須: はい
`publishFrequency`
SiteWise Edge ゲートウェイが Amazon S3 バケットに発行する頻度。Amazon S3 へのデータのアップロード頻度は、0 分以上 30 日以下である必要があります。発行頻度の期間を指定する`d`場合は`m`、、`h`、および を使用できます。`m` は分数、`h`は時数、`d`は日数を表します。デフォルト値は 15 分です。
タイプ: 文字列
必須: はい
`localSizeLimitGB`
ローカルディスクに書き込まれるファイルの最大サイズを GB 単位で指定します。このしきい値を超えると、パブリッシャーはバッファされたすべてのデータを宛先に発行します。
タイプ: 整数
必須: はい
`siteWiseImportPolicy`
データをインポートするためのインポートポリシーの詳細 AWS IoT SiteWise。
型: オブジェクト
必須: はい
`enableSiteWiseStorageImport`
Amazon S3 バケットから AWS IoT SiteWise ストレージにデータをインポート`true`するには、これを に設定します。最初は、 でデータのコピーを作成します AWS IoT SiteWise。次に、 `enableDeleteAfterImport`を true に設定すると、S3 内のデータはコピー後に削除されます AWS IoT SiteWise。料金への影響が適用されます。デフォルト値は `true` です。
タイプ: ブール値
必須: はい
`enableDeleteAfterImport`
AWS IoT SiteWise ストレージへの取り込み後に Amazon S3 バケット内のファイル`true`を削除するには、これを に設定します。デフォルト値は `true` です。
タイプ: ブール値
必須: はい
`bulkImportJobRoleArn`
データ取り込み中に Amazon S3 からバッファされたデータを読み取るために が AWS IoT SiteWise 引き受ける IAM ロールの ARN。このロールは、エッジデバイスが AWS IoT SiteWise APIs で呼び出して一括インポートプロセスを開始する場合に使用されます。
`enableSiteWiseStorageImport` が に設定されている場合`true`、このパラメータは必須です。
タイプ: 文字列
必須: いいえ
------
送信先のパスフィルターを追加します。詳細については、「[AWS IoT SiteWise Edge 送信先にパスフィルターを追加する](destinations-add-path-filters.md)」を参照してください。
# AWS IoT SiteWise Edge 送信先にパスフィルターを追加する
パスフィルターを送信先に追加します。パスフィルターは MQTT トピック構文を使用します。ここで、 `#` は任意の数のレベルに一致するワイルドカード文字で、 `+`は単一のレベルに一致するワイルドカード文字です。複数の送信先をゲートウェイに追加できます。各送信先には、機器テレメトリにサブスクライブされている独自のパスフィルターのセットがあります。
Siemens Industrial Edge ゲートウェイは、互換性のためにプレフィックスを使用します。詳細については、「[パスフィルターのプレフィックス](sitewise-edge-on-siemens.md#siemens-path-filters)」を参照してください。
------
#### [ Console ]
**パスフィルターを追加するには**
1. [AWS IoT SiteWise コンソール](https://console.aws.amazon.com/iotsitewise/) を開きます。
1. ナビゲーションペインで、**[Edge ゲートウェイ]** を選択します。
1. パスフィルターを追加するゲートウェイを選択します。
1. 「送信**先の追加**」の**「パスフィルター**の追加」セクションで、**「パスフィルターの追加**」を選択します。
1. この送信先がサブスクライブするパスフィルターを入力します。ワイルドカード文字 (`#` および `+`) を使用して、複数のパスをサブスクライブできます。
1. **パスフィルターを追加** を選択して、パスフィルターをリストに追加します。
1. 必要に応じて、ステップを繰り返してパスフィルターを追加します。
1. 必要なパスフィルターをすべて追加したら、**作成**を選択します。
------
#### [ AWS CLI for self-hosted gateways ]
**Example : パスフィルター設定**
```
{
"destinations": [
{
...
}
],
"filters": [
{
"type": "PATH",
"config": {
"paths": [
"home/+/sensor1/temperature",
"home/livingroom/sensor1/temperature",
"home/livingroom/sensor1/temperature",
"building/#"
]
}
}
]
}
```
------
#### [ AWS CLI for Siemens IEgateways ]
**Example : パスフィルターのプレフィックス設定**
各パスフィルターのデータ (`ie/d`) プレフィックスとメタデータ (`ie/m`) プレフィックスの両方を使用して、すべてのデータをキャプチャします。
```
{
"destinations": [
{
...
}
],
"filters": [
{
"type": "PATH",
"config": {
"paths": [
"ie/d/home/+/sensor12/temperature",
"ie/m/home/livingroom/sensor12/temperature",
"ie/d/home/livingroom/sensor13/temperature2",
"ie/m/home/livingroom/sensor13/temperature2",
"ie/d/building/#",
"ie/m/building/#"
]
}
}
]
}
```
------
**注記**
パスフィルターのリストをダウンロードして、送信先間でパスフィルターをコピーします。詳細については、「[送信先のすべてのパスフィルターをダウンロードする (コンソール)](destinations-manage.md#destinations-download-list)」を参照してください。
## パスフィルターを一括でアップロードする
パスフィルターを一括でアップロードするには、CSV ファイルまたはテキストファイルを使用します。ファイルをアップロードするときに、 は正確な重複 AWS IoT SiteWise を自動的に削除します。たとえば、 `windfarm/site1/`と `windfarm/site1/`は、文字列がまったく同じであるために が AWS IoT SiteWise キャッチする正確な重複です。部分的な重複は削除されず、追加料金が発生します。たとえば、 `windfarm/#`と `windfarm/site1`は重複するトピックです。 `windfarm/site1`は既に に包含されているためです`windfarm/#`。
**注記**
追加料金が発生しないように、重複は避けてください。アップロードされたファイルは、.csv 形式または .txt 形式である必要があります。ヘッダーを含めることはできません。1 つの列で構成する必要があります。列で、パスフィルターをリストし、各フィルターを別々の行に表示します。ファイルには他の情報を含めないでください。
**ファイルのアップロード要件**
これらは追加のパスフィルター要件です。
+ 1 つの .csv ファイルまたは .txt ファイルをアップロードできます。その他のフェイル形式はサポートされていません。
+ CSV (.csv) ファイルにはヘッダーを含めることはできません。また、1 つの列のみを含める必要があります。
+ 各行に 1 つのパスフィルターを設定できます。
+ アップロードしたファイルは空にできません。
+ `#` をワイルドカードとして使用する場合、トピックフィルターの最後の文字にする必要があります。例えば、`topic/#` または特定のトピックレベルの独立した文字として使用します。ただし、`#` は `factory/machine#1/topic` などのトピックレベル名の通常の文字としても使用できます。詳細については「[パスフィルター名の特殊文字](gw-destinations.md#path-filters-special-characters)」を参照してください。
+ `+` 文字を使用することもできます。たとえば、 `factory/+/temp`を使用して、 `factory/machine2/temp` および を`factory/machine3/temp`個別に取得するのではなく、工場のすべての温度を取得します。
# AWS IoT SiteWise Edge の送信先を管理する
送信先を追加したら、送信先設定の編集、送信先の削除、パスフィルターの管理など、さまざまなオペレーションを実行して管理できます。
## 送信先を編集する
テーブルの送信先の横にあるラジオボタンを選択し、**編集**ボタンを選択して送信先を編集します。
------
#### [ Console ]
**AWS IoT SiteWise コンソールを使用して送信先を編集するには**
1. [AWS IoT SiteWise コンソール](https://console.aws.amazon.com/iotsitewise/) を開きます。
1. 左側のナビゲーションで、 **Edge セクションの Edge ゲートウェイ**を選択します。 ****
1. 適切なゲートウェイを選択します。
1. 送信**先**セクションで、編集する送信先を選択し、**編集**を選択します。
1. 送信先を変更し、**保存**を選択します。
------
#### [ AWS CLI ]
**を使用して送信先を編集するには AWS CLI**
+ 送信先を編集するには、JSON 機能の設定情報を変更します。
```
aws iotsitewise update-gateway-capability-configuration \
--gateway-id your-gateway-id \
--capability-namespace "iotsitewise:publisher:3" \
--capability-configuration '{
"sources": [
{
"type": "MQTT"
}
],
"destinations": [
{
"id": "your-existing-destination-id",
"type": "SITEWISE_REALTIME",
"name": "your-updated-destination-name",
"config": {
"publishingOrder": "TIME_ORDER",
"enableCompression": true,
"dropPolicy": {
"cutoffAge": "10d",
"exportPolicy": {
"retentionPeriod": "10d",
"rotationPeriod": "6h",
"exportSizeLimitGB": 10
}
},
"maxBatchWaitTime": "15s"
},
"filters": [
{
...
}
]
}
]
}'
```
**注記**
送信先`type`または を更新することはできません`capability-namespace`。たとえば、 のタイプから `SITEWISE_REALTIME`に切り替えることはできません`SITEWISE_BUFFERED`。MQTT 対応ゲートウェイごとに 1 つのリアルタイム送信先を設定できます。
------
## 送信先を削除する
送信先が不要になった場合は、SiteWise Edge ゲートウェイから削除できます。
------
#### [ Console ]
**AWS IoT SiteWise コンソールを使用して送信先を削除するには**
1. [AWS IoT SiteWise コンソール](https://console.aws.amazon.com/iotsitewise/) を開きます。
1. 左側のナビゲーションで、 **Edge セクションの Edge ゲートウェイ**を選択します。 ****
1. 適切なゲートウェイを選択します。
1. 送信**先**セクションで、削除する送信先を選択し、**削除**を選択します。確認画面が表示されます。
1. 送信先を削除する選択を確認するには、確認ボックスに「削除」と入力します。
------
#### [ AWS CLI ]
**を使用して送信先を削除するには AWS CLI**
+ ゲートウェイ ID を指定し、削除したい送信先を削除する機能設定を変更して、ゲートウェイ機能設定を削除します。
```
aws iotsitewise update-gateway-capability-configuration \
--gateway-id your-gateway-id \
--capability-namespace "iotsitewise:publisher:3" \
--capability-configuration '{
"sources": [
{
"type": "MQTT"
}
],
"destinations": []
}'
```
**注記**
送信先配列は空 (`[]`) にすることができますが、送信先オブジェクト自体を機能設定に含める必要があります。
------
## 送信先のすべてのパスフィルターをダウンロードする (コンソール)
AWS IoT SiteWise すべてのパスフィルターを含む CSV ファイルをコンソールにダウンロードします。ダウンロードしたパスフィルターのリストを使用して、ゲートウェイの送信先間でパスフィルターリストを簡単に共有できます。
**AWS IoT SiteWise コンソールを使用してすべてのパスフィルターの CSV ファイルをダウンロードするには**
1. [AWS IoT SiteWise コンソール](https://console.aws.amazon.com/iotsitewise/) を開きます。
1. 左側のナビゲーションで、 **Edge セクションの Edge ゲートウェイ**を選択します。 ****
1. パスフィルターを含むゲートウェイを選択します。
1. 送信**先の追加**または**送信先の編集**を選択します。
1. **パスフィルター**セクションに移動し、**CSV のダウンロード**を選択します。
**注記**
CSV ファイルには、パスフィルターのリストから選択したパスフィルターに関係なく、特定の送信先内のすべてのパスフィルターが含まれます。
## パスフィルターを編集する
個々のパスフィルターを編集して、送信先が受信するデータを絞り込むことができます。
------
#### [ Console ]
AWS IoT SiteWise コンソールを使用して、各テキストボックス内の個々のパスフィルターを編集できます。
**AWS IoT SiteWise コンソールを使用してパスフィルターを編集するには**
1. [AWS IoT SiteWise コンソール](https://console.aws.amazon.com/iotsitewise/) を開きます。
1. 左側のナビゲーションで、 **Edge セクションの Edge ゲートウェイ**を選択します。 ****
1. パスフィルターを含むゲートウェイを選択します。
1. 適切な送信先を選択します。
1. **[編集]** を選択します。
1. 編集するパスフィルターを含む行のテキストボックスを選択します。
1. パスフィルターのテキストを更新し、編集したパスフィルターのチェックボックスが選択されていることを確認します。
1. **[保存]** を選択します。
------
#### [ AWS CLI ]
を使用して送信先のパスフィルターを編集するには AWS CLI、まず現在の設定を取得し、変更してから、 `update-gateway-capability-configuration` コマンドを使用して更新します。
**を使用してパスフィルターを編集するには AWS CLI**
1. 現在の機能設定を取得します。
```
aws iotsitewise describe-gateway-capability-configuration \
--gateway-id your-gateway-id \
--capability-namespace "iotsitewise:publisher:3" \
--query "capabilityConfiguration"
```
1. JSON を編集して、必要に応じてパスフィルターを変更します。
1. 変更されたパスフィルターを使用して機能設定を更新します。
```
aws iotsitewise update-gateway-capability-configuration \
--gateway-id your-gateway-id \
--capability-namespace "iotsitewise:publisher:3" \
--capability-configuration json-containing-your-updated-path-filters
```
------
## パスフィルターを削除する
送信先のパスフィルターを削除して、MQTT ソースとデータ処理パイプラインから受信するデータを制御できます。
------
#### [ Console ]
**AWS IoT SiteWise コンソールを使用してパスフィルターを削除するには**
1. [AWS IoT SiteWise コンソール](https://console.aws.amazon.com/iotsitewise/) を開きます。
1. 左側のナビゲーションで、 **Edge セクションの Edge ゲートウェイ**を選択します。 ****
1. パスフィルターを含むゲートウェイを選択します。
1. 適切な送信先を選択します。
1. **[編集]** を選択します。
1. 送信**先の編集**画面で、**パスフィルター**セクションで、削除するパスフィルターを 1 つ以上選択します。
1. **[削除]** を選択します。削除の確認メッセージが表示されます。パスフィルターの削除を続行する場合は、確認画面で**削除**を選択します。
------
#### [ AWS CLI ]
**を使用して送信先を削除するには AWS CLI**
+ 機能設定から削除してパスフィルターを削除します。
```
aws iotsitewise update-gateway-capability-configuration \
--gateway-id your-gateway-id \
--capability-namespace "iotsitewise:publisher:3" \
--capability-configuration '{
"sources": [
{
"type": "MQTT"
}
],
"destinations": [
{
"id": "your-destination-id",
"type": "SITEWISE_REALTIME",
"name": "your-destination-name",
"config": {
...
},
"filters": [
{
"type": "PATH",
"config": {
"paths": [
"/path1",
"/path2",
"/delete-a-path-to-remove-it"
]
}
}
]
}
]
}
```
**注記**
フィルター配列は空 (`[]`) にできますが、フィルターオブジェクト自体を機能設定に含める必要があります。
------