インスペクター・リファレンス(パブリックベータ版)
このページでは、Inspector のコントロール、メトリクス、タイムラインイベント、および制限を確認できます。操作手順については、 検査官ガイド.
検索と会議一覧
メイン検索では、 セッションID または 問題ID アプリケーションが Video SDK を通じて問題を報告する.
会議一覧 セッションIDおよびアプリケーションID、エラー数とユーザー数、ステータス、開始時刻と終了時刻、所要時間、メディアモード、録画ステータス、および保存されたセッション情報が表示されます。
| フィルター | 意味 |
|---|---|
| 最小ユーザー数 | 結果に含まれるユーザーの最小数。 |
| アプリケーションID | そのセッションに関連付けられたアプリケーション。 |
| 進行中 | ステータスが「処理中」となっているエントリー。 |
| エラー(3件以上) | エラーが4つ以上あるエントリ。 |
| 最近点検済み(3日以内) | 過去3日以内に「Inspector」で登録が開始されたもの。 |
| メディアモード | ルーティング済み、中継済み、または不明。 |
| 時間範囲 | あらかじめ設定された、またはユーザー指定の時間範囲。 |
列のコントロールを使用して、結果を並べ替えてください。 保存済み この列には保存された名前とタグが表示されますが、これらは検索対象にはなりません。
セッションサイドバー
| コントロール | 効果 |
|---|---|
| タイムゾーン | セッションデータの表示に使用するタイムゾーンを選択します。 |
| セッション範囲 | そのセッション内で利用可能なすべての会議、または個別の会議。 |
| 集計済み | 接続、パブリッシャー、およびサブスクライバーに関する概要グラフ。このビューでは、個々のユーザーの選択はできません。 |
| ユーザーあたり | の詳細 一度に最大4人の指定ユーザー、高品質なグラフやイベントのタイムラインなどが含まれています。 |
概要とユーザーデータ
会議の概要 ID、所要時間、開始時刻、保存されたセッションの詳細、およびセッションで使用された機能が表示されます。 会議の統計 ユーザー、接続、ストリーム、サブスクリプション、および利用総量を一覧表示します。1人のユーザーが複数の接続やストリームを持つことがあります。
総再生時間(分) 公開および購読中のメディア時間が含まれており、その内訳はツールチップに表示されます。「Advanced Insights」アドオンを導入しているAccountでは、さらに以下の情報も確認できます。 参加者の合計分.
ユーザーデータ 各ユーザーのインスペクタラベル、場所、システム、SDK、およびGUIDが一覧表示されます。ユーザーを展開すると、そのユーザーの接続ID、時刻、終了理由、およびパブリッシャーとサブスクライバーのストリームが表示されます。
GUID はクライアントのエンドポイントを識別します。Applications の接続レコードやストリームレコードを利用することで、これを参加者と照合することができます。
品質指標
これらのグラフは、以下の場所で入手可能です。 ユーザーあたり. 各社のオーディオ/ビデオおよびストリーム用フィルターはさまざまです:
| グラフ | その内容 |
|---|---|
| ビットレート | メディアのデータ転送速度はkbps単位で表示されます。オーディオ、ビデオ、およびそれらの合計値は、選択したフィルタによって異なります。 |
| パケットロス | 選択したストリームおよびメディアタイプについて、損失したと報告されたメディアパケットの割合。 |
| MOSスコア | クライアントから報告された音声および映像の測定値に基づく、受信機に対する平均評価スコアの推定値。 |
| レイテンシー | 往復時間(RTT)。単位はミリ秒で表示されます。 |
参照 グラフと指標 グラフの読み方、ストリームの比較、および時間範囲の選択について、サポートが必要な場合。
ビットレート、パケットロス、およびレイテンシには、破線のしきい値ラインが表示される場合があります。マーカーにカーソルを合わせると、値と説明が表示されます。しきい値を下回るビットレートは、ストリームの品質低下を示している可能性があります。また、しきい値を超えるパケットロスやレイテンシは、品質の低下やネットワーク遅延を示している可能性があります。しきい値は、グラフの表示範囲外になる場合があります。
グラフの色はストリームを識別します。MOSグラフには閾値線がなく、スコアを表示するには受信側の測定値が必要です。
イベントの年表
「イベントのタイムライン」には、[ ] で選択されたユーザーの接続、公開、および購読のアクティビティが表示されます。 ユーザーあたり. 各項目は、個別の出来事や活動期間を表しています。
行とツールチップの詳細
選択された各ユーザーの下には、そのユーザーのつながり、公開されたストリーム、およびそれらのストリームを購読しているユーザーがタイムラインとしてまとめられています。各行のツールチップには、そのアクティビティの内容が表示されます:
| 行 | 詳細はツールチップでご確認ください |
|---|---|
| 接続 | 接続ID、接続/切断時刻、および接続時間。クライアントおよびネットワークの詳細には、SDK、ブラウザ/OS、デバイス、セッションモード、トランスポートプロトコル、接続タイプ、ネットワークタイプ、および地域などが含まれます。 |
| 出版社 | ストリームID、メディアソース、公開されたメディア、およびタイミング。1つの行には、各区間ごとのIDを持つ複数のストリームインスタンスが含まれる場合があります。 |
| 購読者 | サブスクリプションおよびストリームID、メディアソース、公開済みメディア、リクエストされたサブスクリプション、タイミング、およびクライアントの詳細。 |
各フィールドの内容は、そのセッションで記録されたデータによって異なります。たとえば、ネットワークの種類や地域などの情報が記載されていない場合があります。
イベントのツールチップには、 ユーザー, 成果, タイプ、ID、および測定値。 即時 各エントリにはタイムスタンプが付いています; 期間 各エントリには、開始時刻、終了時刻、および継続時間が設定されています。ツールチップに複数のイベントや区間がまとめられている場合は、リストを展開して、それぞれの時刻や間隔を確認してください。
用途 ピン ツールチップを開いたままにし、 コピー その内容をコピーするには。
カテゴリー
イベントは5つのカテゴリーに分類されます:
| カテゴリー | 入力例 |
|---|---|
| セッションおよび接続の安定性 | 再接続およびICE再起動の処理。 |
| ネットワークのパフォーマンスに関する問題 | 帯域幅制限による解像度、パブリッシャーのビットレート、および加入者のメディアリンク統計。 |
| システムのパフォーマンス | CPU過負荷イベント、CPU制限による解決、およびメディアデバイスの利用可能性。 |
| メディア品質指標 | 加入者の解像度とフレームレート、音声および映像の品質スコア、ならびにビデオレイヤーの利用可能性。 |
| メディアの品質に関する問題 | オーディオのフォールバックイベント、オーディオのフォールバック遷移、動画のフリーズ、および動画の一時停止。 |
表示するカテゴリを以下で選択してください イベントフィルター. カウントは、現在のビューにおける各カテゴリのエントリ数を示しています。
接続と復旧
再接続 クライアントのセッション接続を復元しようとする試みを追跡します。 ICEの再起動 接続の問題が発生した後、音声や映像用の正常なネットワーク経路を見つけようと試みます。ICEは「Interactive Connectivity Establishment」の略で、参加者がセッションに留まっている間も再起動が可能です。
成功または失敗の記録がない場合、その試行の結果は不明となります。ツールチップ内のグループ化された項目を展開すると、個々の試行とその記録された結果を確認できます。
出版社の条件
これらのエントリは、発行元からの発信メディアについて記述しています。 帯域幅による解像度の制限 そして CPUに制約される解像度 有効な加入者であることを証明する証拠が必要です。
について 出版社の統計 このガイドでは、ビデオレイヤーや画質制限の理由など、クライアント側の測定に関する基本事項について解説しています。
| エントリー | 意味 |
|---|---|
| 帯域幅による解像度の制限 | 出版社によると、帯域幅の制限により動画の解像度が低下しているとのことです。 |
| CPUに制約される解像度 | 出版社によると、CPUの負荷が原因で動画の解像度が制限されているとのことです。 |
| パブリッシャーのビットレート | ビデオレイヤー全体で報告された総ビットレート。その結果には以下が含まれます。 低ビットレート, 非常に低いビットレートそして 動画はありません. |
| オーディオのフォールバック遷移 | 通常の公開との違い、 動画が危険にさらされているそして オーディオのフォールバック 渋滞がひどくなったり、解消されたりする場合。 |
| ビデオレイヤーの利用状況 | アクティブなビデオレイヤーとそのサイズ、ビットレート、コーデック、スケーラビリティモード。ツールチップには、アクティブなレイヤー数が、そのストリームで観測された最大値と比較されて表示されます。 |
| メディアデバイスの利用状況 | 公開を試みた際のオーディオ/ビデオの設定およびデバイスの詳細。結果には以下が含まれます。 音声と映像, 音声のみそして メディアなし. |
受信機の状態
あるパブリッシャーの下では、各サブスクライバーの行は、そのパブリッシャーのストリームを受信しているユーザーを表しています。ツールチップには、受信者、パブリッシャー、およびストリームが表示されます。
加入者に関する決議 受信した画像の幅と高さを返します。 加入者のフレームレート 受信済みおよび優先のFPSが含まれます。次のようなラベルなど 映像がカクカクしている そして 『アナと雪の女王』 測定結果を説明し、その値をApplicationsで指定された設定や、カメラ映像や画面共有などのコンテンツの種類と比較してください。
映像がフリーズする そして 動画の一時停止 受信機から報告された回数と継続時間を表示します。1つの間隔には、複数の短いフリーズや一時停止が含まれる場合があります。そのツールチップには、回数とフリーズまたは一時停止の合計時間が表示されます。
参照 加入者統計 フリーズや一時停止など、受信側の測定値に関する定義については、以下を参照してください。
音質スコア そして 動画品質スコア 時間の経過に伴う受信品質の推定値を表示し、MOSグラフと比較することができます。
オーディオのフォールバックイベント チャンネル登録者向けの動画に関する警告や、有効/無効の状態の切り替えを追跡します。その結果として、以下のことが挙げられます。 動画が危険にさらされている, オーディオのフォールバック、そして回復。
CPU過負荷イベント 報告されたCPUパフォーマンスの状態における変更を追跡し、以下を含みます: フェア, 深刻なそして クリティカル.
加入者メディアリンク統計 報告された内容を示しています ローカルネットワークの状態, リモートネットワークの状態そして ネットワーク性能低下の原因. 成果には以下が含まれる フェア・ネットワーク, ネットワークの状態が悪化しましたそして 重要ネットワーク. 「ローカル」と「リモート」の値は、接続のどちら側で問題が発生したかを特定するのに役立ちます。詳しくは ネットワーク状況 クライアント側のスコアおよび報告された原因については。
間隔、色、および欠落した測定値
一部のエントリは、クライアントのイベントから直接取得されます。その他のエントリは、定期的な品質サンプルから算出されるため、その開始時刻と終了時刻はそれらのサンプルに準じます。たとえば、Inspectorは品質測定値を用いて、 ネットワークのパフォーマンスに関する問題、たとえば低ビットレートや帯域幅の制限などです。イベントログには記録されたイベントが一覧表示されるため、こうした状況は、対応するイベントログのエントリがないままタイムライン上に表示されることがあります。
各エントリの色は、その深刻度を表しています。例えば、 警告, 劣化あるいは クリティカル. そのツールチップには、その接続またはストリームに関する値とタイミングが表示されます。
条件によっては、初期起動期間が除外されたり、有効な加入者が必要となる場合があります。Inspectorは、欠落した測定値をゼロで置き換えるのではなくスキップするため、間隔を計算するのに十分なデータがない場合、欠落が生じることがあります。
エラーログ
エラーログには、エラーコード、名称、説明、時刻、およびユーザー情報を伴うエラーが一覧表示されます。 ユーザーあたり, 選択したユーザーのエラーが表示されます。
イベントログ
イベントログには、ユーザー、時刻、イベントの種類、重大度、ステータス、説明、およびペイロードを含む個々のレコードが一覧表示されます。行を展開すると、そのペイロードを確認できます。
| フィルター | 意味 |
|---|---|
| キーワード | イベント名、説明、ユーザーラベル、ソース、および重大度を検索します。追加されたキーワードはすべて一致する必要があります。ペイロードの内容は対象外となります。 |
| 重大度 | 情報、警告、またはエラー。 |
| ステータス | 成功、失敗、それとも挑戦。 |
| クライアント そして サーバー | イベントレコードの出典。 |
重大度 イベントに割り当てられたレベルです; ステータス その操作の進捗状況または結果です。たとえば、レコードには重大度 情報 およびステータス 試み. 通常のクライアントの切断にも、重大度が付与される場合があります 情報.
ダウンロード イベントレコードをJSON形式でエクスポートします。 フィルタリング済み ログフィルターに一致するレコードをエクスポートします; すべてのデータ そのフィルターで除外されるレコードも含まれます。どちらのオプションも、選択された会議とユーザーを使用します。
その他のセッション機能
| 特徴 | 検査官情報 |
|---|---|
| SIP相互接続 | SIPレコードが存在する場合、SIPユーザーの詳細情報と専用の品質グラフが表示されます。 |
| ライブ・キャプション | パブリッシャーおよびサブスクライバー向けのキャプション機能。利用可能な言語情報を含む。 |
| インタラクティブ放送 | 放送識別子、種類、ステータス、解像度、再生時間、および開始時刻・終了時刻。複数の放送を個別に選択できます。 |
| 記録(アーカイブ) | 記録インジケーターおよび別個の アーカイブ・インスペクター. |
欠損データと制限事項
セッションデータは20日間利用可能です。新しいデータがインスペクターに反映されるまで、通常約5分かかります。 セッションを保存する データをより長く保存する必要がある場合は、有効期限が切れる前に保存してください。
再利用されたセッション ID を検索すると、Inspector には最大 7 日分のデータが表示されます。20 日間の保存期間内にデータが存在していても、その他の会議の日付が検索結果に表示されない場合があります。この制限を回避するには、会議ごとに新しいセッション ID を使用してください。
| 状況 | 確認すべき事項 |
|---|---|
| セッションが見つかりませんでした | IDを確認し、そのアプリケーションへのアクセス権限、およびデータがまだ保持されているかどうかを確認してください。 |
| 質の高いグラフが欠けているのは 集計済み | に切り替える。 ユーザーあたり 個々の品質グラフについては。 |
| 4人以上のユーザーが検査を行う | ユーザーあたり 一度に最大4人のユーザーを比較できます。選択を変更して、他の参加者を確認してください。 |
| ユーザーまたはストリームに関するデータがありません | 会議、選択されたユーザー、およびグラフのフィルターを確認してください。また、クライアント側にレコードが欠落している可能性もあります。 |
| イベントのタイムラインは利用できません 以前に保存されたセッションで | 古いセーブデータには、タイムラインに必要な記録が含まれていない場合があります。「再開」では同じセーブデータが使用されるため、タイムラインは引き続き利用できません。グラフやログは引き続き利用可能です。 |
よくある質問
なぜ、サマリーの集計数が、私が選択したユーザー数と異なるのですか? 集計値はセッション全体を対象としています。また、1人のユーザーが複数の接続やストリームを持つ場合があるため、各指標の合計値は異なる場合があります。
ユーザー1またはGUIDを参加者とどのように紐づければよいですか? Applicationsのログで、接続IDとストリームIDを確認してください。位置情報やデバイスの詳細情報があれば、検索範囲を絞り込むのに役立ちます。
以前に保存したセッションをどのように探せばよいですか? In 会議一覧, 設定 時間範囲 への 通算 その他のフィルターを解除します。の内の名前とタグを使用して、 保存済み 該当する列を確認するか、セッションIDまたは課題IDで検索してください。