Soracom

Users

ドキュメント

温度が 24 °C を上回ったら担当者にメールで通知する

3 分ごとにサンプルデータソース (Demo) の Device-1 の最新 5 分間の温度の平均値を確認し、平均値が 24 °C を超えたら、担当者 (member@example.com) にメールで通知する Alert を設定します。

Lagoon 3 では、Alert ruleContact pointNotification policy を利用して、Alert を設定します。各設定の概要は以下のとおりです。Alert については、Alert の概要 を参照してください。

項目設定内容

Alert rule

名前: Temperature alert (info)

3 分ごとに「Device-1 の最新 5 分間の温度の平均値」を確認し、平均値が 24 °C を超えたら、この Alert rule の State を Firing にします。

Label は、以下のように設定します。

  • severity=info
  • alert_type=temperature

Contact point

名前: Sample member mail address

member@example.com にメールで通知します。
Notification policy

以下の Label が設定された Alert rule の State が Firing になったときに、Contact point「Sample member mail address」を利用して通知します。

  • severity=info
  • alert_type=temperature

ステップ 1: Query および評価間隔を設定する

3 分ごとに「Device-1 の最新 5 分間の温度の平均値」を確認し、平均値が 24 °C を超えたら、Alert rule の State が Firing に変化するように設定します。

  1. Lagoon コンソールにログイン して、[ (Alerting)][Alert rules][+New alert rule] の順にクリックします。

    「Add rule」画面が表示されます。

  2. Query「A」を以下のように設定します。

    項目説明
    Query の名前[A] をクリックして、「D1 temp」を入力します。
    データソース (1 列目 1 項目)「Harvest (default)」を選択します。
    Alert 対象の時間範囲 (1 列目 2 項目)「now-10m to now」をクリックして、[From] に「now-5m30s」を入力し、[To] に「now-30s」を入力して、[Apply time range] をクリックします。
    リソースの種類 (2 列目 1 項目)「Demo」を選択します。
    リソース (2 列目 2 項目)「Device-1」を選択します。
    データフォーマット (2 列目 3 項目)「Standard」を選択します。
    系列 (2 列目 4 項目)「temperature」(温度) を選択します。

    サンプルデータソース (Demo) の Device-1 の温度データのグラフ (1 点のみ) が表示されます。

    「temperature」を選択したときに、想定したグラフが表示されない場合は、もう一度「temperature」を選択してください。

  3. Expression「B」を以下のように設定します。

    項目説明
    Expression の名前[B] をクリックして、「D1 temp reduce」を入力します。
    計算方法「Reduce」を選択します。
    [Function]「Mean」(平均) を選択します。
    [Input]「D1 temp」を選択します。
    [Mode]「Strict」を選択します。

    ここまでの設定で、Query「D1 temp」(現在時刻の 30 秒前からの 5 分間のすべての温度) の平均値が Expression「D1 temp reduce」の値として扱われます。

  4. Expression「C」を以下のように設定します。

    項目説明
    Expression の名前[C] をクリックして、「Condition」を入力します。
    計算方法「Threshold」を選択します。
    [Input]「D1 temp reduce」を選択します。また、[IS ABOVE] (より大きい) が表示されていることを確認して「24」を入力します。

  5. [Preview] をクリックします。

    データが更新され、ここまでに設定した Expression の計算結果と、条件の評価結果が表示されます。

    評価結果説明
    NormalAlert rule を満たしません。
    FiringAlert rule を満たしました。なお、ここで Alert rule を満たしただけでは、Alert の State は Firing にはなりません。続けて、次のステップを行います。

    引き続き、Alert rule の評価間隔を設定します。ここでは、3 分間隔で Alert rule を評価し、Alert rule を満たしたらすぐに、Alert の State が Firing に変化するように設定します。

  6. 以下の項目を設定します。

    項目説明
    [Evaluate every]「3m」(3 分) を入力します。評価間隔です。
    [for]「0」を入力します。Firing に変化するまでの Alert rule の継続時間です。「0」を入力すると、Alert rule を満たすとすぐに (0 秒で) Alert の State が Firing に変化します。

    サンプルデータソース (Demo) の場合、データの欠落が発生しないため、[Configure no data and error handling] は設定しません。

ステップ 2: Alert rule の詳細を設定する

Alert rule の名前や Label を設定します。

  1. 以下のように設定します。

    項目説明
    [Rule name]「Temperature alert (information)」を入力します。Alert rule の名前です。
    [Folder][+Add new] を選択し、「Sample」を入力して、Enter キーを押します。Alert rule を保存する Folder が作成されます。
    [Group]「Sample group」を入力します。Alert rule の Group の名前です。

    次に、Alert rule の Label を設定します。このあとに設定する Notification policy では、この Label を監視します。

  2. 以下のように設定します。

    2 つ目の Label の入力欄を追加するには、[+Add label] をクリックします。

    [key][value]
    「severity」を入力して、Enter キーを押します。「info」を入力して、Enter キーを押します。
    「alert_type」を入力して、Enter キーを押します。「temperature」を入力して、Enter キーを押します。

  3. 画面右上にある [Save] をクリックします。

ステップ 3: メールの送信先を設定する (Contact point)

Contact point を作成して、メールで通知するための Contact point (メールの送信先) を作成します。

  1. [ (Alerting)][Contact points][+New contact point] の順にクリックします。

    「New contact point」画面が表示されます。

    Message templates については、Message template を作成する を参照してください。

  2. 以下の項目を設定します。

    項目説明
    [Name]「Sample member mail address」を入力します。Contact point の名前です。
    [Contact point type]「Email」を選択します。
    [Addresses]Alert 通知先のメールアドレス (例: member@example.com) を指定します。

  3. [Save contact point] をクリックします。

ステップ 4: Alert rule と Contact point を関連付ける (Notification policy)

Notification policy を設定して、上記で登録した Alert rule と Contact point を関連付けます。

  1. [ (Alerting)][Notification policies][+New policy] の順にクリックします。

    新しい Policy が作成されます。

  2. 以下の項目を設定します。

    項目説明
    [Matching labels]

    [+Add matcher] をクリックして、以下の Label を設定します。

    [label][Operator][value]
    「severity」を入力します。「=」を選択します。「info」を入力します。
    「alert_type」を入力します。「=」を選択します。「temperature」を入力します。

    この Policy が動作する条件です。条件に一致すると、次の [Contact point] で選択した Contact point に Alert が通知されます。

    [Contact point]Alert を通知する Contact point (例: Sample member mail address) を選択します。

  3. [Save policy] をクリックします。

以上で、3 分ごとにサンプルデータソース (Demo) の Device-1 の最新 5 分間の温度の平均値を確認し、平均値が 24 °C を超えたら、担当者 (member@example.com) にメールで通知されます。

通知が不要になったときは

通知が不要になったときは、作成した設定を以下の順番で削除します。

  1. Notification policy の Specific routing を削除します。

    詳しくは、Specific routing を削除する を参照してください。

  2. Contact point を削除します。

    詳しくは、Contact point を削除する を参照してください。

  3. Alert rule を削除します。

    詳しくは、Alert rule を削除する を参照してください。