SORACOM Users

SORACOM Lagoon Documents

SORACOM Lagoon のアラートをカスタマイズする

このドキュメントでは SORACOM Lagoon のアラートをカスタマイズするシナリオ別の方法、および注意点を紹介します。

アラートを作成する

アラートの作成方法はチュートリアル「SORACOM Lagoon を利用してアラートを設定する」のステップ 3: Lagoon でアラートチャンネルを設定するおよび ステップ 4: Lagoon でアラートを設定するを参照してください。

各設定値の名称

カスタマイズする設定値の候補は以下となります。

  1. 評価間隔
  2. 条件の WHEN 句(max(), last() などの集約条件)
  3. 条件の OF 句(データを取得する対象と評価の範囲)
  4. データが無いか全ての値が Null の時
  5. 実行エラーまたはタイムアウトの時

Lagoon ダッシュボードのグラフパネルのアラートタブにおいて、各設定値は下図のように対応しています。

上記に加えて、ダッシュボードの更新間隔も Lagoon のアラートをカスタマイズする上で重要なパラメータです。更新間隔は SORACOM Lagoon のプランによって異なります。Free で 60s (秒) 以上、Maker で 30s 以上、Pro で 5s 以上です。各プランの詳細は SORACOM Lagoon プランを参照してください。

アラートの持つ状態

アラートは以下 3 つの状態を持ちます。他の状態に遷移した際にアラートが発報されます。

注意
  • ALERTING 状態で再度アラートの条件を満たしてもアラートは発報されず、一度 OK または NO DATA 状態へ遷移する必要があります。
  • OK または NO DATA 状態へ遷移した際もアラートが発報されます。現時点ではこの発報を無効にできません。

アラート設定例 : 温度センサーデバイス

温度などをセンサーで計測し、過去 4 分間の最大値が 30 より大きい場合にアラートを発報するシナリオを考えます。設定例は以下の通りです。

また、上記では評価の範囲を過去 4 分間としています。これは評価の範囲をダッシュボードの更新間隔および評価間隔の 3 ~ 4 倍にするのがアラートの漏れを防止しやすいためです。式で表すと以下のようになります。

ダッシュボード更新間隔 = 評価間隔 << データ取得範囲 (3 ~ 4 倍)

なお、ダッシュボード更新間隔は SORACOM Lagoon のプランによって異なります。Free で 60s 以上、Maker で 30s 以上、Pro で 5s 以上です。

アラート設定例 : ボタン型デバイス

SORACOM LTE-M Button for Enterprise のようなデバイスから不定期に送信された値を発報するシナリオを考えます。設定例は以下の通りです。

WHEN 句に last を使うときの注意点

デバイスからのデータの送信間隔はダッシュボードの更新間隔および評価間隔よりも長くします。これをしないと、アラートが発報されない場合があります。詳細は FAQ : SORACOM Lagoon のアラートがトリガーされないことがあるを参照してください。式で表すと以下のようになります。
ダッシュボード更新間隔 = 評価間隔 < デバイスからのデータの送信間隔

上記では評価の範囲を過去 4 分間としています。これは評価の範囲をダッシュボードの更新間隔および評価間隔の 3 ~ 4 倍にするのがアラートの漏れを防止しやすいためです。式で表すと以下のようになります。

ダッシュボード更新間隔 = 評価間隔 << データ取得範囲 (3 ~ 4 倍)

なお、ダッシュボード更新間隔は SORACOM Lagoon のプランによって異なります。Free で 60s 以上、Maker で 30s 以上、Pro で 5s 以上です。

データが無いか全ての値が Null の時 の注意点

Alerting, No Data, Keep Last State, Ok を設定できます。お使いの要件によって適切な設定が異なりますが、よく利用されるのは「No Data」です。

「Alerting」や「Ok」とすると、アラート条件に合致しての「Alerting」の発報やアラート条件から復帰しての「Ok」の発報との区別がつきづらくなります。また、「Keep Last State」とするとデータが送られていないまたは異常値となっていることに気づけない場合があります。これらに注意したうえで、要件に合わせて設定してください。

実行エラーまたはタイムアウトの時 の注意点

「実行エラーまたはタイムアウトの時」は、SORACOM Lagoon のシステムエラーなどの理由で状態をアラートとすべきか判断できない場合の条件です。「Keep Last State」とすることを推奨します。

Lagoon を利用しないアラート送信パターン

現時点において SORACOM Lagoon からのアラートでは、以下のようなパラメータを変更できないという制約があります。

さらなるカスタマイズをしたい場合は他の SORACOM サービスを利用することも考えられます。 例として 2 つのパターンを紹介します。これらのパターンでは連携先のサービスにてお客様が条件の設定および通知機能の実装をする必要があり、また Unified Endpoint などを利用してそれぞれのサービスへデータを送信する必要があることに留意してください。

SORACOM Funk + FaaS パターン

SORACOM Funk は AWS Lambda、Azure Functions など各種パブリッククラウドの FaaS へ連携するサービスです。連携した FaaS にて通知先や条件を設定します。

例 : SORACOM Funk を利用して AWS Lambda を呼び出し Slack へ通知する

SORACOM Funnel + クラウドサービスパターン

SORACOM Funnel は AWS IoT Core、Azure Event Hubs などのクラウドサービスや SORACOM パートナースペースの認定済みパートナー様が運営するクラウドサービスなどへの連携ができます。連携したクラウドサービスにて通知先や条件を設定します。

例 : SORACOM Funnel AWS IoT アダプターを使用してデータを送信する

Getting Started

SORACOM Air for セルラー

SORACOM Air for LoRaWAN

SORACOM Air for Sigfox

SORACOM Beam

SORACOM Canal/Direct/Door

SORACOM Endorse

SORACOM Funnel

SORACOM Funk

SORACOM Gate

SORACOM Harvest

SORACOM Inventory

SORACOM Junction

SORACOM Krypton

SORACOM Lagoon

SORACOM Mosaic

SORACOM Napter

SORACOM Orbit

SORACOM Peek

SORACOM LTE-M Button

GPS マルチユニット SORACOM Edition

IoT 体験キット

Device

サービス機能詳細

Developer Tools

Design Patterns

pagetop