次の方法で共有


Azure Communication Services の音声通話およびビデオ通話のログ

Azure Communication Services には、Communication Services ソリューションの監視とデバッグに使用できるログ機能が用意されています。 これらの機能は、Azure portal を使用して構成します。

この記事の内容では、Azure Monitor を使用して有効にするログを指しています (よく寄せられる質問に関するページも参照)。 Communications Services 用にこれらのログを有効にする方法については、診断設定でのログの有効化に関するページを参照してください。

データの概念

次のデータ概念の概要は、音声通話とビデオ通話独自のものです。 ログにキャプチャされたデータの意味を理解できるように、これらの概念を確認することが重要です。

エンティティと ID

次の用語についてよく理解してください。

  • 通話: データで表されているように、通話は correlationId によって表される抽象化です。 correlationId の値は、通話ごとに一意であり、callStartTimecallDuration による時間制限があります。

  • 参加者: このエンティティは、エンドポイントとサーバー間の接続を表します。 参加者 (participantId) は、通話がグループ通話の場合にのみ存在します。

  • エンドポイント: これは endpointId で表される最も一意のエンティティです。 すべての通話は、2 つ以上のエンドポイントからのデータを含むイベントです。 エンドポイントは、通話の参加者を表します。

    EndpointType は、エンドポイントが人間のユーザー (PSTN、VoIP) であるか、ボットであるか、あるいは通話内の複数の参加者を管理しているサーバーであるかを示しています。 endpointType 値が "Server" のとき、エンドポイントには一意の ID が割り当てられません。 endpointTypeendpointId 値の数を分析することで、通話に参加しているユーザーとその他の人間以外の参加者 (ボット、サーバー) の数を把握できます。

    Android、iOS のネイティブ SDK では、複数の通話でユーザーに対して同じ endpointId を再利用するため、セッション間のエクスペリエンスを把握できます。 このプロセスは、新しい通話ごとに常に新しい endpointId が生成される Web ベースのエンドポイントとは異なります。

  • ストリーム: これは最も詳細なエンティティです。 方向 (受信または送信) と mediaType 値 (AudioVideo など) ごとにストリームが 1 つあります。

データの定義

使用状況ログ スキーマ

プロパティ 説明
Timestamp ログが生成された時刻のタイム スタンプ (UTC)。
Operation Name ログ レコードに関連付けられている操作。
Operation Version Operation Name 操作が API を介して実行された場合に、操作に関連付けられた api-version 値。 この操作に対応する API がない場合、操作に関連付けられているプロパティが将来変更された場合に備えて、バージョンは操作のバージョンを表します。
Category イベントのログ カテゴリ。 カテゴリは、リソースのログを有効または無効にできる細分性です。 イベントの properties BLOB 内に表示されるプロパティは、ログ カテゴリとリソースの種類内で同じです。
Correlation ID 相関性があるイベントの ID。 これを使用して、複数のテーブル間の相関イベントを識別できます。
Properties Communication Services のさまざまなモードに適用されるその他のデータ。
Record ID 使用状況レコードの一意の ID。
Usage Type 使用モード (例えば、チャット、PSTN、NAT など)。
Unit Type 使用モードに基づく単位の種類 (例えば、分、メガバイト、メッセージなど)。
Quantity そのレコードに関して使用または消費された単位の数。

通話概要ログ スキーマ

通話概要ログには、すべての通話の主要なプロパティを識別するのに役立つデータが含まれます。 通話の participantId (ピアツーピア [P2P] 通話の場合は endpointId) ごとに、異なる通話概要ログが作成されます。

重要

通話概要ログの参加者情報は、参加者テナントによって異なります。 参加者が Communication Services リソースと同じテナントに存在しない場合 (クロステナントとも呼ばれます)、SDK と OS のバージョンが編集されます。 クロステナントの参加者は、通話時に参加して共同作業するためにリソース テナントから招待された外部ユーザーに分類されます。

プロパティ 説明
time ログが生成された時刻のタイム スタンプ (UTC)。
operationName ログ レコードに関連付けられている操作。
operationVersion operationName 操作が API を介して実行された場合に、操作に関連付けられた api-version 値。 この操作に対応する API がない場合、操作に関連付けられているプロパティが将来変更された場合に備えて、バージョンは操作のバージョンを表します。
category イベントのログ カテゴリ。 このプロパティは、リソースのログを有効または無効にできる細分性です。 イベントの properties BLOB 内に表示されるプロパティは、ログ カテゴリとリソースの種類内で同じです。
correlationId 通話の一意の ID。 これは、1 回の通話中に接続するすべての参加者とエンドポイントからの相関イベントを識別し、さまざまなログのデータを結合するために使用できます。 Microsoft に対しサポート ケースを開く場合、トラブルシューティングの対象となる通話を簡単に識別できるよう、correlationId 値を使用します。
identifier ユーザーの一意の ID。 この ID には、Azure Communication Services ユーザー、Microsoft Entra ユーザー ID、Teams 匿名ユーザー ID、Teams ボット ID が可能です。 この ID を使用すると、ログにわたってユーザー イベントを関連付けることができます。
callStartTime いずれかのエンドポイントからの最初の接続試行に基づく、通話開始のタイムスタンプ。
callDuration 秒で表現される通話時間。 これは、2 つのエンドポイント間での最初の接続試行と最後の接続の終了に基づいています。
callType 要求の種類。 "P2P" または "Group" のいずれかが含まれます。 "P2P" 通話は、サーバー以外の 2 つのエンドポイント間の 1 対 1 の直接接続です。 "Group" 通話は、2 つを超えるエンドポイントがある通話、または接続前に "Group" 通話として作成された通話です。
teamsThreadId Teams スレッド ID。 この ID は、通話が Teams 会議として開催されている場合にのみ関係します。 Microsoft Teams と Azure Communication Services 間の相互運用性のユース ケースを表します。

この ID は、操作ログで公開されます。 この ID は、Chat API を通じて取得することもできます。
participantId この ID は、"Participant" エンドポイント (endpointType = "Server") とサーバー間の双方向接続を表すために生成されます。 callType = "P2P" の場合、2 つのエンドポイントの間に直接接続があり、participantId 値は生成されません。
participantStartTime 参加者による最初の接続試行の開始を示すタイムスタンプ。
participantDuration participantStartTime から、接続が終了したときのタイムスタンプまでの、秒での各参加者の接続時間。
participantEndReason 参加者の接続が終了した理由。 (適切な場合) 各 participantId に対し、SDK が出力する Calling SDK エラー コードが含まれます。
endpointId 通話に接続されている各エンドポイントを表す一意の ID。エンドポイントの種類は endpointType によって定義されます。 この値が null の場合、接続されているエンティティは Communication Services サーバー (endpointType = "Server") になります。

endpointId 値は、ネイティブ クライアントの場合は、複数の通話 (correlationId) にわたって同じユーザーに対して保持される場合があります。 endpointId 値の数によって、通話概要ログの数が決まります。 各 endpointId 値に、概要ログが個別に作成されます。
endpointType この値は、通話に接続されている各エンドポイントのプロパティを表します。 "Server""VOIP""PSTN""BOT"、または "Unknown" を含むことができます。
sdkVersion 関連する各エンドポイントで使用される Communication Services Calling SDK バージョンを示すバージョン文字列 (たとえば、"1.1.00.20212500")。
osVersion 各エンドポイント デバイスのオペレーティング システムとバージョンを表す文字列。
participantTenantId 参加者の ID に関連付けられた Microsoft テナントの ID。 テナントは、Azure Communication Services リソースを所有する Azure テナント、または M365 ID の Microsoft テナントとすることができます。 このフィールドは、クロステナントの編集をガイドするために使用されます。
participantType クライアント (Azure Communication Services または Teams)、およびその ID (Azure Communication Services または Microsoft 365) の組み合わせとしての参加者の説明。 使用可能な値は、Azure Communication Services (Azure Communication Services ID と Azure Communication Services SDK)、Teams (Teams ID と Teams クライアント)、Teams 外部ユーザーとしての Azure Communication Services (Teams 通話または Teams 会議での Azure Communication Services ID と Azure Communication Services SDK)、Microsoft 365 ユーザーとしての Azure Communication Services (M365 ID と Azure Communication Services クライアント)、およびTeams Voice Apps です。
pstnPartcipantCallType 緊急通話、ダイレクト ルーティング、転送、着信転送など、PSTN 参加者の種類と方向を表します。
ParticipantEndSubCode (該当する場合) 各 participantId 値に対し、SDK が出力する Calling SDK エラー サブコードを表します。
ResultCategory 通話を終了する参加者のカテゴリを表します。 Success、ExpectedError、UnexpectedClientError、UnexpectedServerError の 4 つの値のいずれかを指定できます。

通話診断ログのスキーマ

通話診断ログは、各参加者のエンドポイントとメディア転送に関する重要な情報に提供します。 品質の問題を把握するのに役立つ測定値も提供します。

通話内のエンドポイントごとに、エンドポイント間の送信メディア ストリーム (オーディオ、ビデオなど) に通話診断ログが個別に作成されます。 P2P 通話の各ログには、各エンドポイントに関連する各送信ストリームに関するデータが含まれます。 グループ通話で、participantId は、関連する送信ログを個別の参加者接続に結合するためのキー識別子として機能します。 通話診断ログはそのまま残り、参加者テナントに関係なく同じです。

Note

この記事で、P2P およびグループ通話は、クロステナントのすべての通話シナリオで、既定では同じテナント内にあります。 これらは、記事全体で適宜指定しています。

プロパティ 説明
operationName ログ レコードに関連付けられている操作。
operationVersion operationName 操作が API を介して実行された場合に、操作に関連付けられた api-version 値。 この操作に対応する API がない場合、操作に関連付けられているプロパティが将来変更された場合に備えて、バージョンは操作のバージョンを表します。
category イベントのログ カテゴリ。 このプロパティは、リソースのログを有効または無効にできる細分性です。 イベントの properties BLOB 内に表示されるプロパティは、ログ カテゴリとリソースの種類内で同じです。
correlationId 通話の一意の ID。 これは、1 回の通話中に接続するすべての参加者とエンドポイントからの相関イベントを識別します。 Microsoft に対しサポート ケースを開く場合、トラブルシューティングの対象となる通話を簡単に識別できるよう、correlationId 値を使用します。
participantId この ID は、"Participant" エンドポイント (endpointType = "Server") とサーバー間の双方向接続を表すために生成されます。 callType = "P2P" の場合、2 つのエンドポイントの間に直接接続があり、participantId 値は生成されません。
identifier ユーザーの一意の ID。 この ID には、Azure Communication Services ユーザー、Microsoft Entra ユーザー ID、Teams オブジェクト ID、Teams ボット ID が可能です。 この ID を使用すると、ログにわたってユーザー イベントを関連付けることができます。
endpointId 通話に接続されている各エンドポイントを表す一意の ID。エンドポイントの種類は endpointType によって定義されます。 この値が null の場合、接続されているエンティティは Communication Services サーバーになります。 ネイティブ クライアントの場合、EndpointId は、複数の通話 (correlationId) にわたって同じユーザーで保持される場合がありますが、クライアントが Web ブラウザーである場合は、通話ごとに一意になります。
endpointType この値は、各 endpointId インスタンスのプロパティを表します。 "Server""VOIP""PSTN""BOT""Voicemail""Anonymous"、または "Unknown" を含むことができます。
mediaType この文字列値は、各ストリーム内のエンドポイント間で送信されるメディアの種類を示します。 使用できる値には "Audio""Video""VBSS" (ビデオベースのスクリーン共有)、および "AppSharing" があります。
streamId mediaType と共に、同じ participantId 値のストリームを一意に識別するために使用できる一意でない整数。
transportType それぞれの participantId 値のネットワーク トランスポート プロトコルを示す文字列値。 "UDP""TCP"、または "Unrecognized" を含むことができます。 "Unrecognized" は、トランスポートの種類が TCP と UDP のどちらであるかをシステムが判断できなかったことを示します。
roundTripTimeAvg これは、participantDuration の期間内に、あるエンドポイントから別のエンドポイントに IP パケットが届くまでにかかる平均時間です。 このネットワーク伝達の遅延は、2 つのポイント間の物理的距離、光速、およびさまざまなルーターでその間に発生するオーバーヘッドが関係しています。

待ち時間は、一方向時間またはラウンドトリップ時間 (RTT) として測定されます。 その値はミリ秒で表されます。 500 ミリ秒を超える RTT は、通話品質に悪影響をおよぼします。
roundTripTimeMax グループ通話の participantDuration 期間中、または P2P 通話の callDuration 期間中にメディア ストリームに到達するために測定された最大 RTT (ミリ秒)。
jitterAvg 連続するパケット間の遅延の変化の平均値。 Azure Communication Services では、バッファーリングによって一定レベルのジッターに対応できます。 ジッターがバッファーリングを超過する場合 (jitterAvg 時間がだいたい 30 ミリ秒を超える場合)、品質に対し悪影響が発生する可能性があります。 パケットが異なる速度で到着することで、スピーカーの音声がロボットのように聞こえます。

このメトリックは、グループ通話の participantDuration 期間、または P2P 通話の callDuration 期間の各メディア ストリームで測定されます。
jitterMax メディア ストリームごとにパケット間で測定される最大ジッター値です。 ネットワーク状態でバーストが発生すると、オーディオまたはビデオのトラフィック フローで問題が発生する場合があります。
packetLossRateAvg 失われたパケットの平均割合です。 パケットの損失はオーディオ品質に直接影響します。 小さい、個々の失われたパケットはほとんど影響しないのに対し、バックツーバック バーストでの損失ではオーディオが完全に止まります。 ドロップされ、目的の宛先に到着しないパケットにより、メディアで欠落が発生します。 この状況により、音節や単語が欠損し、ビデオや共有が途切れる結果になります。

パケット損失率が10% (0.1) を超えると、品質に悪影響がある可能性が高くなります。 このメトリックは、グループ通話の participantDuration 期間、または P2P 通話の callDuration 期間の各メディア ストリームで測定されます。
packetLossRateMax この値は、グループ通話の participantDuration 期間または P2P 通話の callDuration 期間のメディア ストリームあたりの最大パケット損失率 (%) を表します。 ネットワーク状態でバーストが発生すると、オーディオまたはビデオのトラフィック フローで問題が発生する場合があります。
JitterBufferSizeAvg 各メディア ストリームの期間中のジッター バッファーの平均サイズ。 ジッター バッファーとは、音声パケットを等間隔で音声プロセッサに収集、格納、送信できる共有データ領域です。 ジッター バッファーは、ジッターの影響に対抗するために使用されます。

ジッター バッファーは、静的または動的のいずれかです。 静的ジッター バッファーは固定サイズに設定されますが、動的ジッター バッファーはネットワークの状態に応じてサイズを調整できます。 ジッター バッファーの目的は、音声データとビデオ データの滑らかで途切れないストリームをユーザーに提供することです。

Web SDK では、この "JitterBufferSizeAvg" は通話中の "jitterBufferDelay" の平均値です。"jitterBufferDelay" は、オーディオ サンプルまたはビデオ フレームがジッター バッファーに留まる期間です。

通常、'JitterBufferSizeAvg' の値が 200 ミリ秒を超えると、品質への悪影響が生じます。
JitterBufferSizeMax 各メディア ストリームの期間中に測定された最大ジッター バッファー サイズ。

通常、この値が 200 ミリ秒を超えると、品質への悪影響が生じます。
HealedDataRatioAvg オーディオ ストリームの期間中にヒーラーによって正常に再構築または修復された、失われたデータ パケットまたは破損したデータ パケットの平均割合。 修復データ比率は、VoIP システムで使用されるエラー修正手法の有効性の尺度です。

この値が 0.1 (10%) より大きい場合、ストリームは低品質と見なされます。
HealedDataRatioMax 各メディア ストリームの期間中に測定された最大修復データ比率。

この値が 0.1 (10%) より大きい場合、ストリームは低品質と見なされます。
VideoFrameRateAvg ビデオ通話中/画面共有通話中に 1 秒あたりに送信されるビデオ フレームの平均数。 ビデオ フレーム レートは、ビデオ ストリームの品質と滑らかさに影響を与える可能性があり、一般的にフレーム レートが高いほどスムーズで滑らかな動きになります。 WebRTC ビデオの標準フレーム レートは通常、1 秒あたり 30 フレーム (fps) ですが、これは特定の実装とネットワークの状態によって異なる場合があります。

この値がビデオ ストリームで 7 未満、画面共有ストリームで 1 未満の場合、ストリーム品質は低いと見なされます。
RecvResolutionHeight ビデオ通話中/画面共有通話中に送信される受信ビデオ ストリームの垂直サイズの平均値。 ピクセル単位で測定され、ビデオ ストリームの全体的な解像度と品質を決定する要因の 1 つです。 使用される特定の解像度は、通話に関係するデバイスの機能とネットワークの状態によって異なります。

この値がビデオ ストリームで 240 未満、画面共有ストリームで 768 未満の場合、ストリーム品質は低いと見なされます。
RecvFreezeDurationPerMinuteInMs 受信ビデオ ストリーム/画面共有ストリームの 1 分あたりの平均フリーズ時間 (ミリ秒)。 フリーズは通常、ネットワークの状態が悪いことが原因で発生し、ストリームの品質を低下させる可能性があります。

この値がビデオ ストリームで 6,000 ミリ秒を超える場合、または画面共有ストリームで 25,000 ミリ秒を超える場合、ストリーム品質は低いと見なされます。
PacketUtilization 特定のメディア ストリームに対して送受信されるパケット。

通常、通話が長いほど、値は大きくなります。 この値が 0 の場合は、メディアが流れていないことを示す可能性があります。
VideoBitRateAvg ビデオまたは画面共有ストリームの平均ビットレート (1 秒あたりのビット数)。

低いビットレート値は、ネットワーク接続に問題あることを示す場合があります。 必要な最小ビットレート (帯域幅) については、「ネットワーク帯域幅」を参照してください。
VideoBitRateMax ビデオまたは画面共有ストリームの最大ビットレート (1 秒あたりのビット数)。

低いビットレート値は、ネットワーク接続に問題あることを示す場合があります。 必要な最小ビットレート (帯域幅) については、「ネットワーク帯域幅」を参照してください。
StreamDirection メディア ストリームの方向。 受信または送信のいずれかです。
CodecName メディア ストリームの処理に使用されるコーデックの名前。 OPUS、G722、H264S、SATIN などです。

通話クライアント操作ログのスキーマ

通話クライアント操作ログは、通話に関係する呼び出しエンドポイントと参加者に関するクライアント側の情報を提供します。 これらのログは現在プレビュー段階であり、通話で発生したクライアント イベントと、通話中に顧客が実行した可能性のあるアクションを示します。

このログは、通話中に実行されたアクションに関する詳細情報を提供し、Azure Communication Services リソースの通話診断を使用して通話の問題を視覚化および調査するために使用できます。 通話診断の詳細

プロパティ 説明
CallClientTimeStamp SDK で操作が行われた時刻のタイムスタンプ (UTC)。
OperationName Calling SDK でトリガーされた操作の名前。
CallId 通話の一意の ID。 これは、1 回の通話中に接続するすべての参加者とエンドポイントからの相関イベントを識別し、さまざまなログのデータを結合するために使用できます。 これは、通話概要ログと通話診断ログの correlationId に似ています。
ParticipantId 各通話レッグ (グループ通話) または通話参加者 (ピア ツー ピア通話) の一意識別子。 この ID は、CallSummary ログ、CallDiagnostic ログ、CallClientOperations ログ、CallClientMediaStats ログ間の主な関連付けポイントです。
OperationType 通話クライアント操作。
OperationId SDK 操作を識別する一意の GGUID。
DurationMs Calling SDK 操作が失敗または成功するまでにかかった時間。
ResultType 操作の成功または失敗を記述するフィールド。
ResultSignature HTTP のような失敗コードや成功コード (200、500)。
SdkVersion 使用されている Calling SDK のバージョン。
UserAgent ブラウザーまたはプラットフォームの Calling SDK に基づく標準ユーザー エージェント文字列が使用されます。
ClientInstanceId CallClient オブジェクトを識別する一意の GGUID。
EndpointId 通話に接続されている各エンドポイントを表す一意の ID。endpointType によってエンドポイントの種類が定義されます。 値が null の場合、接続されたエンティティは Communication Services サーバーです (endpointType = "Server")。

ネイティブ クライアントの場合、endpointId 値は同じユーザーに対して複数の通話 (correlationId) にわたって保持される場合があります。 endpointId 値の数によって通話概要ログの数が決まります。 endpointId 値ごとに個別の概要ログが作成されます。
OperationPayload 操作に応じて変化する動的ペイロードであり、より具体的な操作固有の詳細情報を提供します。

通話クライアント メディア統計時系列ログのスキーマ

通話クライアント メディア統計時系列ログは、通話に関係する個々の参加者間のメディア ストリームに関するクライアント側の情報を提供します。 これらのログは現在、限定プレビュー段階であり、既定の 10 秒の集計間隔で参加者間のオーディオ、ビデオ、スクリーン共有メディアのストリームに関する詳細な時系列データを提供します。 ログには、メディア ストリームの種類、方向、コーデック、ビットレートのプロパティ (max、min、average など) に関する詳細な時系列情報が含まれています。

このログは、参加者間のメディア ストリームの品質を理解するために、通話診断ログよりも詳細な情報を提供します。 Azure Communication Services リソースの通話診断を使用して、通話の品質の問題を視覚化および調査するために使用できます。 通話診断の詳細

プロパティ 説明
OperationName ログ レコードに関連付けられている操作。
CallId 通話の一意の ID。 これは、1 回の通話中に接続するすべての参加者とエンドポイントからの相関イベントを識別し、さまざまなログのデータを結合するために使用できます。 これは、通話概要ログと通話診断ログの correlationId に似ています。
CallClientTimeStamp メディア統計が記録されたときのタイムスタンプ。
MetricName Bitrate、JitterInMs、PacketsPerSecond などのメディア統計情報の名前。
Count 特定のタイムスタンプでサンプリングされたデータ ポイントの数。
Sum サンプリングされたすべてのデータ ポイントのメトリック値の合計。
Average サンプリングされたデータ ポイントの平均メトリック値。 Average = Sum /Count
Minimum サンプリングされたすべてのデータ ポイントのメトリック値の最小値。
Maximum サンプリングされたすべてのデータ ポイントのメトリック値の最大値。
MediaStreamDirection メディア ストリームの方向。 送信または受信になります
MediaStreamType メディア ストリームの種類。 ビデオ、オーディオ、または画面になります。
MediaStreamCodec H264、OPUS、VP8 など、メディア ストリームのエンコードとデコードに使用されるコーデック。
ParticipantId 通話の各エンドポイントを表すために生成される一意の ID。
ClientInstanceId Calling SDK で作成された通話クライアント オブジェクトを表す一意の ID。
EndpointId 通話に接続されている各エンドポイントを表す一意の ID。 ネイティブ クライアントの場合、エンドポイントは、複数の通話 (callId) にわたって同じユーザーで保持される場合がありますが、クライアントが Web ブラウザーである場合は、通話ごとに一意になります。 EndpointId は現在、このログにインストルメント化されていないことに注意してください。 将来実装されると、CallSummary/Diagnostics ログの値と一致します
RemoteParticipantId メディア ストリーム内のリモート エンドポイントを表す一意の ID。 たとえば、ユーザーは、同じ通話で他のユーザーに対して複数のビデオ ストリームをレンダリングできます。 RemoteParticipantId はビデオ ストリームごとに異なります。
RemoteEndpointId EndpointId と同じですが、ストリームのリモート側のユーザーを表します。
MediaStreamId 通話の各メディア ストリームを表す一意の ID。 MediaStreamId は現在、クライアントでインストルメント化されていません。 実装されると、CallDiagnostics ログの streamId 列と一致するようになります。
AggregationIntervalSeconds メディア統計情報を集計する時間間隔。 現在、Calling SDK でメディア メトリックは 1 秒ごとにサンプリングされ、ログで報告されるときは、すべてのサンプルが 10 秒ごとに集計されます。 そのため、このテーブルの各行のサンプリング ポイントは最大 10 個です。

P2P とグループ通話

通話には 2 種類あり、callType で表されます。

  • ピア ツー ピア (P2P) 通話: サーバー エンドポイントのない 2 つのエンドポイントのみの間の接続。 P2P 通話は、それらのエンドポイント間の通話として開始され、接続前にグループ通話イベントとして作成されることはありません。

    2 つのエンドポイント間の P2P 通話を示す図。

  • グループ通話: 2 つ以上のエンドポイントが接続されているすべての通話。 グループ通話にはサーバー エンドポイントと、各エンドポイントとサーバー間の接続が含まれます。 通話中にさらにエンドポイントが追加される P2P 通話は、P2P ではなくなり、グループ通話になります。 participantStartTimeparticipantDuration のメトリックを使用して、各エンドポイントが通話に参加した時間のタイムラインを判断できます。

    複数のエンドポイント間のグループ通話を示す図。

ログ構造

Azure Communication Services では、次の 4 種類のログが作成されます。

  • 通話概要ログ: 関連するすべての ID、タイムスタンプ、エンドポイント、SDK 情報など、通話に関する基本情報が含まれます。 Communication Services は、通話内の参加者ごとに通話概要ログを個別に作成します。

    誰かが通話に再び参加した場合、その参加者の EndpointId 値は同じになりますが、ParticipantId 値は別のものになります。 その場合、そのエンドポイントには、通話概要ログが 2 つあります。

  • 通話診断ログ: ストリームに関する情報と、エクスペリエンス品質の測定値を示す一連のメトリックが含まれます。 通話内の各 EndpointId (サーバーを含む) に対して、Azure Communication Services は、エンドポイント間の各メディア ストリーム (オーディオ、ビデオなど) に個別の通話診断ログを作成します。

  • 通話クライアント操作ログ: 詳細な通話クライアント イベントが含まれます。 これらのログ イベントは通話内の EndpointId ごとに生成され、生成されるイベント ログの数は、通話中に参加者が実行した操作によって異なります。

  • 通話クライアント メディア統計ログ: 詳細なメディア ストリーム値が含まれています。 これらのログは、通話のメディア ストリームごとに生成されます。 通話内の各 EndpointId (サーバーを含む) に対して、Azure Communication Services は、エンドポイント間の各メディア ストリーム (オーディオ、ビデオなど) に個別のログを作成します。 各ログで生成されるデータの量は、通話時間と通話のメディア ストリームの数によって異なります。

P2P 通話の各ログには、各エンドポイントに関連する各送信ストリームに関するデータが含まれます。 グループ通話では、endpointType = "Server" に関連付けられている各ストリームによって、受信ストリームのデータを含むログが作成されます。 他のすべてのストリームは、サーバー以外のすべてのエンドポイントに対し送信ストリームのデータを含むログを作成します。 グループ通話で、キーとして participantId を使用して、関連する受信/送信ログを個別の参加者接続に結合します。

例: P2P 通話

下の図は、P2P 通話で直接接続されている 2 つのエンドポイントを表しています。 この例で、Communication Services は、2 つの通話概要ログ (participantID 値ごとにそれぞれ 1 つ) と 4 つの通話診断ログ (メディア ストリームごとにそれぞれ 1 つ) を作成します。

Azure Communication Services (ACS) 通話クライアント参加者の場合、一連の通話クライアント操作ログと通話クライアント メディア統計時系列ログも存在します。 これらのログの正確な数は、呼び出される SDK 操作の種類と通話の長さによって異なります。

同じテナント内の P2P 通話を示す図。

例: グループ通話

次の図は、3 つの participantId 値 (つまり、3 人の参加者) とサーバー エンドポイントがあるグループ通話の例を表しています。 複数の endpointId 値が複数の参加者に表示される可能性があります。たとえば、同じデバイスから参加者が通話に再び参加する場合などです。 Communication Services は、participantId 値ごとに通話概要ログを 1 つ作成します。 通話診断ログも 4 つ作成します (それぞれの participantId に対し、メディア ストリームごとに 1 つ)。

Azure Communication Services (ACS) 通話クライアント参加者の場合、通話クライアント操作ログは P2P 通話と同じです。 Calling SDK を使用する参加者ごとに、一連の通話クライアント操作ログが存在します。

Azure Communication Services (ACS) 通話クライアント参加者の場合、通話クライアント操作ログと通話クライアント メディア統計時系列ログは P2P 通話と同じです。 Calling SDK を使用する参加者ごとに、一連の通話クライアント操作ログと、通話クライアント メディア統計時系列ログが存在します。

同じテナント内のグループ通話を示す図。

例: クロステナントの P2P 通話

次の図は、P2P 通話で直接接続されている複数のテナント間の 2 人の参加者を表しています。 この例では、Communication Services は、OS と SDK のバージョンが編集された通話概要ログ (参加者ごとに 1 つ) を 1 つ作成しています。 Communication Services は、通話診断ログも 4 つ作成しています (メディア ストリームごとに 1 つ)。 各ログには、participantID の送信ストリームと関連するデータが含まれます。

テナント間の P2P 通話を示す図。

例: クロステナントのグループ通話

次の図は、複数のテナントにわたり 3 つ participantId 値があるグループ通話の例を表しています。 Communication Services は、参加者ごとに OS と SDK のバージョンが編集された 1 つの通話概要ログを作成します。 Communication Services は、各 participantId 値と関連する 4 つの通話診断ログも作成します (メディア ストリームごとに 1 つ)。

テナント間グループ通話を示す図。

Note

このリリースでは、送信診断ログのみがサポートされます。 Communication Services は、参加者とボットの ID を同じように扱うため、ボットと参加者に関連付けられている OS と SDK のバージョンは編集することができます。

サンプル データ

P2P 通話

P2P 通話のすべてのログで、次のフィールドが共有されます。

"time":                     "2021-07-19T18:46:50.188Z",
"resourceId":               "SUBSCRIPTIONS/XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX/RESOURCEGROUPS/ACS-TEST-RG/PROVIDERS/MICROSOFT.COMMUNICATION/COMMUNICATIONSERVICES/ACS-PROD-CCTS-TESTS",
"correlationId":            "8d1a8374-344d-4502-b54b-ba2d6daaf0ae",

通話概要ログ

通話概要ログでは、操作とカテゴリ情報が共有されます。

"operationName":            "CallSummary",
"operationVersion":         "1.0",
"category":                 "CallSummary",

VoIP ユーザー 1 の通話概要を次に示します。

"properties": {
    "identifier":               "acs:61fddbe3-0003-4066-97bc-6aaf143bbb84_0000000b-4fee-66cf-ac00-343a0d003158",
    "callStartTime":            "2021-07-19T17:54:05.113Z",
    "callDuration":             6,
    "callType":                 "P2P",
    "teamsThreadId":            "null",
    "participantId":            "null",    
    "participantStartTime":     "2021-07-19T17:54:06.758Z",
    "participantDuration":      "5",
    "participantEndReason":     "0",
    "endpointId":               "570ea078-74e9-4430-9c67-464ba1fa5859",
    "endpointType":             "VoIP",
    "sdkVersion":               "1.0.1.0",
    "osVersion":                "Windows 10.0.17763 Arch: x64"
}

VoIP ユーザー 2 の通話概要を次に示します。

"properties": {
    "identifier":               "acs:7af14122-9ac7-4b81-80a8-4bf3582b42d0_06f9276d-8efe-4bdd-8c22-ebc5434903f0",
    "callStartTime":            "2021-07-19T17:54:05.335Z",
    "callDuration":             6,
    "callType":                 "P2P",
    "teamsThreadId":            "null",
    "participantId":            "null",
    "participantStartTime":     "2021-07-19T17:54:06.335Z",
    "participantDuration":      "5",
    "participantEndReason":     "0",
    "endpointId":               "a5bd82f9-ac38-4f4a-a0fa-bb3467cdcc64",
    "endpointType":             "VoIP",
    "sdkVersion":               "1.1.0.0",
    "osVersion":                "null"
}

VoIP ユーザー 1 のクロステナント通話の概要ログを次に示します。

"properties": {
    "identifier":               "1e4c59e1-r1rr-49bc-893d-990dsds8f9f5",
    "callStartTime":            "2022-08-14T06:18:27.010Z",
    "callDuration":             520,
    "callType":                 "P2P",
    "teamsThreadId":            "null",
    "participantId":            "null",
    "participantTenantId":      "02cbdb3c-155a-4b95-b829-6d56a45787ca",
    "participantStartTime":     "2022-08-14T06:18:27.010Z",
    "participantDuration":      "520",
    "participantEndReason":     "0",
    "endpointId":               "02cbdb3c-155a-4d98-b829-aaaaa61d44ea",
    "endpointType":             "VoIP",
    "sdkVersion":               "Redacted",
    "osVersion":                "Redacted"
}

PSTN 通話の通話概要を次に示します。

Note

P2P またはグループ通話ログでは、参加者のテナントかボットのテナントかに関係なく、OS と SDK のバージョンが編集されます。

"properties": {
    "identifier": "b1999c3e-bbbb-4650-9b23-9999bdabab47",
    "callStartTime": "2022-08-07T13:53:12Z",
    "callDuration": 1470,
    "callType": "Group",
    "teamsThreadId": "19:36ec5177126fff000aaa521670c804a3@thread.v2",
    "participantId": " b25cf111-73df-4e0a-a888-640000abe34d",
    "participantStartTime": "2022-08-07T13:56:45Z",
    "participantDuration": 960,
    "participantEndReason": "0",
    "endpointId": "8731d003-6c1e-4808-8159-effff000aaa2",
    "endpointType": "PSTN",
    "sdkVersion": "Redacted",
    "osVersion": "Redacted"
}

通話診断ログ

通話診断ログでは、操作情報が共有されます。

"operationName":            "CallDiagnostics",
"operationVersion":         "1.0",
"category":                 "CallDiagnostics",

VoIP エンドポイント 1 から VoIP エンドポイント 2 へのオーディオ ストリームの診断ログを次に示します。

"properties": {
    "identifier":           "acs:61fddbe3-0003-4066-97bc-6aaf143bbb84_0000000b-4fee-66cf-ac00-343a0d003158",
    "participantId":        "null",
    "endpointId":           "570ea078-74e9-4430-9c67-464ba1fa5859",
    "endpointType":         "VoIP",
    "mediaType":            "Audio",
    "streamId":             "1000",
    "transportType":        "UDP",
    "roundTripTimeAvg":     "82",
    "roundTripTimeMax":     "88",
    "jitterAvg":            "1",
    "jitterMax":            "1",
    "packetLossRateAvg":    "0",
    "packetLossRateMax":    "0"
}

VoIP エンドポイント 2 から VoIP エンドポイント 1 へのオーディオ ストリームの診断ログを次に示します。

"properties": {
    "identifier":           "acs:7af14122-9ac7-4b81-80a8-4bf3582b42d0_06f9276d-8efe-4bdd-8c22-ebc5434903f0",
    "participantId":        "null",
    "endpointId":           "a5bd82f9-ac38-4f4a-a0fa-bb3467cdcc64",
    "endpointType":         "VoIP",
    "mediaType":            "Audio",
    "streamId":             "1363841599",
    "transportType":        "UDP",
    "roundTripTimeAvg":     "78",
    "roundTripTimeMax":     "84",
    "jitterAvg":            "1",
    "jitterMax":            "1",
    "packetLossRateAvg":    "0",
    "packetLossRateMax":    "0"
}

VoIP エンドポイント 1 から VoIP エンドポイント 2 へのビデオ ストリームの診断ログを次に示します。

"properties": {
    "identifier":           "acs:61fddbe3-0003-4066-97bc-6aaf143bbb84_0000000b-4fee-66cf-ac00-343a0d003158",
    "participantId":        "null",
    "endpointId":           "570ea078-74e9-4430-9c67-464ba1fa5859",
    "endpointType":         "VoIP",
    "mediaType":            "Video",
    "streamId":             "2804",
    "transportType":        "UDP",
    "roundTripTimeAvg":     "103",
    "roundTripTimeMax":     "143",
    "jitterAvg":            "0",
    "jitterMax":            "4",
    "packetLossRateAvg":    "3.146336E-05",
    "packetLossRateMax":    "0.001769911"
}

グループ通話

グループ通話のデータは、3 つの通話概要ログと 6 つの通話診断ログに生成されます。 通話のすべてのログで共有されるフィールドを次に示します。

"time":                     "2021-07-05T06:30:06.402Z",
"resourceId":               "SUBSCRIPTIONS/XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX/RESOURCEGROUPS/ACS-TEST-RG/PROVIDERS/MICROSOFT.COMMUNICATION/COMMUNICATIONSERVICES/ACS-PROD-CCTS-TESTS",
"correlationId":            "341acde7-8aa5-445b-a3da-2ddadca47d22",

通話概要ログ

通話概要ログでは、操作とカテゴリ情報が共有されます。

"operationName":            "CallSummary",
"operationVersion":         "1.0",
"category":                 "CallSummary",

VoIP エンドポイント 1 の通話概要を次に示します。

"properties": {
    "identifier":               "acs:1797dbb3-f982-47b0-b98e-6a76084454f1_0000000b-1531-729f-ac00-343a0d00d975",
    "callStartTime":            "2021-07-05T06:16:40.240Z",
    "callDuration":             87,
    "callType":                 "Group",
    "teamsThreadId":            "19:meeting_MjZiOTAyN2YtZWU1Yi00ZTZiLT77777OOOOO99999jgxOTkw@thread.v2",
    "participantId":            "04cc26f5-a86d-481c-b9f9-7a40be4d6fba",
    "participantStartTime":     "2021-07-05T06:16:44.235Z",
    "participantDuration":      "82",
    "participantEndReason":     "0",
    "endpointId":               "5ebd55df-ffff-ffff-89e6-4f3f0453b1a6",
    "endpointType":             "VoIP",
    "sdkVersion":               "1.0.0.3",
    "osVersion":                "Darwin Kernel Version 18.7.0: Mon Nov 9 15:07:15 PST 2020; root:xnu-4903.272.3~3/RELEASE_ARM64_S5L8960X"
}

VoIP エンドポイント 3 の通話概要を次に示します。

"properties": {
    "identifier":               "acs:1797dbb3-f982-47b0-b98e-6a76084454f1_0000000b-1531-57c6-ac00-343a0d00d972",
    "callStartTime":            "2021-07-05T06:16:40.240Z",
    "callDuration":             87,
    "callType":                 "Group",
    "teamsThreadId":            "19:meeting_MjZiOTAyN2YtZWU1Yi00ZTZiLTk2ZDUtYTZlM2I2ZjgxOTkw@thread.v2",
    "participantId":            "1a9cb3d1-7898-4063-b3d2-26c1630ecf03",
    "participantStartTime":     "2021-07-05T06:16:40.240Z",
    "participantDuration":      "87",
    "participantEndReason":     "0",
    "endpointId":               "5ebd55df-ffff-ffff-ab89-19ff584890b7",
    "endpointType":             "VoIP",
    "sdkVersion":               "1.0.0.3",
    "osVersion":                "Android 11.0; Manufacturer: Google; Product: redfin; Model: Pixel 5; Hardware: redfin"
}

PSTN エンドポイント 2 の通話概要を次に示します。

"properties": {
    "identifier":               "null",
    "callStartTime":            "2021-07-05T06:16:40.240Z",
    "callDuration":             87,
    "callType":                 "Group",
    "teamsThreadId":            "19:meeting_MjZiOTAyN2YtZWU1Yi00ZTZiLT77777OOOOO99999jgxOTkw@thread.v2",
    "participantId":            "515650f7-8204-4079-ac9d-d8f4bf07b04c",
    "participantStartTime":     "2021-07-05T06:17:10.447Z",
    "participantDuration":      "52",
    "participantEndReason":     "0",
    "endpointId":               "46387150-692a-47be-8c9d-1237efe6c48b",
    "endpointType":             "PSTN",
    "sdkVersion":               "null",
    "osVersion":                "null"
}

クロステナント通話概要ログを次に示します。

"properties": {
    "identifier":               "1e4c59e1-r1rr-49bc-893d-990dsds8f9f5",
    "callStartTime":            "2022-08-14T06:18:27.010Z",
    "callDuration":             912,
    "callType":                 "Group",
    "teamsThreadId":            "19:meeting_MjZiOTAyN2YtZWU1Yi00ZTZiLT77777OOOOO99999jgxOTkw@thread.v2",
    "participantId":            "aa1dd7da-5922-4bb1-a4fa-e350a111fd9c",
    "participantTenantId":      "02cbdb3c-155a-4b95-b829-6d56a45787ca",
    "participantStartTime":     "2022-08-14T06:18:27.010Z",
    "participantDuration":      "902",
    "participantEndReason":     "0",
    "endpointId":               "02cbdb3c-155a-4d98-b829-aaaaa61d44ea",
    "endpointType":             "VoIP",
    "sdkVersion":               "Redacted",
    "osVersion":                "Redacted"
}

ボットを参加者とするクロステナント通話の概要ログを次に示します。


"properties": {
    "identifier":             "b1902c3e-b9f7-4650-9b23-9999bdabab47",
    "callStartTime":          "2022-08-09T16:00:32Z",
    "callDuration":            1470,
    "callType":               "Group",
    "teamsThreadId":         "19:meeting_MmQwZDcwYTQtZ000HWE6NzI4LTg1YTAtNXXXXX99999ZZZZZ@thread.v2",
    "participantId":           "66e9d9a7-a434-4663-d91d-fb1ea73ff31e",
    "participantStartTime":    "2022-08-09T16:14:18Z",
    "participantDuration":      644,
    "participantEndReason":    "0",
    "endpointId":             "69680ec2-5ac0-4a3c-9574-eaaa77720b82",
    "endpointType":           "Bot",
    "sdkVersion":             "Redacted",
    "osVersion":              "Redacted"
}

通話診断ログ

通話診断ログでは、操作情報が共有されます。

"operationName":            "CallDiagnostics",
"operationVersion":         "1.0",
"category":                 "CallDiagnostics",

VoIP エンドポイント 1 からサーバー エンドポイントへのオーディオ ストリームの診断ログを次に示します。

"properties": {
    "identifier":           "acs:1797dbb3-f982-47b0-b98e-6a76084454f1_0000000b-1531-729f-ac00-343a0d00d975",
    "participantId":        "04cc26f5-a86d-481c-b9f9-7a40be4d6fba",
    "endpointId":           "5ebd55df-ffff-ffff-89e6-4f3f0453b1a6",
    "endpointType":         "VoIP",
    "mediaType":            "Audio",
    "streamId":             "14884",
    "transportType":        "UDP",
    "roundTripTimeAvg":     "46",
    "roundTripTimeMax":     "48",
    "jitterAvg":            "0",
    "jitterMax":            "1",
    "packetLossRateAvg":    "0",
    "packetLossRateMax":    "0"
}

サーバー エンドポイントから VoIP エンドポイント 1 へのオーディオ ストリームの診断ログを次に示します。

"properties": {
    "identifier":           null,
    "participantId":        "04cc26f5-a86d-481c-b9f9-7a40be4d6fba",
    "endpointId":           null,
    "endpointType":         "Server",
    "mediaType":            "Audio",
    "streamId":             "2001",
    "transportType":        "UDP",
    "roundTripTimeAvg":     "42",
    "roundTripTimeMax":     "44",
    "jitterAvg":            "1",
    "jitterMax":            "1",
    "packetLossRateAvg":    "0",
    "packetLossRateMax":    "0"
}

VoIP エンドポイント 3 からサーバー エンドポイントへのオーディオ ストリームの診断ログを次に示します。

"properties": {
    "identifier":           "acs:1797dbb3-f982-47b0-b98e-6a76084454f1_0000000b-1531-57c6-ac00-343a0d00d972",
    "participantId":        "1a9cb3d1-7898-4063-b3d2-26c1630ecf03",
    "endpointId":           "5ebd55df-ffff-ffff-ab89-19ff584890b7",
    "endpointType":         "VoIP",
    "mediaType":            "Audio",
    "streamId":             "13783",
    "transportType":        "UDP",
    "roundTripTimeAvg":     "45",
    "roundTripTimeMax":     "46",
    "jitterAvg":            "1",
    "jitterMax":            "2",
    "packetLossRateAvg":    "0",
    "packetLossRateMax":    "0"
}

サーバー エンドポイントから VoIP エンドポイント 3 へのオーディオ ストリームの診断ログを次に示します。

"properties": {
    "identifier":           "null",
    "participantId":        "1a9cb3d1-7898-4063-b3d2-26c1630ecf03",
    "endpointId":           null,
    "endpointType":         "Server"    
    "mediaType":            "Audio",
    "streamId":             "1000",
    "transportType":        "UDP",
    "roundTripTimeAvg":     "45",
    "roundTripTimeMax":     "46",
    "jitterAvg":            "1",
    "jitterMax":            "4",
    "packetLossRateAvg":    "0",

P2P およびグループ通話の通話クライアント操作ログと通話クライアント メディア統計ログ

通話クライアント操作ログと通話クライアント メディア統計時系列ログの場合、P2P 通話とグループ通話のシナリオに違いはなく、ログの数は SDK 操作と通話時間によって異なります。 次に、これらのログのスキーマを示す一般的なサンプルをいくつか示します。

通話クライアント操作ログ

"CreateView" 操作の通話クライアント操作ログを次に示します。

"properties": {
    "TenantId":               "4e7403f8-515a-4df5-8e13-59f0e2b76e3a",
    "TimeGenerated":          "2024-01-09T17:06:50.3Z",
    "CallClientTimeStamp":    "2024-01-09T15:07:56.066Z",
    "OperationName":          "CreateView" ,   
    "CallId":                 "92d800c4-abde-40be-91e9-3814ee786b19",
    "ParticipantId":          "2656fd6c-6d4a-451d-a1a5-ce1baefc4d5c",
    "OperationType":          "client-api-request",
    "OperationId":            "0d987336-37e0-4acc-aba3-e48741d88103",
    "DurationMs":             "577",
    "ResultType":             "Succeeded",
    "ResultSignature":        "200",
    "SdkVersion":             "1.19.2.2_beta",
    "UserAgent":              "azure-communication-services/1.3.1-beta.1 azsdk-js-communication-calling/1.19.2-beta.2 (javascript_calling_sdk;#clientTag:904f667c-5f25-4729-9ee8-6968b0eaa40b). Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/120.0.0.0 Safari/537.36",
    "ClientInstanceId":       "d08a3d05-db90-415f-88a7-87ae74edc1dd",
    "OperationPayload":       "{"StreamType":"Video","StreamId":"2.0","Source":"remote","RemoteParticipantId":"remote"}",
    "Type":                   "ACSCallClientOperations"
}

各参加者は、1 つの通話に対してさまざまなメトリックを持つ可能性があります。 Azure portal の Log Analytics で次のクエリを実行して、通話クライアント操作ログ内のすべての可能な操作を一覧表示することができます。

ACSCallClientOperations | distinct OperationName

通話クライアント メディア統計時系列ログ

メディア統計時系列ログの例を次に示します。 これは、特定のタイムスタンプでのオーディオ ストリームの受信について、参加者のジッター メトリックを示しています。

"properties": {
    "TenantId":                     "4e7403f8-515a-4df5-8e13-59f0e2b76e3a",
    "TimeGenerated":                "2024-01-10T07:36:51.771Z",
    "OperationName":                "CallClientMediaStatsTimeSeries" ,  
    "CallId":                       "92d800c4-abde-40be-91e9-3814ee786b19", 
    "CallClientTimeStamp":          "2024-01-09T15:07:56.066Z",
    "MetricName":                   "JitterInMs",
    "Count":                        "2",
    "Sum":                          "34",
    "Average":                      "17",
    "Minimum":                      "10",
    "Maximum":                      "25",
    "MediaStreamDirection":         "recv",
    "MediaStreamType":              "audio",
    "MediaStreamCodec":             "OPUS",
    "ParticipantId":                "2656fd6c-6d4a-451d-a1a5-ce1baefc4d5c",
     "ClientInstanceId":            "d08a3d05-db90-415f-88a7-87ae74edc1dd",
    "AggregationIntervalSeconds":   "10",
    "Type":                         "ACSCallClientMediaStatsTimeSeries"
}

各参加者は、1 つの通話に対してさまざまなメディア統計メトリックを持つ可能性があります。 Azure Portal の Log Analytics で次のクエリを実行して、このログに示される可能性があるすべてのメトリックを表示できます。

ACSCallClientMediaStatsTimeSeries | distinct MetricName

エラー コード

participantEndReason プロパティには、一連の Calling SDK エラー コードの値が含まれます。 これらのコードを参照して、各エンドポイントの通話時の問題のトラブルシューティングを行うことができます。 「Azure Communication Services でのトラブルシューティング」を参照してください。

次のステップ