> For the complete documentation index, see [llms.txt](https://docs.roboflow.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.roboflow.com/deployment/ja/to/vision-events/no-events-alerts.md).

# イベント未受信アラート

カメラ、ストリーム、またはワークフローからイベントが送信されなくなったときにメールを受け取り、停止に数日ではなく数分で気づけます。

イベント未受信アラートは、Use Caseが [Use Case](https://docs.roboflow.com/deployment/ja/to/vision-events/use-cases.md) イベントを受信しなくなったときに、チームにメールを送信します。Use Caseがどのくらいイベントを受信しない状態になったら通知するか（例：30分）と、通知先を指定できます。その時間内にイベントが届かなければ、最後にイベントが届いた時刻を知らせるメールが1通送信されます。

ビジョンシステムに障害が起きても、たいていは何も通知されません。カメラの電源が落ちる、ストリームが停止する、ネットワークスイッチが接続を切る、更新後にエッジデバイスがオフラインになる、Workflowの実行が止まる、といったことが起こります。エラーは発生せず、モデルの精度も変わらないように見えます。ただイベントが届かなくなり、検査が行われないままラインが稼働し続けます。アラートがなければ、シフトの集計値が空になったり、不良品が顧客に届いたりして、数日後にようやく問題に気づくことも少なくありません。

イベント未受信アラートは、 [Automation](https://docs.roboflow.com/deployment/ja/to/vision-events/automations.md)の一種です。そのため、同じ「Automations」タブに表示され、アクティビティ履歴にも記録されます。

## イベント未受信アラートを作成する

アラートの作成、編集、削除には、Manage Vision Events [権限](https://docs.roboflow.com/platform/enterprise-features/role-based-access-control) が必要です。ワークスペース管理者には、デフォルトでこの権限が付与されています。

<figure><img src="https://970637113-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoksNmwps1HmYr8TqHDnX%2Fuploads%2Fgit-blob-ea48303ba5eb989df7e53a75cc4fa7651395dd5d%2Fno-events-alert-tiles.png?alt=media" alt="The Automations tab of a Use Case with no Automations, showing the Operator feedback preset, No-events alert, and Custom automation tiles"><figcaption><p>AutomationがまだないUse Caseには、開始方法が3つ表示されます。</p></figcaption></figure>

1. 左側のサイドバーで「Vision Events」をクリックし、すでにイベントを受信しているUse Caseを開きます。イベントの送信を開始する方法については、 [イベントを送信する](https://docs.roboflow.com/deployment/ja/to/vision-events/send-events.md).
2. 「Automations」タブを開きます。
3. Use CaseにAutomationがまだない場合は、「No-events alert」をクリックします。すでにある場合は、「New Automation」をクリックし、「Trigger」を「No events arrive」に設定します。
4. 名前を入力します（例：「ライン3のカメラが無反応」）。メールの件名はこの名前で始まるため、監視対象がわかる名前を付けてください。
5. Use Caseがイベントを受信しない状態をどのくらい許容するか、「Alert After」で設定します。15分から7日の範囲で数値と単位（Minutes、Hours、Days）を選択します。デフォルトは30分です。
6. 「Recipients」で、対応できる人を最大10名選択します（例：ラインの保全担当者、シフト監督者、ビジョンシステムの運用担当者）。各受信者はワークスペースのメンバーで、「View Vision Events」権限を持っている必要があります。
7. 「Enabled」にチェックが入っていることを確認し、「Save Automation」をクリックします。

<figure><img src="https://970637113-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoksNmwps1HmYr8TqHDnX%2Fuploads%2Fgit-blob-ed7c462b47c551e0a8959230b3993c6c673959b0%2Fno-events-alert-editor.png?alt=media" alt="The New Automation editor with Trigger set to No events arrive and Alert After set to 30 minutes" width="375"><figcaption><p>イベント未受信アラートには、名前、「Alert After」の期間、受信者の設定が必要です。</p></figcaption></figure>

アラートは「30分間イベントを受信していません」のような概要とともにリストに表示されます。イベント未受信アラートには条件を設定できず、メールのみ送信できます。

## 待機時間を選ぶ

「Alert After」は、イベント間の通常時の最長間隔より少し長めに設定してください。短すぎると、通常の停止中にもメールが届きます。長すぎると、誰かが気づくまで検査なしでラインが稼働する時間が長くなります。

<table data-search="false"><thead><tr><th>Use Caseによるイベント送信の頻度</th><th>「Alert After」の推奨設定</th></tr></thead><tbody><tr><td>1分に数回（例：ボトリングラインでボトルごとにイベントを送信するカメラ）</td><td>15～30分</td></tr><tr><td>1時間に数回（例：ステーションに部品が到着したとき）</td><td>1～2時間</td></tr><tr><td>スケジュールされたバッチで送信（例：1時間ごとの検査実行）</td><td>バッチ間隔より少し長め（例：1時間ごとの実行なら90分）</td></tr><tr><td>稼働時間中のみ</td><td>予定している最長の停止時間より長く設定する（例：週末をカバーするために3日）、または生産時間外はアラートをオフにする</td></tr></tbody></table>

Roboflowは5分ごとに確認するため、メールは「Alert After」の期間が経過してから約5分以内に届きます。時間は最後のイベントを起点に計算されます。待機時間を30分に設定し、最後のイベントが9:00に届いた場合、メールは9:35ごろまでに届きます。

## イベントとしてカウントされるもの

このアラートはUse Case全体を監視します。どのデバイス、ストリーム、Workflow、API呼び出しからのイベントもカウントされるため、Use Case全体でイベントが途絶えた場合にのみアラートが送信されます。5台のカメラのうち1台がオフラインになっても、残り4台がイベントを送り続けていれば、アラートは送信されません。

Roboflowは、イベントに含まれるタイムスタンプではなく、イベントを受信した時刻を使います。 [エッジデバイスのバックアップ](https://docs.roboflow.com/deployment/ja/to/vision-events/send-events.md) から遅れて送信されたイベントも、届いた時点でカウントされます。 [オペレーターのフィードバック](https://docs.roboflow.com/deployment/ja/to/vision-events/operator-feedback.md) と削除されたイベントはカウントされません。

位置がずれたり、レンズが汚れたりしたカメラは、通常イベントの送信を続けるため、イベント未受信アラートは作動しません。画像品質の問題を検出するには、 [カメラ品質の監視を自動化する](https://roboflow.com/blog/automate-camera-quality-monitoring).

{% hint style="info" %}
カメラごとに監視するには、Deployment Managerの [デバイスアラート](https://docs.roboflow.com/deployment/ja/self-hosted/enterprise/deployment-manager/setting-up/set-up-device-alerts.md) を使用してください。各デバイスの接続状態と、各ストリームのカメラFPSおよび推論FPSを監視します。イベント未受信アラートは、クラウド上のWorkflow、自分で用意したコードからのAPI呼び出し、実行は続いていてもイベントを送信しなくなったWorkflowなど、デバイスアラートでは確認できない送信元も対象にできます。
{% endhint %}

## アラートメール

障害1回につき、各受信者にメールが1通送信されます。メールには次の情報が表示されます。

* 件名にはアラート名に続けて「No events for」と「Alert After」の期間が表示されます（例：「No events for 30 minutes」）。
* ユースケースと、Roboflowがイベントの途絶を検知したタイミング。
* 「最終イベント」：最後にイベントが届いた時刻です。これにより、停止が数分前に始まったのか、昨日始まったのかを確認できます。過去30日間にイベントが届いていない場合、または最後のイベントがワークスペースの [保持期間](https://docs.roboflow.com/deployment/ja/to/vision-events.md#data-retention)を超えている場合は、「過去30日間にイベントはありません」と表示されます。
* 「通知までの時間」：設定した期間です。
* ユースケースを開く「Vision Eventsで表示」ボタン。

受信者が異なるタイムゾーンにいる場合があるため、時刻はUTCで表示されます。

## 通知メールが送信されるタイミング

* 停止1回につきメールは1通です。チェックで「通知までの時間」全体にわたってイベントがないことが確認されると、停止が始まります。停止がどれほど長く続いても、その停止についてメールは1通だけ届きます。
* イベントが届くと停止は終了します。「最近のアクティビティ」には「イベント再開」と表示されます。復旧を知らせるメールは送信されません。
* 次の停止では、新しいメールが送信されます。イベントが再び「通知までの時間」いっぱい止まった場合、それは新たな停止です。
* 新規作成または編集したアラートには、最初に待機時間が設けられます。アラートの作成または保存後、名前、受信者、「有効」チェックボックスを変更した場合も含め、「通知までの時間」全体が経過するまでメールは送信されません。ユースケースがすでに停止状態の場合、その期間の経過後にメールが届き、最終イベントの実際の時刻も表示されます。

## アラートをテストする

1. ユースケースで「通知までの時間」を15分に設定したアラートを作成します。
2. イベントを送信しているデバイス、ストリーム、またはスクリプトを停止します。
3. イベント停止から15～20分後にメールが届くことを確認します。また、アラートを保存してから15分が経過する前にメールが届くことはありません。
4. イベントの送信を再開します。「最近のアクティビティ」に「イベント再開」と表示されます。

## アラートを確認する

「自動化」タブにある各アラートのカードには、「通知までの時間」、受信者、1日あたりのメール上限が表示されます。受信者がワークスペースを離れた場合、またはView Vision Events権限を失った場合、カードに警告が表示され、そのユーザーは対象から除外されます。

<figure><img src="https://970637113-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoksNmwps1HmYr8TqHDnX%2Fuploads%2Fgit-blob-e851f8071f647abf130ad908ca43d8a168c61bac%2Fno-events-alert-card.png?alt=media" alt="A No-Events Alert card showing No events received for 15 minutes, the email action, and a daily email cap of 50"><figcaption></figcaption></figure>

「最近のアクティビティ」には各実行が一覧表示されます。イベントなしアラートの実行では、「イベントタイプ」列に「イベントなし」と表示されます。

<figure><img src="https://970637113-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoksNmwps1HmYr8TqHDnX%2Fuploads%2Fgit-blob-a3ca7b0b9035445ef72b6ed9692cb3859225989e%2Fno-events-alert-activity.png?alt=media" alt="Recent activity showing a No events run marked Emailed and another marked Events resumed"><figcaption></figcaption></figure>

<table data-search="false"><thead><tr><th width="200">ステータス</th><th>意味</th></tr></thead><tbody><tr><td>メール送信済み</td><td>アラートメールが送信されました。</td></tr><tr><td>イベント再開</td><td>メールが送信された停止の後、イベントが再び届きました。</td></tr><tr><td>上限到達</td><td>アラートが1日あたりのメール上限に達しました。</td></tr><tr><td>使用量の一時停止</td><td>ワークスペースの使用が一時停止中かクレジット切れのため、メールは保留中です。ユースケースが停止状態の間に使用が再開されると、メールが送信されます。</td></tr><tr><td>メール送信失敗</td><td>メールを送信できませんでした。「 <a href="#limits">制限</a>.</td></tr></tbody></table>

実行履歴は90日間保存されます。アラートの作成、編集、削除はワークスペースの「 [監査ログ](https://docs.roboflow.com/platform/enterprise-features/audit-logs-and-siem-export).

## 制限

* 「通知までの時間」：15分～7日。
* 受信者：View Vision Events権限を持つワークスペースメンバーを最大10人まで指定できます。アラートはメールのみです。
* 1日あたりのメール上限：デフォルトは1日50通で、最大1,000通まで設定できます。停止1回につきメールは1通のため、この上限が問題になるのは、1日にユースケースの停止と復旧が何度も繰り返される場合のみです。日付はUTCの午前0時に切り替わります。
* ワークスペースのメール上限：各ワークスペースは1日あたり1,000通のメールを送信できます。この上限は、Workflowのメールブロックおよび「 [サマリーレポート](https://docs.roboflow.com/deployment/ja/to/vision-events/summary-reports.md)」と共有されます。この上限によりアラートのメール送信が拒否されると、「メール送信失敗」と表示され、停止が続いている間は5分ごとに再試行されます。
* 再試行：送信に失敗すると、チェックのたびに再試行されます。失敗が約1時間続くと、停止は「メール送信失敗」として記録され、再試行されなくなります。
* オフにしたアラートとアーカイブ済みのユースケースはチェックされません。
* 他のRoboflowメール通知と同様に、アラートメール1通につき0.01クレジットを消費します。
* イベントなしアラートはRoboflowのWebアプリで設定します。API経由では作成できません。
