処理したデータを TSDB (時系列データベース) インスタンスへ転送するようにルールエンジンを設定することができます。

注記

  • TSDB への転送は現在、中国 (上海) リージョンのノードのみで利用可能です。
  • VPC に接続されている TSDB インスタンスのみがサポートされています。
  • 同じリージョン内のノードへの転送のみがサポートされています。 例えば、中国 (上海) リージョンのノードの IoT Platform データは、中国 (上海) リージョンの TSDB ノードにのみ転送することができます。
  • 転送できるのは JSON 形式のデータのみです。
準備

手順

  1. [データ転送] の横にある [操作の追加] をクリックして、[操作の追加] ダイアログボックスを開きます。 [TSDB に保存] をクリックします。
  2. ページの指示に従ってパラメーターを設定します。
    • 操作の選択: TSDB (時系列データベース) を選択します。
    • リージョン、インスタンス: 処理されたデータを保存するデータベースインスタンスを選択します。
    • タイムスタンプ: UNIX のタイムスタンプ (例: 1404955893000)。 2 つの設定が利用可能です。
      • エスケープ文字式 ${} を使用してください。 例: ${time}。 タイムスタンプの値は、トピックの時間フィールドに対応しています。 この設定を使用することを推奨します。
      • ルールエンジン関数 timestamp() を使用します。 timestamp の値は、ルールエンジンサーバーによって生成されたタイムスタンプです。
    • タグ: 定数を使って設定する必要があります。 値は次の 3 つの方法で設定できます。
      • ${city} のような、エスケープ文字式 ${} を使用します。 値は、トピック内の city フィールドの値に対応しています。 この設定を使用することを推奨します。
      • deviceName() のような、ルールエンジンによって作成された関数を使用します。 値は DeviceName です。
      • beijing などの定数に設定します。 定数の値は beijing (北京) です。
    • 権限付与: [IoT Platformが TSDB にデータを書き込むことに同意します] チェックボックスをオンにします。 ルールエンジンは TSDB インスタンスにネットワークホワイトリストを追加して、IoT Platform がデータベースにアクセスできるようにします。 これらの IP アドレス範囲を削除しないでください。

ルールエンジン SQL :

SELECT time,city,power,distance, FROM "/myproduct/myDevice/update"`;

設定については、「手順」に示されています。

送信されたメッセージ:


{
"time": 1513677897,
"city": "beijing",
"distance": 8545,
"power": 93.0
}

ルールエンジンが TSDB に書き込む 2 つのデータエントリは次のとおりです。


data: timestamp:1513677897, [metric:distance value:8545]
tag: device=myDevice,product=bikes,cityName=beijing

data: timestamp:1513677897, [metric:power value:93.0]
tag:device=myDevice,product=bikes,cityName=beijing

注記

  • ルールエンジンによってタイムスタンプまたはタグとして設定されたフィールドを除き、すべてのフィールドがメトリックとして TSDB に書き込まれます。 この例では、時間と都市を除いて、距離と電力がメトリックとして TSDB に書き込まれます。
  • メトリックの値に設定できるのは、値の型のみです。 そうでない場合、データベースへの書き込みが失敗する可能性があります。
  • ルールエンジンによって設定されたタグと値のペアが取得できることを確認してください。 取得されていないタグと値のペアがあると、データベースへの書き込みが失敗する可能性があります。
  • 最大 8 つのタグと値のペアを入力できます。
  • メトリクス、タグ、およびタグ値に使用できるのは、英数字、漢字、特殊文字 (-_. /():,[]=‘) のみです。
  • ルールエンジンは、データベースにアクセスするために、TSDB ホワイトリストに次の IP アドレス範囲を追加します。 IP アドレスが表示されない場合は、手動で追加してください。

    中国 (上海): 100.104.76.0/24

    以下に TSDB コンソールのホワイトリストの例を示します。