For the complete documentation index, see llms.txt. This page is also available as Markdown.

管理と監視

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

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

Web アプリ

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

処理状態

状態
確認する内容

映像を待機中

Workflow は有効なままですが、使用可能な入力がありません。ソースを復旧し、そのコネクタまたはパブリッシャーを確認してください。

処理能力を待機中

実行は処理リソースを待機しています。重複するジョブを開始しても、処理能力の問題は解決しません。

開始中

プロセッサーが Workflow を開始し、モデルを読み込んでいます。

処理中

ソースのオンライン表示だけでなく、出力と増加し続けるフレーム統計を確認してください。

再接続中または再試行中

復旧中です。再生に途切れが生じる場合があります。また、新しい実行では状態を保持するブロックの状態がリセットされます。

要対応

エラーを確認してください。ブロックされた Workflow には設定の修正または明示的な再試行が必要です。映像を待機しているだけではありません。

復旧が一時停止または失敗

再起動する前に失敗の内容を確認してください。処理能力、Workflow の設定、リソース要件、クレジットを確認してください。

停止

処理は自動的に再開されません。必要に応じて明示的に開始または再起動してください。

「要対応」は、ブロックされている、または映像を受信していない有効な Workflow を示します。これは、下流アプリケーションのヘルスチェックに代わるものではありません。対処方法については、 トラブルシューティング.

アクティビティ

実行を選択して「アクティビティ」を開くと、自動復旧が有効な場合に、直近のライフサイクル変更(最大30件)を確認できます。待機、再試行、失敗の理由が表示されます。これは予測履歴、動画アーカイブ、ログではありません。それらを確認するには、 最新の結果、シンク、または保存済みキャプチャ を使用してください。

処理を再起動する

再起動すると、最新の公開済み Workflow が適用され、メモリ内の状態がリセットされます。ただし、 再起動時の動作.

1つの実行を再起動するには、ソースページでその実行を選択し、「Restart」をクリックします。ソース一覧の再起動アクションは、そのソースの保存済み Workflow のうちアクティブなデプロイを対象とします。アクティブなものがない場合は、最後に終了したデプロイが対象となり、プレビューはスキップされます。アップロード済みファイルとリソース制限による失敗は、それぞれの詳細ページから再起動してください。

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

再起動によって古い実行が停止中の間は、新しいジョブを作成しないでください。メッセージが表示されたら、再起動を再試行してください。

処理を停止する

実行を選択し、「Stop Processing」または「Stop」をクリックして、停止が完了するまで待ちます。1つのソースに複数の実行がある場合があります。不要になった実行はそれぞれ停止してください。ページを閉じたりカメラのプラグを抜いたりしても、デプロイは停止しません。詳しくは、 停止.

ソースの名前変更または削除

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

オフライン通知

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

  1. 「Cloud Streaming」で、「Offline notifications」をクリックします。

  2. 通知を有効にし、Workspace メンバーから受信者を選択します。

  3. オフラインのしきい値、リマインダーの設定、1時間あたりおよび1日あたりの上限を設定します。

  4. 「Save」をクリックします。ダイアログを開いただけでは、保存されないため通知は有効になりません。

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

各メールには、Workspace 全体で通知条件を満たすオフラインのストリームがまとめられます。新たな障害がしきい値を超えると、同じ上限の範囲内で通知が送信される場合があります。リマインダーの間隔は徐々に長くなり、30分後、続いて1時間後、2時間後、4時間後、その後は6時間ごとになります。新たにオフラインになったストリームがあると、このスケジュールはリセットされます。復旧メールは送信されません。

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

通知の対象範囲

監視対象のコネクタが、映像を必要とする有効でブロックされていない永続的な Workflow に映像を供給している場合、そのストリームは通知対象になります。映像を待機中の場合も対象です。プレビューのみの利用、直接接続されたソース、無効な処理、設定によってブロックされた Workflow は対象外です。

通知は観測された稼働状況に基づくものであり、所定の期限内に届くことを保証するものではありません。映像の受信が一定時間継続して観測されると、障害状態は解消されます。処理をオフにしたり、コネクタを通知対象から除外したりすると、そのコネクタの通知は停止しますが、カメラが復旧したことを示すものではありません。

自分のアカウント宛てにテストを送信するには、「自分にテストメールを送信」を使用します。「配信を受け付けました」という表示は、受信トレイに届いたことを意味するものではありません。テストを行っても、設定の保存は別途必要です。

権限

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

必要なアクセス権を各オペレーターに付与するには、 カスタムロール を使用します。API連携では、対応する APIキーのスコープ.

HTTP API

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

Get a Workflow job

get

Read the current job without changing its state. Follow executionGeneration and successorJobId when observing replacement executions. A persistent waiting or blocked job still represents enabled intent until explicitly cancelled. Requires video-inference-job:read. Use a workspace API key or OAuth access token for the workspace in the path. Device-bound keys are not accepted.

認可
Authorizationstring必須

Roboflow API key or OAuth access token.

パスパラメータ
workspacestring必須

Workspace URL slug.

jobIdstring · 最小: 1 · 最大: 256必須

Job ID.

Pattern: ^[^/\\]+$
レスポンス
200

Successful response.

application/json
get/{workspace}/video-jobs/v1/{jobId}
GET /{workspace}/video-jobs/v1/{jobId} HTTP/1.1
Host: api.roboflow.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*
{
  "job": {
    "id": "JOB_ID",
    "sourceId": "SOURCE_ID",
    "state": "running",
    "purpose": "deployment",
    "mode": "stream",
    "tier": "gpu",
    "processorSize": "gpu-s-v1",
    "workflowUrl": "YOUR_WORKFLOW_SLUG",
    "imageOutput": "label_visualization_output",
    "executionGeneration": 1,
    "cancelRequested": false
  }
}

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

Stop a Workflow job

post

Requests an explicit stop. Persistent intent is disabled; queued jobs can be cancelled immediately. Active processors learn of cancellation through status updates, so the response is not a guarantee that shutdown has already finished. Re-read the job and any replacement identified by successorJobId. Repeating cancellation does not start a new job. Requires video-inference-job:create. Use a workspace API key or OAuth access token for the workspace in the path. Device-bound and folder-scoped credentials are not accepted.

認可
Authorizationstring必須

Roboflow API key or OAuth access token.

パスパラメータ
workspacestring必須

Workspace URL slug.

jobIdstring · 最小: 1 · 最大: 256必須

Job ID.

Pattern: ^[^/\\]+$
レスポンス
200

Successful response.

application/json
post/{workspace}/video-jobs/v1/{jobId}/cancel
POST /{workspace}/video-jobs/v1/{jobId}/cancel HTTP/1.1
Host: api.roboflow.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*
{
  "job": {
    "id": "JOB_ID",
    "sourceId": "SOURCE_ID",
    "state": "running",
    "purpose": "deployment",
    "mode": "stream",
    "tier": "gpu",
    "processorSize": "gpu-s-v1",
    "workflowUrl": "YOUR_WORKFLOW_SLUG",
    "imageOutput": "label_visualization_output",
    "executionGeneration": 1,
    "cancelRequested": false
  }
}

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

最終更新

役に立ちましたか?