通知設定について
通知設定は、SORACOM アカウント (以下、オペレーター) で「通知できるイベント」が発生したときに、あらかじめ指定した方法で通知する機能です。「通知できるイベント」は、料金の違いによって以下のように分類され、それぞれ異なる画面で設定します。
| 分類 | 説明 | レート制限 |
|---|---|---|
| アカウントに対して発生するイベント | たとえば、アカウントに新しいソラカメ対応カメラを登録したとき (デバイス追加時) に、「メールでメールアドレス 詳しくは、SORACOM アカウント (オペレーター) に対するイベント通知を設定する を参照してください。 通知タイプ:
| なし |
| ソラカメ対応カメラの状態が変化したときに発生するイベント | たとえば、指定したソラカメ対応カメラがオンラインの状態で、クラウド常時録画が停止したとき (クラウド常時録画停止時) に、「Webhook で AWS Lambda に内容 B で通知する」といった設定ができます。 詳しくは、ソラカメ対応カメラに対するイベント通知を設定する を参照してください。 通知タイプ:
ソラカメ対応カメラに対するイベント通知を設定すると料金が発生しますソラカメ対応カメラに対するイベント通知を設定すると料金が発生します。料金は、利用する機能によって異なります。詳しくは、料金について の (C)通知オプション -Public Beta- を参照してください。 | なし |
| ソラカメ対応カメラがイベントを検知したときに発生するイベント | たとえば、ソラカメ対応カメラがモーションを検知したとき (モーション検知時) に、「Webhook で AWS Lambda に内容 C で通知する」といった設定ができます。 詳しくは、ソラカメ対応カメラに対するイベント通知を設定する を参照してください。 通知タイプ:
ソラカメ対応カメラに対するイベント通知を設定すると料金が発生しますソラカメ対応カメラに対するイベント通知を設定すると料金が発生します。料金は、利用する機能によって異なります。詳しくは、料金について の (C)通知オプション -Public Beta- を参照してください。 | あり (*2) |
- (*1) イベントが発生してから最大で約 15 分後に通知されます。
- (*2) 「ソラカメ対応カメラがイベントを検知したときに発生するイベント」には、時間あたりの通知可能数に制限があります (レート制限)。
時間あたりの通知可能数に制限があります (レート制限)
「ソラカメ対応カメラがイベントを検知したときに発生するイベント」には、時間あたり (1 分、1 時間、1 か月) の通知可能数に制限 (レート制限) があります。そのほかのイベントにはレート制限はありません。
メールで通知する場合は、設定した通知先ごとに 1 時間あたり最大 10 通、1 か月あたり最大 1,000 通まで送信できます。制限を超えた通知が発生した場合、通知内容は破棄され、再送されません。このとき、イベントの種類や通知内容は考慮されません。
たとえば、複数のイベントが発生したときに、イベントの種類に関わらずひとつの通知先に通知する設定にした場合、1 時間のうちに 11 件のイベントが発生すると、制限を超えるため 11 件目の通知内容は破棄されます。
Webhook で通知する場合は、1 デバイスごとに 1 分間あたり最大 4 回、1 か月あたり最大 10,000 回まで通知できます。制限を超えた通知が発生した場合、通知内容は破棄され、再送されません。このとき、イベントの種類や通知内容は考慮されません。
レート制限によって通知されなかったことは、ユーザーコンソールや SORACOM CLI / SORACOM API では確認できません。
今月の送信件数と最近の送信結果を確認する
通知機能で通知されるイベントのうち、有料の通知タイプの利用量を確認できます。通知タイプについて詳しくは、通知設定について を参照してください。
- ソラカメ対応カメラの状態が変化したときに発生するイベント (デバイスオンライン、デバイスオフライン、クラウド常時録画停止)
- ソラカメ対応カメラがイベントを検知したときに発生するイベント (モーション検知/サウンド検出)
今月のメールと Webhook の送信件数を確認する
メールと Webhook は、1 か月あたりの通知可能数に制限があります (レート制限)。通知設定画面の タブでは、今月のメールと Webhook の送信件数を確認できます。レート制限について詳しくは、時間あたりの通知可能数に制限があります (レート制限) を参照してください。
ユーザーコンソール にログインし、カバレッジタイプを「日本」に変更します。
詳しくは、SORACOM ユーザーコンソールで表示するカバレッジタイプを変更する を参照してください。
→ → の順にクリックします。
「ソラカメ通知オプションのご利用について」画面が表示されたときは、内容を理解したうえで、 をクリックします。
通知設定画面が表示されます。
タブをクリックします。
ソラカメ対応カメラごとに、今月のメールおよび Webhook の送信件数が表示されます。
最近の送信結果を確認する
直近 2 週間のメールと Webhook の送信結果を確認できます。
通知設定画面で タブをクリックして、 で送信結果を確認するメッセージタイプを選択します。
に「送信エラー」が表示されている場合は、マウスポインターをあわせると、送信エラーの理由が表示されます。
送信結果の詳細を確認するには、行をクリックします。
メールの場合は、E メール通知送信結果画面が表示されます。
メールの宛先、件名、本文が確認できます。
Webhook の場合は、Webhook 通知送信結果画面が表示されます。
Webhook のリクエストヘッダーやリクエストボディ、サーバーからのレスポンスヘッダーやレスポンスボディが確認できます。