音声とビデオの分析情報

このドキュメントでは、Insights ダッシュボードの音声とビデオのセクションと、Azure で Copilot を使用して通話品質を監視および向上させる方法について説明します。

概要

各コミュニケーション リソースには、そのリソースで行われるすべての通話のダッシュボードとして機能する、分析情報の機能が用意されています。 ダッシュボードの [音声とビデオ] セクションには、通話リソースの通話の使用状況、信頼性、品質の概要が表示されます。

このダッシュボードは Azure の Copilot と統合されているため、Copilot とチャットして、見ているデータをすばやく理解し、ユーザーの通話エクスペリエンスを向上させるためのアクションを学習できます。

通話を監視し、通話品質を向上させるために使用できる主なツールが 2 つあります。

1. 音声とビデオの分析情報ダッシュボード
2. 通話の診断

音声とビデオの分析情報ダッシュボードで Copilot を使用して品質調査を開始し、必要に応じて通話診断で Copilot を使用して、詳細な情報が必要な場合は個々の通話を探索することをお勧めします。

音声とビデオの分析情報は、 4 つの主要なセクションで構成されています。

• ボリューム: 一般的な使用番号を提供します。
• 信頼性: キー呼び出し API のシナリオとエラー コードを集計します。
• ユーザー向け診断 (UFD): ユーザー呼び出しエクスペリエンスに影響を与える可能性があるイベントを要約します。
• 品質: 主要なメディア ストリームの測定値を提供します。

音声とビデオの分析情報を有効にする

通話ログの格納を開始し、 Azure で Copilot が Voice ダッシュボードと Video Insights ダッシュボードの使用を開始できるようにする必要があります。

音声とビデオの分析情報にアクセスする

Azure Communication Services リソース内で、左側のナビゲーション バーを下にスクロールして [監視 ] カテゴリに移動します。 [ 分析情報 ] タブを選択し、[ 音声とビデオ] を選択します。

体積

[ボリューム] タブには、通話数や参加者数などの主要な使用状況メトリックが表示され、フィルターを使用することで、特定のレビューや期間を絞り込むことができます。

このタブでは、時間の経過に伴う通話の内訳や量に焦点が当てられます。 ある期間の平均通話時間を確認したり、平均通話時間の長いユーザーに注目したりできます。 SDK のバージョン、Teams の相互運用性、参加者の種類、通話の種類、エンドポイントの種類、OS のバージョンごとの内訳を示し、さらに詳しい情報を提供します。

Azure で Copilot を使用して、このセクションの下部にある主要な概念の詳細な説明を取得できます。

信頼性

[ 信頼性 ] タブには、主要な呼び出し元 SDK API のパフォーマンスがまとめられています。これは、パフォーマンスが最も低い領域に集中するのに役立ちます。 既定のビューには、信頼性の概要を示すすべての API の傾向が表示されます。 重点を置く単一の API シナリオを選択することで、詳細を取得できます。 1 つの API シナリオを選択すると、ダッシュボードのビジュアルが更新され、その API の詳細な内訳が表示されます。

ユーザー向け診断 (UFD)

ユーザー向け診断 (UFD) タブが開き、上位の UFD イベントの概要が表示され、注目する各 UFD の回復率が強調表示されます。 [信頼性] タブと同様に、最初にすべての UFD の概要が表示されます。個々の UFD を選択すると、さらに詳細な分析情報が表示されます。 Azure で Copilot を使用して、呼び出し元アプリケーションで UFD を活用し、ユーザーへの影響を軽減する方法を学習できます。

回復率が低く、ボリュームが多い UFD の改善を優先することをお勧めします。これは、ユーザーの通話エクスペリエンスを向上させる最適な機会を示すことができます。 たとえば、呼び出し元の SDK は、呼び出しイベントの一部から復旧し、ユーザーが問題を認識しない可能性があります。 パフォーマンスが最も低い領域に焦点を当てることで、根本原因の特定に役立ちます。

UFD はどのように解釈しますか?

呼び出し中に、呼び出し元 SDK がユーザー向け診断 (UFD) と呼ばれるイベントをトリガーする可能性があります。これらの UFD イベントは、ユーザーがさまざまな理由で通話エクスペリエンスの低下を認識した可能性があることを示します。 たとえば、ビデオがフリーズし、通話中にネットワーク品質が低下します。 UFD は本質的に症状があり、広範な定量的基準に基づいてトリガーされるため、UFD イベントをトリガーするさまざまな根本原因が考えられます。 さらに、UFD をトリガーすることはできますが、呼び出し元 SDK が潜在的な問題を軽減できたため、呼び出し中にユーザーが問題を認識しない可能性があります。 これに対し、[信頼性] タブでは、分析のためにより具体的なエラー コードとサブコード情報を提供しようとします。

品質

[音声とビデオ] の下にある [品質] タブでは、通話の品質分布を調べることができます。このダッシュボードでは、品質は 3 つのレベルで定義されます。

• 低品質のメディア ストリームの割合 ([ストリーム品質] プロット)。ストリームの品質は、少なくとも 1 つの異常な値がある場合に低品質に分類され、異常の範囲は次のように定義されます。

  • ジッター > 30 ミリ秒
  • パケット損失率 > 10%
  • ラウンド トリップ時間 > 500 ミリ秒

• [影響を受ける通話] の割合。影響を受ける通話は、少なくとも 1 つの低品質なストリームがある通話として定義されます。

• [参加者の終了理由]。参加者が通話を終了した理由を追跡します。 終了の理由については、操作の特定の状態を説明する数値コードである 、呼び出し コードに関するドキュメントに記載されています。 呼び出しコードは、 成功、 クライアントエラー、 サーバー障害、 グローバル障害、 リダイレクト、 暫定の 6 つのカテゴリにグループ化できます。 通話コードの分布は左側の円グラフに表示され、参加者の終了理由に応じて特定のコードの一覧が右側に表示されます。

通話で使用されるメディア ストリームの種類 ([メディアの種類] パラメーター) によって品質をフィルター処理することもできます。たとえば、ビデオ ストリーム品質の観点から影響を受ける通話のみを取得します。

エンドポイントの種類 ([エンドポイントの種類] パラメーター) でフィルター処理することもできます。たとえば、PSTN 参加者の終了理由を取得します。 これらのフィルターでは、複数の選択が可能です。

[パフォーマンス]

[パフォーマンス] タブには、主要な Calling SDK API のデシベル レベルのパフォーマンスの概要が表示され、待機時間が最も長い領域を特定するのに役立ちます。 既定では、ダッシュボードには P95 待機時間の傾向が表示され、時間の経過に伴う待機時間の概要が提供されます。

さらに詳しく調べるには、特定の API シナリオを選択できます。 シナリオを選択すると、ダッシュボードが更新され、その API のパフォーマンスの詳細な内訳が表示され、より詳細な分析とトラブルシューティングが可能になります。

ブックの詳細

Xamarin Workbooks の詳細については、Azure Monitor ブック のドキュメントを参照してください。

ダッシュボードの編集

分析情報ダッシュボードは、上部のナビゲーション バーの [編集] ボタンをクリックし、必要に応じてカスタマイズできます。

これらのダッシュボードを編集することで、リソースの [ブック] タブからアクセスできる別のブックが作成されます。

Xamarin Workbooks の詳細については、Azure Monitor ブック のドキュメントを参照してください。

よく寄せられる質問

音声とビデオの分析情報をどのように設定しますか?

音声とビデオの分析情報ダッシュボードは Azure の Copilot と統合され、 Azure Monitor ブックを利用するため、何かを視覚化するには通話ログを格納する必要があります。 また、 Azure で Copilot を有効にする必要があります。 次のセクションでは、これら 2 つの要件について説明します。

すべてのログを収集する

分析情報ダッシュボードでは、Azure Monitor ブックを使用して、Azure Communication Services の通話ログ データを表示します。 これらの通話ログは、既定では Azure アカウントに保存されないため、ダッシュボードを機能させるには、それらの保存を開始する必要があります。 これらの通話ログを収集するには、通話データを Log Analytics ワークスペースに転送する診断設定を有効にする必要があります。

さかのぼってデータを保存することはありません。診断設定を構成してからでなければ、通話ログのキャプチャは開始されません。

リソースの診断設定を追加する手順については、「Azure Monitor の診断設定でログを有効化する」に従ってください。 最初にすべてのログを収集することをお勧めします。 診断設定を追加すると、ログを選択するように求められます。 すべてのログを収集するには、allLogs を選択します。

Azure Monitor 内の Log Analytics でのデータ ボリューム、保持期間、使用状況は、既存の Azure データ測定を通じて課金されます。 必要に応じて、コストに関する考慮事項について、データ使用状況と保持ポリシーを確認することをお勧めします。 詳細については、「コストの制御」を参照してください。

複数の Azure Communications Services リソース ID がある場合は、リソース ID ごとにこれらの設定を有効にする必要があります。 音声とビデオの分析情報を表示すると、表示している resourceID の詳細が表示されます。

Azure で Copilot を有効にする

組織が Azure の Copilot へのアクセスを管理します。 組織が Azure で Copilot にアクセスすると、Voice と Video Insights のセクションに、操作できる複数の Copilot アイコンが表示されます。

品質改善のガイダンスと一般的な用語の説明については、Azure で Copilot と対話します。 Azure で Copilot に詳細情報を提供すると、修正プログラムを特定するのに役立ちます。 必要に応じて、制限された容量で Copilot なしでビジュアルを使用できます。

Voice と Video Insights のレガシ バージョンを使用できますか?

はい。2025 年 1 月からの従来の Voice および Video Insights バージョンを利用できます。 Azure Communication Services リソースの左のサイドバーで [ワークブック] を選択し、ワークブック ギャラリー ビューで [インサイト（レガシー）] を選択して開きます。

次のステップ

• 通話診断の詳細: 通話診断
• 通話品質を管理する方法の詳細を学ぶ:「通話品質の向上と管理」。
• トラブルシューティングのガイダンスを確認する:「オーディオの問題の概要」。
• その他の品質のベスト プラクティスについて学ぶ:「ベスト プラクティス: Azure Communication Services の通話 SDK」。
• Log Analytics ワークスペースの使用方法を学ぶ:「Log Analytics のチュートリアル」。
• Log Analytics で独自のクエリを作成する:「Azure Monitor でログ クエリを開始する」。
• 既知の通話問題について調べる:「SDK と API の既知の問題」。