スマートルール コレクション

Things Cloud には、事前設定されたグローバル スマートルールが含まれています。グローバル スマートルールは種類ごとに、構成するパラメータが異なります。

アラーム時に電子メールを送信

機能

アラームが発生すると、メールが送信されます。

パラメータ

このルールでは、次のパラメータを使用します。

トラブルシューティング

• 新しいアラームが作成されたことを確認してください。通知は新たに作成されたアラームに対してのみ送信され、同じ種類の既存のアクティブなアラームの更新には送信されません。同じ種類のアラームがすでにそのデバイスでアクティブになっている場合、追加の通知はトリガーされません。
• デバイスが メンテナンスモード であることを確認します。これで、抑制ポリシーにより新しいアラームは生成されません。
• アラームの重大度を変更するアラームマッピング ルールを構成している場合（アラームマッピング 参照）、アラームの重大度が予想と異なることがあります。
• 迷惑メールフォルダを確認してください。

アラーム時に重大度を上げる

機能

アラームが一定時間有効になっていると、重大度が上がります。

パラメータ

このルールでは、次のパラメータを使用します。

説明

構成されたタイプのアラームが発生すると、アラームがアクティブである時間の監視が開始されます。

指定した継続時間が経過してもアクティブな場合、重大度が 1 レベル（マイナーからメジャーなど）上がります。

アラームがクリティカル状態に達すると、それ以上のアクションができなくなるため、監視は停止します。

ジオフェンスの際にアラームを作成

機能

ジオフェンスが境界を越えると、アラームが作成されます。

このルールでは、ジオフェンスに入るか出るか、またはその両方を行うように設定できます。既存のアラームは、例えば、ジオフェンス領域を出た追跡車両がジオフェンス領域に再び入ってきた場合など、反対の条件が再び当てはまる場合にクリアされます。

パラメータ

このルールでは、次のパラメータを使用します。

トラブルシューティング

• ルールを作成 / 有効化した後、少なくとも一度はデバイスがジオフェンス内にあることを確認してください。

• デバイスが メンテナンスモード であることを確認します。こうすれば、抑制ポリシーにより新しいアラームは生成されません。

• アラームの重大度を変更するアラームマッピング ルールを構成している場合（アラームマッピング 参照）、アラームの重大度が予想と異なることがあります。

ジオフェンスの際に E メールを送信

機能

ジオフェンスの境界を越えると、メールが送信されます。

パラメータ

このルールでは、次のパラメータを使用します。

トラブルシューティング

• ルールを作成 / 有効化した後、少なくとも一度はデバイスがジオフェンス内にあることを確認してください。

• 迷惑メールフォルダを確認してください。

エネルギー消費を計算

機能

電気、ガス、水道メーターからのデータに基づいて消費データポイントを作成します。

パラメータ

このルールでは、次のパラメータを使用します。

消費メジャーメントの単位は、常に 1 時間あたりのものになります（メジャーメントが「kg」の場合、消費は「kg/時」になります）。

このルールは、指定した時間の最後の 2 つのメジャーメントを取得し、値と時間の差を計算してから、1 時間あたりの消費量を計算します。

例

20 分ごとに計算するようにルールが設定されているとします。次のメジャーメントが送信されます。
11:59 に 100kg、12:14 に 200kg。
12:20 にルールがトリガーされ、最後の 2 つのメジャーメントが取得されます。値と時間の差を計算します。したがって、12:20 に作成された消費メジャーメントは 400kg/時 となります。
最後の期間に新しいメジャーメントが作成されなかった場合、消費量 0 のメジャーメントが作成されます。

計測値がない場合にアラームを作成

機能

新しいメジャーメント データを一定時間受信しなかった場合、アラームを発生します。

パラメータ

このルールでは、次のパラメータを使用します。

アラーム時に操作を実行

機能

特定のアラームが発生すると、指定された操作がアラームを発生したデバイスに送信されます。

パラメータ

このルールでは、次のパラメータを使用します。

計測のしきい値の場合、アラームを作成

機能

メジャーメントの値が赤色 / 黄色範囲（障害 / 注意範囲）に入るとアラームが発生し、赤色 / 黄色範囲から抜けるとアラームがクリアされます。

アラームの重大度は次のように決定されます。

• メジャーメントが赤色の範囲（障害範囲）に移動すると、クリティカルアラームが作成されます。赤色の範囲外に移動すると、クリティカルアラームはクリアされます。

• メジャーメントが黄色の範囲（注意範囲）に移動すると、マイナーアラームが作成されます。黄色の範囲外に移動すると、マイナーアラームがクリアされます。

このルールでは、デバイスオブジェクトまたはデータポイントライブラリの次のパラメータを使用します。

• データポイントライブラリの赤色 / 黄色の範囲（障害 / 注意範囲）： システムがクリティカルアラームを作成する必要がある場合は赤色の範囲、マイナーアラームを作成する必要がある場合は黄色の範囲。データポイントには、赤色 / 黄色の範囲に少なくとも 1 つが設定されている必要があります。
  
  
• オブジェクトの赤色の範囲（障害範囲）： システムがクリティカルアラームを作成する必要がある場合の範囲。これらの値は、各データポイントのデータエクスプローラで編集できます。これらは、許容される最小値 / 最大値を含む狭い間隔［赤の最小値：赤の最大値］であることに注意してください。次の例も参照してください。
  
  
• オブジェクトの黄色の範囲： システムがマイナーアラームを作成する必要がある場合の範囲。これらの値は、各データポイントのデータエクスプローラで編集できます。これらは、許容される最小値を含むが、許容される最大値を含まない半開間隔［黄色の最小値：黄色の最大値］であることに注意してください。次の例も参照してください。

例

例 1 - 赤色の範囲（障害範囲）：

赤色の範囲を［60 ; 90］に設定します。

• 赤色の最小値：60
• 赤色の最大値：90

メジャーメントが 60 ～ 90（値 60 と 90 を含む）の場合、クリティカルアラーム（赤色）が作成されます。

例 2 - 黄色の範囲（注意範囲）：

黄色の範囲を［30 ; 50］に設定します。

• 黄色の最小値：30
• 黄色の最大値：50

メジャーメントが 30 ～ 49 の場合、マイナーアラーム（黄色）が作成されます。値 50 は黄色の範囲外です。

例 3 - 赤色 / 黄色の範囲（障害 / 注意範囲）：

上記の動作の結果、次のような構成を設定できます。

• 赤色の最小値：60
• 赤色の最大値：90
• 黄色の最小値：30
• 黄色の最大値：60

メジャーメントが 60 の場合、赤色には値 60 が含まれるため、結果としてクリティカルアラーム（赤色）が作成されます。

例 4 - 重複：

赤色の範囲（障害範囲）と黄色の範囲（注意範囲）は重なることがあります。この重複範囲内の値は、黄色の範囲内にあるものとして扱われます。

黄色の範囲を［30 ; 60］に設定し、赤色の範囲を［50 ; 90］に設定すると、次のようになります。

• 赤色の最小値：50
• 赤色の最大値：90
• 黄色の最小値：30
• 黄色の最大値：60

メジャーメントが 55 の場合、マイナーアラーム（黄色）が作成されます。

これらのメカニズムを使用して、データポイントライブラリで全体的なしきい値範囲を構成できます。これらの全体的な値は、特定のオブジェクトに対してケースバイケースで上書きできます。

パラメータ

このルールでは、次のパラメータを使用します。

説明

このルールは、入力されるメジャーメントごとに次の手順を実行します。

• スマートルールに有効なデータポイントがあるかどうかを確認します。それがない場合は、ルールエンジン（CEP）から重大度がメジャーアラームが送信され、ルール設定が無効であることを通知します。

• ソース オブジェクトに対して、ルールが有効になっているかどうかを確認します。

• メジャーメントにフラグメントとシリーズ（構成データポイントのパラメータ）のデータが含まれているかどうかを確認します。

• 赤色 / 黄色の範囲（障害 / 注意範囲）のデータは、次のいずれかから収集されます。

  • データポイントライブラリ（制御パラメータ）
  • ソースオブジェクト（メジャーメント）が見つかった場合、ソースオブジェクトでのデータポイント優先の範囲がマージ（結合）されます。

マージ（結合）されたパラメータで、赤色 / 黄色の範囲（障害 / 注意範囲）が定義されていない場合、アラームは生成されません。

• 赤色の範囲（障害範囲）内の受信値： オブジェクトに対して特定のタイプの重大度がクリティカルのアクティブなアラームがない場合、クリティカルアラームを作成します。それ以外は何もしません。

• 黄色の範囲（注意範囲）内の受信値： オブジェクトに対して特定のタイプの重大度がマイナーのアクティブなアラームがある場合、マイナーアラームを作成します。それ以外は何もしません。

• 黄色 / 赤色の範囲外のメジャーメント： オブジェクトに対して指定したタイプのアクティブアラームがある場合、クリティカルアラームまたはマイナーアラーム（あるいはその両方）をクリアします。

トラブルシューティング

• 新しいアラームが作成されたことを確認してください。通知は新たに作成されたアラームに対してのみ送信され、同じ種類の既存のアクティブなアラームの更新には送信されません。同じ種類のアラームがすでにそのデバイスでアクティブになっている場合、追加の通知はトリガーされません。

• デバイスが メンテナンスモード であることを確認します。こうすれば、抑制ポリシーにより新しいアラームは生成されません。

• アラームの重大度を変更するアラームマッピング ルールを構成している場合（アラームマッピング 参照）、アラームの重大度が予想と異なることがあります。

• 次回のスケジュールされたメジャーメントでアラームがクリアされていて、その値が緑色の範囲になっているか確認してください。

計測値のしきい値超過時アラームを作成

機能

メジャーメント値が赤色の範囲（障害範囲）に入るか、赤色の範囲から出ると、クリティカルアラームが生成またはクリアされます。

アラームの重大度は、次のように決定されます。

• メジャーメントが赤色の範囲（障害範囲）に移動すると、重大度はクリティカルになります。

• メジャーメントが緑色の範囲に入ると、アラームは作成されません。

パラメータ

このルールでは、次のパラメータを使用します。

トラブルシューティング

• 新しいアラームが作成されたことを確認してください。通知は新たに作成されたアラームに対してのみ送信され、同じ種類の既存のアクティブなアラームの更新には送信されません。同じ種類のアラームがすでにそのデバイスでアクティブになっている場合、追加の通知はトリガーされません。

• デバイスが メンテナンスモード であることを確認します。こうすれば、抑制ポリシーにより新しいアラームは生成されません。

• アラームの重大度を変更するアラームマッピング ルールを構成している場合（アラームマッピング 参照）、アラームの重大度が予想と異なることがあります。

• 次回スケジュールされたメジャーメントでアラームがクリアされていて、その値が緑色の範囲になっているか確認してください。

スマートルール変数

特定のルールパラメータに、さまざまなトリガーフィールドを変数として使うことができます。ルールがトリガーされると、変数はトリガーフィールドの実際の値に置き換えられます。

このメカニズムを使用すると、例えば、デバイス名やアラームテキストをさまざまな出力（メール、SMS）に挿入できます。

すべてのトリガー（アラーム、メジャーメント、オペレーション、イベント）から使用される共通フィールド

アラーム固有のフィールド

オペレーション固有のフィールド

メジャーメント固有のフィールド

さらに、次のパターンがサポートされています。

例

Things Cloud トリガー

{
  "source":{
    "id":"10200"
  },
  "type":"TestEvent",
  "text":"sensor was triggered",
  "time":"2014-03-03T12:03:27.845Z",
  "c8y_Position":{
    "lat":2,
    "lng":2
  },
  "c8y_evtdata":{
    "data1":111,
    "date2":222,
    "evtInnerData":{
      "indate1":333,
      "indate2":444
    }
  }
}

例えば、ここでは次の変数を定義できます。