> 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/roboflow-cloud/cloud-streaming/manage-and-monitor.md).

# 管理と監視

Cloud Streaming ジョブを監視し、処理を再開または停止し、コネクタのオフライン通知を設定します。

Cloud Streaming を使うと、ソースの状態と Workflow の状態を個別に確認できます。カメラがオンラインでも Workflow が処理中とは限りません。また、カメラがオフラインでも、動画を待機している Workflow は有効なままの場合があります。

## Web アプリ

「Deployments」を開き、次に「Cloud Streaming」を開きます。コネクターを開くとそのソースを確認でき、ソースを開くとその Workflow の実行を確認できます。ドラフトのプレビューはデプロイとは別に表示されるため、出力、エラー、または操作を確認する前に、対象の実行を選択してください。

### 処理状態

<table data-search="false"><thead><tr><th>状態</th><th>確認する内容</th></tr></thead><tbody><tr><td>動画を待機中</td><td>使用可能な入力がありません。コネクターまたは配信元を確認してください。</td></tr><tr><td>キャパシティを待機中</td><td>GPU を待機中です。ジョブを追加しても解決しません。</td></tr><tr><td>起動中</td><td>Workflow とモデルを読み込んでいます。</td></tr><tr><td>処理中</td><td>フレーム数が増加していることを確認してください。</td></tr><tr><td>再接続中または再試行中</td><td>復旧中です。トラッカーとカウンターはリセットされます。</td></tr><tr><td>リソースを調整中</td><td>メモリ不足が発生したため、より大きな GPU で再起動しています。</td></tr><tr><td>対応が必要</td><td>5 回失敗した場合、処理が 15 分間行われなかった場合、または 1 時間に 10 回起動した場合、復旧は一時停止します。原因を解消してから再起動してください。</td></tr><tr><td>復旧が一時停止中または失敗</td><td>再起動する前にエラーを確認してください。</td></tr><tr><td>停止中</td><td>自動では再開しません。</td></tr></tbody></table>

復旧なしで実行するもの（例: プレビュー）には、生の状態（例: "Queued"、"Running"）が表示されます。

「Needs Attention」には、オフラインのコネクターとブロックされている Workflow が表示されます。詳しくは [トラブルシューティング](https://docs.roboflow.com/deployment/ja/roboflow-cloud/cloud-streaming/troubleshooting.md).

### アクティビティ

実行を選択し、「Activity」を開くと、自動復旧が有効な場合に最新のライフサイクル変更（最大 30 件）を確認できます。待機、再試行、失敗の理由が表示されます。予測履歴、動画アーカイブ、ログではありません。これらについては、 [最新の結果、シンク、または保存済みのキャプチャ](https://docs.roboflow.com/deployment/ja/roboflow-cloud/cloud-streaming/consume-results.md) を使用してください。

### ログ

ソースのメニューで「Logs」をクリックすると、その Workflow の実行におけるプロセッサーの出力を確認できます。カスタム Python ブロックの出力も含まれます。再起動するたびに新しい実行が開始されます。ログには Workspace のログ保持期間が適用され、 [デバイスログ](https://docs.roboflow.com/deployment/ja/self-hosted/enterprise/deployment-manager/monitoring/view-device-logs.md)と同様に料金が発生します。実行中は、このダイアログから [最近の結果をダウンロード](https://docs.roboflow.com/deployment/ja/roboflow-cloud/cloud-streaming/consume-results.md#web-app) することもできます。

### 処理を再起動する

再起動すると、最新の公開済み Workflow が適用され、メモリ内の状態がリセットされます。ただし、 [再起動時の動作](https://docs.roboflow.com/deployment/ja/roboflow-cloud/cloud-streaming/run-a-workflow.md#restarts).

で説明されている例外があります。実行を選択し、「Restart」をクリックします。ソース一覧からの再起動では、プレビューはスキップされます。アップロードしたファイルの場合は、「Run Again」をクリックします。最大の GPU でもメモリ不足になった場合は、「Choose a Workflow」をクリックし、より軽量な Workflow を選択してください。

有効なデプロイをすべて再起動するには、「Restart All Streams」をクリックし、ソース数と Workflow 数を確認して、「Restart All」を確定します。停止中のストリームは停止状態のままです。一部の再起動だけが成功した場合、「Try Again」をクリックすると、未完了のものだけが再試行されます。

再起動によって以前の実行を停止している間は、新しいジョブを開始しないでください。

### 処理を停止する

実行を選択し、「Stop」をクリックしてから「Stop processing」をクリックします。不要になった実行はそれぞれ停止してください。ページを閉じてもデプロイは停止しません。詳しくは [停止](https://docs.roboflow.com/deployment/ja/roboflow-cloud/cloud-streaming/run-a-workflow.md#stopping).

### ソースの名前を変更または削除する

コネクターに接続されたソースはアクションメニューから、直接接続されたソースは「Connection Settings」から名前を変更できます。「Delete」は、実行を停止するためではなく、ソース自体を削除する場合にのみ使用してください。削除したカメラがコネクターから引き続き報告されると、そのカメラは再登録されます。表示されない状態を維持するには、コネクターの設定でカメラを無効化または削除してください。

## オフライン通知

通知は Workspace 単位でオプトインする必要があります。コネクターを登録しただけでは、メールは送信されません。

1. 「Cloud Streaming」で「オフライン通知」をクリックします。
2. 通知を有効にし、Workspace のメンバーから受信者を選択します。
3. オフラインのしきい値、リマインダーの設定、1時間あたりおよび1日あたりの上限を設定します。
4. 「保存」をクリックします。保存せずにダイアログを閉じても、通知は有効になりません。

新しい設定の場合、ダイアログでは設定を行っているメンバーが選択され、オフラインのしきい値は5分、リマインダーは有効、メールの上限は1時間あたり2通、1日あたり10通に設定されます。既存の無効な設定は、開いても無効のままです。上限は各コネクタ個別ではなく、Workspace 全体に適用されます。

各メールには、Workspace 内で通知対象となるオフラインストリームがまとめられます。新たな障害は、しきい値に達した後、同じ上限の範囲内で更新通知を発生させることがあります。リマインダーの間隔は、30分、1時間、2時間、4時間と順に長くなり、その後は6時間ごとになります。新たにオフラインになったストリームがあると、このスケジュールはリセットされます。復旧通知メールは送信されません。

コネクタのページを開き、「オフライン通知」切り替えを使って、そのコネクタを通知対象から除外または追加します。コネクタはデフォルトで通知対象に含まれますが、Workspace で通知設定を保存し、有効にしておく必要があります。

### 通知の対象範囲

メール通知の対象は、通知対象に含まれるコネクタ上で、復旧処理を含むデプロイメントを実行しているカメラです。プレビュー、直接ソース、ブロックされた Workflow は対象外です。

メールは、しきい値を過ぎてから届く場合があります。

テストには「自分にテストメールを送信」を使用します。受け付けられたことは、受信トレイへの配信を確認するものではありません。

## 権限

「ストリーム処理の表示」では、ソースと実行に関する情報にアクセスできます。ソース設定の変更、処理の開始または停止、通知の変更、テストメールの送信には、「ソース動画の管理」が必要です。ライブプレビューと視聴操作では動画の配信を要求するため、管理権限も必要です。キャプチャの保存には、アップロード権限も必要です。

必要なアクセス権を各オペレーターに付与するには、 [カスタムロール](https://docs.roboflow.com/platform/enterprise-features/role-based-access-control) を使用します。API 連携では、対応する [API キーのスコープ](https://docs.roboflow.com/reference/authentication/authentication/scoped-api-keys).

## HTTP API

ジョブを読み取り、現在の状態とエラーを確認します。リクエストがタイムアウトしても成功したと判断しないでください。状態を変更する操作を再試行する前に、既存のジョブを確認します。

{% openapi src="/files/1398286bea32cc2689a4df3f30ae94e233631c05" path="/{workspace}/video-jobs/v1/{jobId}" method="get" %}
[cloud-streaming.yaml](https://970637113-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoksNmwps1HmYr8TqHDnX%2Fuploads%2Fgit-blob-2927c06848d4341631bbd3bafea073b855e32b47%2Fcloud-streaming.yaml?alt=media)
{% endopenapi %}

処理を終了する場合はジョブをキャンセルし、終端状態になるまで読み取ります。実行中のプロセッサは非同期で停止します。

{% openapi src="/files/1398286bea32cc2689a4df3f30ae94e233631c05" path="/{workspace}/video-jobs/v1/{jobId}/cancel" method="post" %}
[cloud-streaming.yaml](https://970637113-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoksNmwps1HmYr8TqHDnX%2Fuploads%2Fgit-blob-2927c06848d4341631bbd3bafea073b855e32b47%2Fcloud-streaming.yaml?alt=media)
{% endopenapi %}

再起動、昇格、コネクタ管理、オフライン通知の設定には API エンドポイントがありません。これらの操作には Web アプリを使用してください。
