> 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/troubleshooting.md).

# トラブルシューティング

Cloud Streaming の接続、処理、再生、sink、クレジット、ブラウザキャプチャの問題を診断します。

ソースとワークフローの実行を分けて確認してください。まずソースの接続状態を確認し、次に問題の実行を選択して、エラーと「アクティビティ」を確認します。既存の実行を調査している間は、重複する有料実行を作成しないでください。

## アクセスが拒否されました

意図したワークスペースにいることを確認してください。EU リージョンでは、RTMP とウェブカメラまたはスマートフォンのセッションはまだ利用できません。

アプリを使用している場合は、管理者に「ストリーム処理の表示」と「ソース動画の管理」の権限を確認してもらってください。API を使用している場合は、URL 内のワークスペース、キーに設定されているワークスペース、および [必要なスコープ](https://docs.roboflow.com/reference/authentication/authentication/scoped-api-keys)を確認してください。OAuth トークンとデバイスキーではジョブを開始できません。フォルダーにスコープが限定されたキーは、そのフォルダー内のソースでのみ機能します。

認証エラーが発生した場合、ループで再試行しないでください。

## コネクタが見つからないか、オフラインです

「 [コネクタをインストールする](https://docs.roboflow.com/deployment/ja/roboflow-cloud/cloud-streaming/install-a-connector.md) 」に従って、インストール済みのバージョン、実行ファイル、設定、および長時間稼働するプロセスを確認してください。マシンがスリープ状態にならず、意図したワークスペースの認証情報が設定され、必要なクラウドサービスに接続できることを確認します。

アップグレード時は、インストール環境の永続状態を維持してください。1つのインストール環境のIDを、同時に稼働する複数のコネクタにコピーしないでください。キーのローテーション後に認証エラーが発生した場合は、コネクタに設定されたキーを更新し、インストール手順に従って再起動してください。

コネクタがオンラインでもカメラがオンラインでない場合は、カメラを個別に確認してください。コネクタがオンラインだからといって、クラウドがカメラのフレームを受信しているとは限りません。

## カメラから利用可能な動画が取得できません

* USB カメラ：OS のカメラ権限、別のプログラムがカメラを使用していないか、選択したキャプチャモードがサポートされているかを確認してください。
* RTSP カメラ：コネクタを実行しているマシンからカメラに接続できること、カメラの認証情報、ストリーム URL、選択した ONVIF プロファイルを確認してください。コネクタがなければ、クラウド処理からプライベート LAN 上のカメラにアクセスできません。
* USB キャプチャ設定：「キャプチャ設定」に「適用済み」と表示され、「設定が拒否されました」と表示されていないことを確認してください。
* ブラウザーでの再生：ソースのコーデックと、サポートされているブラウザーを確認してください。ソースが接続済みでも、エンコードされた動画をブラウザーで再生できるとは限りません。
* RTMP/RTMPS 直接接続：プロトコル、配信先アドレス、現在のストリームキーが正確であることを確認してください。キーをローテーションした後や切断後は、再度配信し、必要に応じてワークフローを再起動してください。詳しくは「 [ソースを接続する](https://docs.roboflow.com/deployment/ja/roboflow-cloud/cloud-streaming/connect-a-source.md#direct-rtmp-and-rtmps).

スクリーンショットやサポートへのメッセージに、カメラのパスワード、非公開の RTSP URL、ストリームキー、ペアリング用 QR コードを含めないでください。

## 動画または処理能力の待機中

「動画を待機中」は、有効なワークフローが利用可能な入力を必要としていることを示します。ソースを復旧し、フレーム統計が更新されるか確認してください。ソースがない場合、有効なワークフローを無効にすることなく、一時停止することがあります。

「処理能力を待機中」は、必要な処理リソースがまだ利用できないことを示します。ジョブを追加で開始すると、キューが増える場合があります。再試行する前に、既存の実行とそのエラーを確認してください。

「起動中」には、モデルの読み込みが含まれることがあります。起動に失敗した場合は、実際のエラーを確認し、モデルまたは設定の問題か、処理能力の問題かを切り分けてください。詳しくは「 [処理状態](https://docs.roboflow.com/deployment/ja/roboflow-cloud/cloud-streaming/manage-and-monitor.md#processing-states).

## ワークフローがブロックされている、または失敗する

修正方法を選ぶ前に、エラーを確認してください。

* ワークフロー、入力、またはモデルへのアクセスが無効：設定または権限を修正してください。通常の再起動の前に、意図した保存済みワークフローを公開してください。
* GPU メモリ：サイズの自動調整が提示された場合は、その完了を待ってください。最大の割り当てでもワークフローを実行できない場合は、より小さいモデルを使用するか、必要なリソースを減らしてください。
* サイズ調整中の処理能力：より大きな割り当てを利用できないというだけで、ワークフローのサイズが大きすぎると判断しないでください。
* クレジット上限：ワークスペースのクレジット状況を解決した後、明示的に開始または再起動してください。クレジットを補充しても、クレジット不足で停止したデプロイが自動的に再開されることはありません。
* 「復旧が一時停止されました」または「要対応」：「アクティビティ」を確認し、報告された原因を修正してから再起動してください。

再起動と復旧によって、トラッカー、カウンター、クールダウン状態がリセットされることがあります。動画の中断を防いだり、見逃したフレームを再生したりするものではありません。詳しくは「 [再起動時の動作](https://docs.roboflow.com/deployment/ja/roboflow-cloud/cloud-streaming/manage-and-monitor.md#restart-processing) と [料金](https://docs.roboflow.com/deployment/ja/roboflow-cloud/cloud-streaming/pricing-and-limits.md).

## 注釈付き出力または最新の結果がありません

古いデプロイや別のプレビューではなく、意図した実行を選択していることを確認してください。処理中であることと、フレームカウンターが進んでいることを確認します。

注釈付き動画を表示するには、画像を生成するワークフロー出力を選択してください。JSON のみを出力するワークフローは、再生可能な画像出力がなくても実行できます。その場合は「最新の結果」を確認してください。 `image_ref` エントリーは画像出力を示しますが、画像のピクセルデータは含みません。

ライブビューアーは、切断中や動作が遅い場合に結果を見逃すことがあります。「最新の結果」と「アクティビティ」から、予測や動画の履歴全体を復元することはできません。保持が必要なデータには、ワークフローのシンクを使用してください。

## API の再生が動作後に停止する

ウォッチの更新を続けてください。 `executionGeneration` が変わった場合は、新しいウォッチ許可をリクエストして再接続してください。

ジョブが停止したのか、入力待ちなのかを確認してください。 `whepUrl`を使用してください。別のビューアーによって、全ユーザーに表示される画像出力が変わることがあります。

こちらを参照してください： [ライブ出力を確認する](https://docs.roboflow.com/deployment/ja/roboflow-cloud/cloud-streaming/consume-results.md#watch-live-output)。プレーヤーが失敗しても、デプロイや課金は停止しません。完了したらジョブをキャンセルしてください。

## Webhookまたは通知シンクから何も送信されない

実行中のWorkflowバージョンでシンクが有効になっていることを確認してください。公開しただけでは、実行中のジョブは更新されません。

フィルタリング条件とクールダウンを確認してください。 `fire_and_forget: false` を使用して制御されたテストを行うと、Webhook Sinkのエラーを確認できます。クラウドプロセッサーが送信先に接続でき、受信側がメソッド、認証情報、ペイロードを受け付けることを確認してください。ノートパソコンからアクセスできるプライベートアドレスでも、クラウドからアクセスできるとは限りません。

設定については、 [Webhook Sink](https://docs.roboflow.com/workflows/blocks/blocks/data-storage/webhook-sink) を参照してください。テストは本番環境の通知や副作用から切り離して行ってください。

## オフライン通知メールが届かない

Workspaceの通知が保存され、有効になっていること、受信者がWorkspaceメンバーであること、コネクタで「オフライン通知」が有効になっていることを確認してください。ストリームがしきい値を超えてオフラインになっており、実行中のデプロイで必要とされている必要があります。

プレビューのみの実行、直接ソース、処理が無効な場合、ブロックされたWorkflowは対象外です。時間単位および日単位の上限により、更新が遅れることがあります。復旧メールは送信されません。テストをリクエストした場合、「配信受付済み」と表示されても、受信トレイへの到着が確認されたわけではありません。 [オフライン通知](https://docs.roboflow.com/deployment/ja/roboflow-cloud/cloud-streaming/manage-and-monitor.md#offline-notifications).

## キャプチャの有効期限が切れた、または録画が保存されなかった

一時的な検査用キャプチャは5分後、またはページを閉じると期限切れになり、再読み込み後も保持されません。古いキャプチャの期限が切れた場合は、新しいキャプチャを依頼してください。保存しても、まったく同じ瞬間を再現することはできません。

録画を保存する場合は、バックグラウンドタスクが完了するまで、元の会話を開いたまま接続を維持してください。開始しただけのタスクは、保存済みアセットではありません。ソースフィードの切断や、ブラウザーのMP4サポート不足がないか確認してください。失敗したキャプチャを再試行すると、その後の時点が録画されます。

対応時間と完了時の動作については、 [ブラウザーキャプチャ](https://docs.roboflow.com/deployment/ja/roboflow-cloud/cloud-streaming/consume-results.md#save-a-snapshot-or-clip) を参照してください。

## 一部のストリームだけが再起動した

再起動ダイアログに表示された対象範囲を維持してください。「再試行」では未完了の再起動のみが再試行され、成功した実行が再度再起動されることはありません。以前の実行がまだ停止処理中の場合は、手動で代替ジョブを作成せず、待ってから再試行してください。

「すべてのストリームを再起動」では、意図的に停止されたストリームとプレビューは対象外です。リソース制限により停止したストリームは、それぞれのページから再起動してください。

## サポートへの問い合わせを準備する

Workspaceのスラッグ、ソースID、ジョブID、該当する場合はコネクタID、および失敗した時刻とタイムゾーンを記載してください。秘密情報を含まないエラーテキスト、関連するアクティビティの記録、OSとブラウザーのバージョン、コネクタのバージョンも添えてください。

期待していた動作、実際に起きたこと、ほかのソースや実行にも影響があるかを説明してください。問題が再起動、キーのローテーション、Workflowの編集、またはネットワークの変更後に発生したかも記載してください。APIキー、再生URL、公開キー、カメラの認証情報、機密性の高い映像は含めないでください。 [サポートへの問い合わせに含める情報](https://docs.roboflow.com/platform/support/getting-help-faster-what-to-include-in-a-support-request).
