Azure 通訊服務 通話記錄概觀
Azure 通訊服務會提供記錄功能，以供您監視通訊服務解決方案並對其進行偵錯。 透過 Azure 入口網站設定這些功能。
本文中的內容是指透過 Azure 監視器 (部分機器翻譯) 啟用的記錄 (另請參閱常見問題集 (部分機器翻譯))。 若要為通訊服務啟用這些記錄，請參閱在診斷設定中啟用記錄 (部分機器翻譯)。
重要
如果您想要分析記錄，您必須收集記錄。 若要深入瞭解，請參閱：如何? 儲存記錄？
除非您啟用這些特定的診斷設定，否則 Azure 不會儲存通話記錄數據。 您的通話數據無法追溯使用。 建立診斷設定之後，就會累積數據。
如何使用通話記錄
建議您在記錄分析資源中收集所有可用的通話記錄，以便監視通話使用量，並改善通話品質，並在發行記錄時從 Azure 通訊服務 接收新的記錄。
有兩個主要工具可用來監視通話並改善通話品質。
建議您使用語音和視訊深入解析儀錶板儀錶板來啟動任何質量調查，並視需要使用通話診斷，以在您需要細微的詳細數據時探索個別通話。
可用的記錄
Azure 通訊服務 會建立八個通話記錄：
通話摘要更新記錄：
這些記錄數據會比通話摘要記錄快到 Azure 監視器，我們建議使用這些記錄，而不是呼叫摘要記錄架構。 此記錄包含呼叫的基本資訊，包括所有相關標識符、時間戳、端點和 SDK 資訊。
若要深入瞭解，請參閱： 呼叫摘要更新記錄架構
通話摘要記錄：
此記錄是呼叫摘要更新記錄架構的子集。 其中包含呼叫的基本資訊，包括所有相關標識碼、時間戳、端點和 SDK 資訊。 如需更快的記錄延遲，請改用呼叫摘要更新記錄。
若要深入瞭解，請參閱： 呼叫摘要記錄架構
通話診斷更新記錄：
這些記錄數據會比呼叫診斷記錄更快抵達 Azure 監視器，我們建議使用這些記錄，而不是呼叫診斷記錄架構。 此記錄包含參與者通話媒體串流的相關信息，以及一組指出體驗度量品質的計量。
若要深入瞭解，請參閱： 呼叫診斷更新記錄架構
通話診斷記錄：
此記錄是呼叫診斷更新記錄架構的子集。 其中包含數據流的相關信息，以及一組指出體驗度量品質的計量。 如需更快的記錄延遲，請改用呼叫摘要更新記錄。
若要深入瞭解，請參閱： 呼叫診斷記錄架構
通話客戶端作業記錄：
包含詳細的呼叫用戶端事件。 這些記錄事件會針對通話中的每個 EndpointId 產生，而產生的事件記錄數目將取決於參與者在通話期間執行的作業。
若要深入瞭解，請參閱： 呼叫用戶端作業記錄架構
通話客戶端媒體統計資料記錄：
包含詳細的媒體串流值。 這些記錄會針對通話中的每個媒體串流產生。 對於通話中的每個 EndpointId (包括伺服器)，Azure 通訊服務會為端點之間的每個媒體串流 (例如音訊或視訊) 建立不同的記錄。 每個記錄中產生的資料量取決於通話持續時間和通話中的媒體串流數目。
在 P2P 通話中，每個記錄都包含與每個端點相關聯之每個輸出串流有關的資料。 在群組通話中，與 endpointType = "Server" 相關聯的每個串流都會建立記錄，其中包含輸入串流的資料。 所有其他串流都會建立記錄，其中包含所有非伺服器端點輸出串流的資料。 在群組通話中，使用 participantId 值作為索引鍵來將相關的輸入和輸出記錄加入到不同的參與者連線中。
若要深入瞭解，請參閱： 呼叫用戶端媒體統計數據時間序列記錄架構
通話問卷記錄的結束：
當 Web 通話用戶端在通話結束時提交問卷時，就會填入這些記錄。 您可以使用這些記錄，從使用者瞭解通話品質的主觀感知。
若要深入瞭解，請參閱： 通話問卷結束概觀
通話計量記錄：
這些記錄會根據 SDK 版本、OS 名稱和錯誤子碼等屬性，在每日量化中包含匯總的呼叫計量。 這些記錄會用於語音和視訊深入解析儀錶板，根據各種作業成功和失敗的呼叫 SDK API 呼叫計數，將可靠性、品質和效能的長期圖表可視化。
若要深入瞭解，請參閱： 呼叫計量記錄架構
資料概念
下列數據概念的高階描述是語音和視訊通話特有的。 檢閱這些概念非常重要，如此您才能了解記錄中所擷取資料的意義。
實體和 ID
請熟悉下列詞彙：
通話：如資料所示，通話是由
correlationId所描述的抽象概念。correlationId的值對每次通話而言都是唯一的，而且根據callStartTime和callDuration受到時間限制。參與者：代表端點與伺服器之間的連線。 只有在通話是群組通話時，才會有參與者 (
participantId)。端點：是最唯一的實體，由
endpointId表示。 每次通話都是一個事件，其中包含來自兩個或多個端點的資料。 端點代表通話中的參與者。EndpointType可告訴您，端點是人類使用者 (PSTN 或 VoIP)、聊天機器人，還是管理通話中多個參與者的伺服器。 當endpointType值為"Server"時，端點就不會獲指派唯一識別碼。 您可以分析endpointType及endpointId值的數目，以判斷有多少使用者和其他非人類參與者 (聊天機器人與伺服器) 加入通話。適用於 Android 和 iOS 的原生 SDK 會針對多個通話中的使用者重複使用相同的
endpointId值，讓您能夠了解跨工作階段的體驗。 此流程與 Web 型端點不同，後者一律會為每次新通話產生新的endpointId值。串流：最細微的實體。 每個方向 (輸入或輸出) 都有一個串流和
mediaType值 (例如，Audio或Video)。
P2P 通話與群組通話
注意
在本文中，P2P 和群組呼叫預設位於相同的租用戶內。 跨租使用者的所有呼叫案例都會在整個文章中據此指定。
有兩種類型的通話 (以 callType 表示)：
對等互連 (P2P) 通話：僅兩個端點之間的連線，沒有伺服器端點。 P2P 通話會以那些端點之間的單一通話來起始，而且不會在連線之前建立為群組通話事件。
群組通話：任何與兩個以上端點連線的通話。 群組通話包含伺服器端點，以及每個端點與伺服器之間的連線。 在通話期間新增另一個端點的 P2P 通話會停止成為 P2P，而是成為群組通話。 您可以透過使用
participantStartTime和participantDuration計量，來判斷每個端點何時加入通話的時間軸。
各種呼叫類型的範例
注意
在本文中，P2P 和群組呼叫預設位於相同的租用戶內。 跨租使用者的所有呼叫案例都會在整個文章中據此指定。
範例：P2P 通話
下圖表示在 P2P 通話中直接連線的兩個端點。 在此範例中，通訊服務會建立兩個通話摘要記錄（每個 participantID 值一個）和四個呼叫診斷記錄（每個媒體數據流各一個）。
針對 Azure 通訊服務通話用戶端參與者，也有一系列的通話用戶端作業記錄和通話用戶端媒體統計資料時間序列記錄。 這些記錄的確切數目取決於通話的 SDK 作業種類，以及通話持續時間。
範例：群組通話
下圖表示群組通話範例，其中包含三個 participantId 值 (這意味著三個參與者) 和一個伺服器端點。 多個適用於 endpointId 的值可能會出現在多個參與者中，例如，當他們從同一個裝置重新加入通話時。 通訊服務會針對每個 participantId 值建立一個通話摘要記錄。 它會建立四個呼叫診斷記錄：每個 participantId媒體數據流各一個。
針對 Azure 通訊服務通話用戶端參與者，通話用戶端作業記錄會與 P2P 通話相同。 針對每個使用通話 SDK 的參與者，有一系列通話用戶端作業記錄。
針對 Azure 通訊服務通話用戶端參與者，通話用戶端作業記錄和通話用戶端媒體統計資料時間序列記錄會與 P2P 通話相同。 針對每個使用通話 SDK 的參與者，有一系列通話用戶端作業記錄和通話用戶端媒體統計資料時間序列記錄。
範例：跨租用戶的 P2P 通話
下圖表示在多個租用戶之間的兩個參與者，其會在 P2P 通話中直接連線。 在此範例中，通訊服務會建立一個通話摘要記錄 (每個參與者各一個)，其中包含已修訂的 OS 和 SDK 版本。 通訊服務也會建立四個呼叫診斷記錄（每個媒體數據流各一個）。 每個記錄均包含與 participantID 輸出串流相關的資料。
範例：跨租用戶的群組通話
下圖表示群組通話範例，其中包含三個跨多個租用戶的 participantId 值。 通訊服務會針對每個參與者建立一個通話摘要記錄，其中包含已修訂的 OS 和 SDK 版本。 通訊服務也會建立四個與每個 participantId 值相關的呼叫診斷記錄（每個媒體數據流各一個）。
注意
此版本僅支援輸出診斷記錄。 您可以修訂與聊天機器人和參與者相關聯的 OS 和 SDK 版本，因為通訊服務會以相同方式處理參與者和聊天機器人的身分識別。
常見問題集
如何? 儲存記錄？
下一節說明這項需求。
根據預設，Azure 通訊服務 記錄不會儲存在 Azure 帳戶中，因此您必須開始儲存記錄，以便語音和視訊深入解析儀錶板和通話診斷等工具能夠運作。 若要收集這些通話記錄，您必須啟用診斷設定，以將通話數據導向Log Analytics工作區。
數據不會追溯儲存，因此只有在設定診斷設定之後，您才會開始擷取通話記錄。
請在透過 Azure 監視器中的診斷設定啟用記錄中遵循指示，為您的資源新增診斷設定。 我們建議您一 開始收集所有記錄。 在了解 Azure 監視器中的功能之後，請確定您要保留哪些記錄，以及保留多久時間。 當您新增診斷設定時，系統會提示您選取記錄。 若要收集 所有記錄，請選取 allLogs。
Azure 監視器內 Log Analytics 中的數據磁碟區、保留期和使用量會透過現有的 Azure 數據計量計費。 建議您因應成本考量，視需要監視資料使用量和保留原則。 如需詳細資訊，請參閱控制成本。
如果您有多個 Azure 通訊服務資源識別碼，則必須為每個資源識別元啟用這些設定。