Azure 通訊服務通話錄音記錄
Azure 通訊服務會提供記錄功能，以供您監視通訊服務解決方案並對其進行偵錯。 您可以透過 Azure 入口網站設定這些功能。
本文中的內容是指透過 Azure 監視器啟用的記錄 (另請參閱常見問題集)。 若要為通訊服務啟用這些記錄，請參閱在診斷設定中啟用記錄。
資源記錄類別
通訊服務提供下列類型的記錄供您啟用：
- 使用量記錄：提供與每個計費服務供應項目相關聯的使用量資料。
- 通話錄音摘要記錄：提供通話錄音的摘要資訊，例如：
- 通話持續時間。
- 媒體內容 (例如音訊/視訊、原音或轉譯)。
- 用於錄音的格式類型 (例如 WAV 或 MP4)。
- 錄音結束的原因。
- 錄音傳入作業記錄：提供通話錄音作業傳入要求的相關資訊。 每個項目都會對應至通話錄音 API 通話的結果，例如 StartRecording、StopRecording、PauseRecording 和 ResumeRecording。
錄音檔案會在通話或會議結束時產生。 使用者或應用程式 (Bot) 都可以啟動和停止錄音。 錄音也可能因為系統失敗而結束。
摘要記錄會在錄音準備好下載之後發佈。 記錄會在 Azure 監視器資源記錄的標準延遲時間內發佈。 請參閱 Azure 監視器中的記錄資料擷取時間。
使用量記錄結構描述
| 屬性 | 說明 |
|---|---|
timestamp |
產生記錄時的時間戳記 (UTC)。 |
operationName |
與記錄錄製相關聯的作業。 |
operationVersion |
與作業相關聯的 api-version 值 (如果已透過 API 執行 operationName 作業)。 如果沒有對應至此作業的 API，則版本代表作業的版本，以防日後與作業相關聯屬性的變更。 |
category |
事件的記錄類別。 此類別是您可在資源上啟用或停用記錄的細微性。 出現在事件 properties Blob 內的屬性，會與記錄類別和資源類型內的相同。 |
correlationID |
相互關聯事件的識別碼。 您可以使用此識別碼來識別多個資料表之間相互關聯的事件。 |
Properties |
適用於各種通訊服務模式的其他資料。 |
recordID |
使用方式記錄的唯一識別碼。 |
usageType |
使用方式的模式 (例如，聊天、PSTN 或 NAT)。 |
unitType |
針對使用方式的模式，使用方式所依據的單位類型 (例如，分鐘數、MB 或訊息數)。 |
quantity |
此記錄所使用或取用的單位數。 |
通話錄音摘要記錄結構描述
| 屬性名稱 | 資料類型 | 描述 |
|---|---|---|
timeGenerated |
Datetime | 產生記錄時的時間戳記 (UTC)。 |
operationName |
String | 與記錄錄製相關聯的作業。 |
correlationId |
String | 用來將資料表之間的事件相互關聯的識別碼。 |
recordingID |
String | 此記錄所參照錄製的識別碼。 |
category |
String | 事件的記錄類別。 具有相同記錄類別和資源類型的記錄，會有相同的屬性欄位。 |
resultType |
String | 作業的狀態。 |
level |
String | 作業的嚴重性層級。 |
chunkCount |
整數 | 為錄製建立的區塊總數。 |
channelType |
String | 錄製的頻道類型，例如混合或原音。 |
recordingStartTime |
Datetime | 錄製開始的時間。 |
contentType |
String | 錄製的內容，例如僅限音訊、音訊/視訊或轉譯。 |
formatType |
String | 錄製的檔案格式。 |
recordingLength |
Double | 錄製的持續時間 (秒)。 |
audioChannelsCount |
整數 | 錄製中的音訊頻道總數。 |
recordingEndReason |
String | 錄音結束的原因。 |
通話錄音和範例資料
"operationName": "Call Recording Summary",
"operationVersion": "1.0",
"category": "RecordingSummary",
通話可以有一份錄音或多份錄音，視觸發錄音事件的次數而定。
例如，如果服務專員在錄音的線路中起始了外撥通話，而通話因網路訊號不佳而中斷，則 callID 會有一個 recordingID 值。 如果服務專員回電給客戶，系統會產生新的 callID 執行個體和新的 recordingID 值。
範例：一次通話一份錄音的通話錄音
"properties"
{
"TimeGenerated":"2022-08-17T23:18:26.4332392Z",
"OperationName": "RecordingSummary",
"Category": "CallRecordingSummary",
"CorrelationId": "zzzzzz-cada-4164-be10-0000000000",
"ResultType": "Succeeded",
"Level": "Informational",
"RecordingId": "eyJQbGF0Zm9ybUVuZHBvaW5xxxxxxxxFmNjkwxxxxxxxxxxxxSZXNvdXJjZVNwZWNpZmljSWQiOiJiZGU5YzE3Ni05M2Q3LTRkMWYtYmYwNS0yMTMwZTRiNWNlOTgifQ",
"RecordingEndReason": "CallEnded",
"RecordingStartTime": "2022-08-16T09:07:54.0000000Z",
"RecordingLength": "73872.94",
"ChunkCount": 6,
"ContentType": "Audio - Video",
"ChannelType": "mixed",
"FormatType": "mp4",
"AudioChannelsCount": 1
}
如果服務專員啟動錄音，然後在通話仍在進行時多次停止並重新啟動錄音，則 callID 會有許多 recordingID 值。 值數目取決於觸發錄音事件的次數。
範例：一次通話多份錄音的通話錄音
{
"TimeGenerated": "2022-08-17T23:55:46.6304762Z",
"OperationName": "RecordingSummary",
"Category": "CallRecordingSummary",
"CorrelationId": "xxxxxxx-cf78-4156-zzzz-0000000fa29cc",
"ResultType": "Succeeded",
"Level": "Informational",
"RecordingId": "eyJQbGF0Zm9ybUVuZHBxxxxxxxxxxxxjkwMC05MmEwLTRlZDYtOTcxYS1kYzZlZTkzNjU0NzciLCJSxxxxxNwZWNpZmljSWQiOiI5ZmY2ZTY2Ny04YmQyLTQ0NzAtYmRkYy00ZTVhMmUwYmNmOTYifQ",
"RecordingEndReason": "CallEnded",
"RecordingStartTime": "2022-08-17T23:55:43.3304762Z",
"RecordingLength": 3.34,
"ChunkCount": 1,
"ContentType": "Audio - Video",
"ChannelType": "mixed",
"FormatType": "mp4",
"AudioChannelsCount": 1
}
{
"TimeGenerated": "2022-08-17T23:55:56.7664976Z",
"OperationName": "RecordingSummary",
"Category": "CallRecordingSummary",
"CorrelationId": "xxxxxxx-cf78-4156-zzzz-0000000fa29cc",
"ResultType": "Succeeded",
"Level": "Informational",
"RecordingId": "eyJQbGF0Zm9ybUVuxxxxxxiOiI4NDFmNjkwMC1mMjBiLTQzNmQtYTg0Mi1hODY2YzE4M2Y0YTEiLCJSZXNvdXJjZVNwZWNpZmljSWQiOiI2YzRlZDI4NC0wOGQ1LTQxNjEtOTExMy1jYWIxNTc3YjM1ODYifQ",
"RecordingEndReason": "CallEnded",
"RecordingStartTime": "2022-08-17T23:55:54.0664976Z",
"RecordingLength": 2.7,
"ChunkCount": 1,
"ContentType": "Audio - Video",
"ChannelType": "mixed",
"FormatType": "mp4",
"AudioChannelsCount": 1
}
ACSCallRecordingIncomingOperations 記錄
屬性如下：
| 屬性 | 說明 |
|---|---|
timeGenerated |
產生記錄時的時間戳記 (UTC)。 |
callConnectionId |
通話連線或連結的識別碼 (如果有的話)。 |
callerIpAddress |
呼叫端 IP 位址，如果作業對應至來自具有公開可用 IP 位址之實體的 API 呼叫。 |
correlationId |
相互關聯事件的識別碼。 您可以使用此識別碼來識別多個資料表之間相互關聯的事件。 |
durationMs |
作業的持續時間 (以毫秒為單位)。 |
level |
作業的嚴重性層級。 |
operationName |
與記錄錄製相關聯的作業。 |
operationVersion |
與作業或作業版本相關聯的 API 版本 (如果沒有 API 版本)。 |
resourceId |
記錄相關資源的唯一識別碼。 |
resultSignature |
作業的子狀態。 如果此作業對應至 REST API 呼叫，則此欄位是對應 REST 呼叫的 HTTP 狀態碼。 |
resultType |
作業的狀態。 |
sdkType |
在要求中使用的 SDK 類型。 |
sdkVersion |
SDK 版本。 |
serverCallId |
伺服器通話識別碼。 |
URI |
要求的 URI。 |
以下是範例：
"properties"
{ "TimeGenerated": "2023-05-09T15:58:30.100Z",
"Level": "Informational",
"CorrelationId": "a999f996-b4e1-xxxx-ac04-a59test87d97",
"OperationName": "ResumeCallRecording",
"OperationVersion": "2023-03-06",
"URI": "https://acsresouce.communication.azure.com/calling/recordings/ eyJQbGF0Zm9ybUVuZHBviI0MjFmMTIwMC04MjhiLTRmZGItOTZjYi0...:resume?api-version=2023-03-06",
"ResultType": "Succeeded",
"ResultSignature": 202,
"DurationMs": 130,
"CallerIpAddress": "127.0.0.1",
"CallConnectionId": "d5596715-ab0b-test-8eee-575c250e4234",
"ServerCallId": "aHR0cHM6Ly9hcGk0vjCCCCCCQd2pRP2k9OTMmZT02Mzc5OTQ3xMDAzNDUwMzg...",
"SdkVersion": "1.0.0-alpha.20220829.1",
"SdkType": "dotnet"
}