アラートルールの作成
アラートルールは計測値を見守り、許容範囲を外れたときに知らせてくれます。このガイドでは、画面に表示される順番どおりに、ルールを1つ最初から最後まで作成します。
このページの内容
ルールは、1台または複数のセンサーの計測値を1つ見守り、許容範囲を外れたときに知らせます。
このガイドでは、次の例を最後まで使います。ハウスの気温を夜間に5 °Cより下げたくないとします。ルールでそのハウスの気温センサーを見守り、気温が5 °Cを下回った時点でメッセージを送れば、作物が傷む前に誰かが対処できます。
ルールを作成するまで、CropWatchは計測データを記録するだけで、こちらから連絡することはありません。知らせる役目を担うのがルールです。
必要なもの:
- すでに計測データを送信しているセンサー。まだの場合は、ゲートウェイの設置から始めてください。
- CropWatchのサインイン情報
- 4つの問いへの答え:どのセンサーの、どの計測値を、いくつで、誰に知らせるか
- ルールで見守るすべてのセンサーで、マネージャー以上の権限。権限が足りなくてもフォームを開いて入力はできますが、保存すると「You do not have permission to manage one or more selected devices」という赤いメッセージが表示されます。権限レベルについてはアクセスの共有と権限レベルをご覧ください。
- プッシュ通知で受け取る場合は、先に自分のスマートフォンやパソコンでプッシュ通知を有効にしておくこと(スマートフォンとパソコンでのプッシュ通知)
ルールの作成は5分ほどで終わります。ここでの操作がセンサーに悪影響を与えることはありません。
- CropWatchにサインインします。
- メニューからルールを開きます。ルールテンプレートという見出しの一覧に、作成済みのルールがロケーションごとにまとめて表示されます。列は「名前」「割り当てデバイス」「条件」「アクション」と、作成日時(列名は「最終更新日時」)です。検索欄に入力するとルールを絞り込めます。
- 一覧の右上にある+ボタンを押します。「ルールテンプレートを作成」という見出しのフォームが開きます。
1つのルールで複数のセンサーを見守れるため、CropWatchではルールを「ルールテンプレート」と呼んでいます。どちらも同じものです。
最初のカードの見出しは「1. テンプレート」です。入力欄が2つとスイッチが1つあります。
- ルール名:深夜2時にメッセージで見て、すぐわかる名前にします。「温度ルール3」より「ハウスの低温」のほうが伝わります。この名前は届くアラートに表示されます。
- 説明:任意です。次にこのルールを見る人へのメモです。半年後の自分かもしれません。
- ルールを有効化:オンのままにします。オフにすると、ルールは残りますが判定されません。ルールを消さずに一時停止したいときに使います。
2つ目のカードの見出しは「2. デバイス割り当て」です。「デバイス」の欄を開き、このルールで見守るセンサーにチェックを入れます。センサーは場所ごとにまとめられており、欄に文字を入力すると一覧を絞り込めます。
複数選ぶこともできます。その場合はセンサーごとに個別に判定されます。2つのハウスが両方とも冷え込めば、それぞれについて別々に通知が届きます。
ここで選んだセンサーによって、ステップ4で選べる人も決まります。プッシュ通知とLINEの通知先の一覧には、選んだセンサーを閲覧できる人が表示されます。センサーを1台も選んでいないうちは、一覧は空のままです。
欄の代わりに「利用可能なデバイスがありません。先にデバイスを追加してください。」と表示される場合は、アカウントにまだセンサーがありません。
名前のあとのかっこ内の長い英数字は、センサーのシリアル番号です。同じ名前のセンサーを見分けるために表示されています。
3つ目のカードの見出しは「3. アラート条件」です。最初のブロック「条件 1」に、データ項目を1つと、その限度を設定します。
- データ項目:見守る計測値です。温度 (°C)、湿度 (%)、CO₂ (ppm)、土壌水分、水深 (cm) などがあります。最初は「温度 (°C)」が選ばれています。センサーが実際に計測している項目を選んでください。
- 演算子:比べ方です。「未満 (<)」「以下 (<=)」「超過 (>)」「以上 (>=)」「一致 (=)」から選びます。新しいルールでは「超過 (>)」が選ばれています。
- しきい値:アラートが発生する値です。
- リセット値:次のアラートが出せるようになるまでに、計測値が戻る必要がある値です。詳しくは次の項目で説明します。
入力欄の上にはプレビューがあり、限度が数直線上に色付きの線で、リセットする位置とあわせて描かれます。どちら側の数値でアラートが発生するかがひと目でわかります。数直線の上には設定が2つあります。
- 単位:°C、°F、°K から選びます。入力した数値をどの単位として読むかが変わり、入力欄のかっこ内にも「しきい値 (C)」のように表示されます。温度なら °F に切り替えて華氏で入力でき、保存されるのは摂氏に換算した値です。温度以外のデータ項目では °C のままにしてください。入力した数値が温度として換算されてしまいます。
- 中心値:数直線の中心と、しきい値を追加したときの初期値です。ルールには保存されません。
しきい値ごとに名前と表示カラーもあります。プレビューの線に付く名前と色にすぎず、ルールには保存されません。ルールを開き直すと「条件 1」と最初の色に戻ります。
冷え込むハウスの例では、データ項目「温度 (°C)」、演算子「未満 (<)」、しきい値5、リセット値7とします。
演算子の一覧にある「範囲」は保存できません。選ぶと入力欄が「最小値」「最大値」に変わり、「未対応の演算子です。」と表示され、保存ボタンが押せないままになります。しきい値を2つ使っても値の幅は見守れません。理由は「複数の条件を使う」で説明します。
ここはわかりにくいと言われる部分ですが、2分ほど読む価値があります。役に立つメッセージが1通届くか、役に立たないメッセージが40通届くかがここで決まるからです。
センサーは10分ごとに計測データを送ることがあります。寒い夜には、気温が6時間ずっと5 °Cを下回ったままになるかもしれません。36通もメッセージが届いては困ります。
そこでCropWatchは次のように動きます。
- 気温が5 °Cを下回ります。メッセージが1通届きます。
- 5 °C未満のままです。追加のメッセージは届きません。ルールは発生中の状態を保ちます。
- 7 °Cまで戻ります。ルールは何も送らずにリセットされます。リセットした日時はルールの履歴に記録されます。
- その後にまた5 °Cを下回ると、新しいメッセージが届きます。
ルールを再び有効な状態に戻すのがリセット値です。しきい値より安全側に、少し間をあけて設定します。
- 低すぎる状態を見守る場合(「未満」5)は、リセット値を高くします。たとえば7です。
- 高すぎる状態を見守る場合(「超過」30)は、リセット値を低くします。たとえば28です。
リセット値を逆側に設定すると(「超過」30でリセット値35など)、計測データが届くたびにアラートとリセットが繰り返されます。誰もが避けたい大量のメッセージの原因です。
間はどのくらいあければよいでしょうか。普段の小さな上下動では越えない程度です。温度なら1〜2度が目安です。
条件のカードには追加ボタンが2つあり、働きが違います。
- このデータ項目にしきい値を追加:条件の中のプレビューにあります。同じ計測値に2つ目の限度をカードとして追加します。追加されたカードは「一致 (=)」で、中心値が入った状態です。
- 別のデータ項目の条件を追加:条件の下にあります。データ項目を別に選べる「条件 2」を追加します。条件が2つ以上になると、それぞれに削除ボタンが表示されます。
どちらを使っても、1つのルール内のしきい値と条件がすべて同時に満たされたときにだけアラートが発生します。リセットも、すべてのリセット値に同時に戻ったときにだけ行われます。そのため、次の3つの場合に分かれます。
- 2つの計測値を同時に:「CO₂が1000を超え、かつ湿度が80%を超える」は、データ項目ごとに1つずつ、条件2つのルール1つで作れます。両方の計測値がリセット値まで戻るとリセットされます。
- どちらか一方:「5 °Cより寒い、または35 °Cより暑い」は1つのルールにはできません。2つが同時に成り立つことはないからです。ルールを2つ作ってください。
- 1つの計測値に2つの限度:「20 °Cから30 °Cの間」のような幅も、1つのルールでは動きません。アラートは発生しても、2つのリセット値に同時に戻ることがないため、一度発生したまま元に戻りません。データ項目1つにつきしきい値は1つにし、2つ目の限度は別のルールで作ってください。
1つの条件にしきい値が2つあると、プレビューの演算子の下に「条件 1 と範囲が重複しています。」、リセット値の下に「他の条件によってリセット値が完全に覆われているため、リセットは発生しません。」といった警告が表示されます。それでも保存はできてしまいます。どちらかの警告が出たら、しきい値を別々のルールに分けてください。
4つ目のカードの見出しは「4. アラートアクション」です。新しいルールには「アクション 1」として、自分の名前がプッシュ通知先に入ったプッシュ通知があらかじめ追加されています。これを変更するか、アクションを追加で追加します。
「アクションタイプ」を開いて、次から選びます。
- Push:プッシュ通知先で選んだ人のスマートフォンやパソコンに通知が届きます。一覧はステップ2でセンサーを選ぶと表示され、選んだセンサーのどれかを閲覧できる人が並びます。プッシュ通知を有効にしていない人は、名前の後ろに「プッシュ通知未登録」と付いて灰色で表示され、選べません。有効にする方法はスマートフォンとパソコンでのプッシュ通知をご覧ください。
- EMail:「送信先」の欄にメールアドレスを1つ入力します。2つ目のアドレスに送るには、1つの欄に2つ入力するのではなく、アクションをもう1つ追加します。
- LINE:LINE通知先から人を選びます。名前の後ろに「LINE未連携」と表示される人は、まだLINEをCropWatchに連携していないため、メッセージが届きません。
- LoRaWAN:人に知らせる代わりにリレーを切り替えます。ヒーターを入れる、換気窓を開けるといった操作です。この項目の最後で説明します。使う前に弊社にご相談ください。
新しいルールの自分の名前について:センサーを選ぶまでは、欄に自分の名前が表示されているだけです。センサーを選んだ時点で自分がプッシュ通知を有効にしていなければ、欄の下に「(自分の名前)はプッシュ通知に未登録です。登録済みのユーザーを選択してください。」と赤字で表示され、このままでは保存できません。先に「プロフィール」でプッシュ通知を有効にするか、ほかの人を選ぶか、アクションタイプを変更してください。誰も選ばれていない場合は「プッシュ通知に登録済みの通知先を1人以上選択してください。」と表示されます。
既存のルールを編集するときは、プッシュ通知先に登録済みの人がそのまま残ります。今は使える端末がない人も残り、プッシュ通知を有効にし直せば再び届くようになります。最後の1台でプッシュ通知を止めた人は、すべてのルールのプッシュ通知先から自動的に外れます。ルールが発生したときに通知が届くのは、その時点でセンサーへのアクセス権がある人だけです。
リレーの切り替え。LoRaWANのアクションでは、次の3つを指定します。
- デバイス:切り替えるリレーコントローラーです。一覧にはリレーコントローラーだけでなくすべてのセンサーが表示されるので、間違えないように選んでください。
- アクション:「リレー1を5秒間ON」「リレー2を5秒間ON」「両方のリレーを5秒間ON」、またはリレー1・2の「常時ON」「常時OFF」から選びます。秒数は「ON時間 (秒)」の入力に合わせて変わります。この欄は時間指定の選択肢で表示され、1〜86400秒(1日)を指定できます。
- ルールがリセットされた時にリレーの状態を元に戻す:常時ON・常時OFFの選択肢でだけ使え、最初はチェックが入っています。ルールがリセットされると、CropWatchはそのコントローラーに、アクションでどのリレーを切り替えたかに関係なく、両方のリレーをOFFにするコマンドを送ります。
リレーについて詳しくはリレーのガイドをご覧ください。
「アクションを追加」で必要なだけ追加できます。1つのルールで、ある人にメールを送り、別の人にプッシュ通知を送り、ヒーターを入れる、といったことを同時に行えます。
最後のカードの見出しは「4. 確認して作成」です。上の項目がすべて入力されると「ルール概要」が表示され、名前、ステータス(「有効」または「無効」)、割り当てデバイス、条件が「温度 (°C) より小さい (<) 5 (リセット値: 7)」のように並びます。詳細を表示を押すと、アクションと送信先も表示されます。一度目を通してください。ルールが実際にどう動くかのとおりに書かれているので、入力ミスに気づく一番の機会です。
代わりに「プレビューを表示するには、上の必須項目をすべて入力してください。」と表示される場合は、まだ入力が足りません。原因はほとんどの場合、次のどれかです。
- 名前がない
- センサーにチェックが入っていない
- しきい値またはリセット値が空欄、またはしきい値をすべて削除した条件がある
- 送信先のないアクションがある
- プッシュ通知のアクションの通知先が、プッシュ通知を有効にしていない人だけ
- 保存できない「範囲」の演算子を選んでいる
最後に「ルールを作成」を押します。「ルールテンプレート「ハウスの低温」を作成しました。」という緑色のメッセージが表示され、一覧に戻ると作成したルールが表示されています。
保存できない場合は、赤いメッセージで理由が表示されます。「You do not have permission to manage one or more selected devices」は、選んだセンサーの少なくとも1台で、権限がマネージャーより下であることを示します。「始める前に」をご覧ください。
ルールはすぐに動き始めますが、センサーから限度を越える計測データが届くまでは何も起こりません。ルールを作成する前の計測データは対象になりません。
アラートが発生すると、アクションに登録した全員に、ルール名とどのセンサーかが通知されます。計測値がリセット値まで戻ると、ルールは何も送らずにリセットされます。正常に戻ったことを知らせるメール、LINE、プッシュ通知は届きません。リセットのときに動くのは、「ルールがリセットされた時にリレーの状態を元に戻す」にチェックを入れたリレーのアクションだけです。リセットはすべてルールの履歴に記録されます。
ルールが判定できるのは、届いた計測データだけです。電池切れやゲートウェイのオフラインなどでセンサーからの送信が止まると、「低温」のルールは何も知らせません。低温かどうかを判定するデータが届かないからです。送信が止まっているセンサーがないか、ダッシュボードで確認してください。
ルール画面の各行の右側に、小さなボタンが3つあります。
- 鉛筆:ルールを開いて変更できます。フォームは作成時と同じで、最後のカードの見出しが「4. 確認して保存」、ボタンが「変更を保存」になります。
- 時計:「履歴を表示」が開き、ルールが発生した日時とリセットされた日時が並びます。各イベントには「発生中」または「解消」、「トリガー」の日時とそのときの値、継続した時間が表示されます。複数のセンサーを見守るルールでは、「すべて」と表示された絞り込みで1台ずつ確認できます。
- ごみ箱:ルールを削除します。「ルール「ハウスの低温」を削除してもよろしいですか?この操作は元に戻せません。」と確認されるので、「削除」を押すと削除されます。
ハウス内で作業中で扉を開けているときなど、ルールを消さずにしばらく止めたい場合は、鉛筆でルールを開いて「ルールを有効化」をオフにします。作業が終わったらオンに戻してください。
ルールの変更、一時停止、削除にも、作成と同じ権限が必要です。見守るすべてのセンサーで、マネージャー以上の権限です。
- リセット値を逆側に設定している。いちばん多い間違いで、メッセージが次々に届く原因になります。詳しくはしきい値とリセット値をご覧ください。
- 「または」の条件を期待している。1つのルール内の条件は、すべて同時に満たされる必要があります。低すぎる場合と高すぎる場合を見守るには、ルールが2つ必要です。
- ルールがオフのままになっている。ルールがまったく発生しない場合は、まず「ルールを有効化」を確認してください。
- メールアドレスの入力ミス。警告は表示されません。メッセージは届かないまま送信されます。
- LINEを連携していない人がいる。一覧に表示され、選択もできますが、何も届きません。
- 限度が厳しすぎる。普段の計測値に近い値を限度にすると、メッセージが絶えず届きます。無視されるメッセージは、ないよりも悪い結果になります。
- 「正常に戻った」通知を待っている。そうした通知は届きません。ルールは何も送らずにリセットされます。いつリセットされたかはルールの履歴で確認できます。
- 1つの計測値にしきい値を2つ設定している。すべてが同時に満たされる必要があるため、発生しないか、発生したまま戻りません。詳しくは複数の条件を使うをご覧ください。
- 温度以外の項目で単位を °F にしている。入力した数値が温度として換算されます。温度以外では、単位は °C のままにしてください。
- 自分のプッシュ通知を有効にしていない。プッシュ通知先が自分だけの新しいルールは、プッシュ通知を有効にするまで保存できません。スマートフォンとパソコンでのプッシュ通知をご覧ください。