Azure 通訊服務會議室記錄

文章
04/26/2024

Azure 通訊服務會提供記錄功能，以供您監視通訊服務解決方案並對其進行偵錯。這些功能可透過 Azure 入口網站來設定。

重要

以下是指透過 Azure 監視器啟用的記錄 (另請參閱常見問題) 。若要為您的通訊服務啟用這些記錄，請參閱：在診斷設定中啟用記錄

必要條件

Azure 通訊服務透過 Azure 監視器記錄概觀和 Azure 監視器計量提供監視和分析功能。每個 Azure 資源都需要自己的診斷設定，其會定義下列準則：

傳送至設定中所定義目的地的記錄和計量資料類別。可用的類別會因不同的資源類型而有所不同。
一個或多個要傳送記錄的目的地。目前的目的地包括 Log Analytics 工作區、事件中樞和 Azure 儲存體。
單一診斷設定可以定義每個目的地不超過一個。如果您想要將資料傳送至超過一個的特定目的地類型 (例如，兩個不同的 Log Analytics 工作區)，則請建立多個設定。每個資源最多可以有五個診斷設定。

下列指示能幫助您設定 Azure 監視器資源，讓您開始為 Azure 通訊服務建立記錄和計量。如需在所有 Azure 資源中使用診斷設定的詳細文件，請參閱在診斷設定中啟用記錄

注意

在 [診斷設定名稱] 底下，請選取 [操作會議室記錄] 以啟用會議室的記錄。

概觀

會議室作業記錄是事件和活動的記錄，可提供會議室 API 要求的深入解析。這些記錄會擷取會議室基本類型效能和功能的詳細資料，包括每個會議室要求的狀態，以及其他屬性。會議室作業記錄包含的資訊有助於識別會議室使用方式的趨勢和模式。

記錄類別

通訊服務提供下列類型的記錄供您啟用：

操作會議室記錄：提供與會議室服務相關的基本資訊

作業會議室記錄架構

屬性	說明
`Correlation ID`	要求的唯一識別碼。
`Level`	事件的嚴重性層級。
`Operation Name`	與記錄相關聯的作業。例如，CreateRoom、PatchRoom、GetRoom、ListRooms、DeleteRoom、GetParticipants、UpdateParticipants。
`Operation Version`	與作業相關聯的 API 版本。
`ResultType`	作業的狀態。
`ResultSignature`	作業的子狀態。如果此作業對應至 REST API 呼叫，則此欄位是對應 REST 呼叫的 HTTP 狀態碼。
.`RoomId`	會議室的識別碼。
`RoomLifeSpan`	會議室的有限期 (以分鐘為單位)。
`AddedRoomParticipantsCount`	新增至會議室的參與者計數。
`UpsertedRoomParticipantsCount`	在會議室中 upsert 的參與者計數。
`RemovedRoomParticipantsCount`	從會議室中移除的參與者計數。
`TimeGenerated`	產生記錄時的時間戳記 (UTC)。
`PstnDialOutEnabled`	指出會議室是否能夠撥打 PSTN 通話來邀請人員參加會議。

範例 CreateRoom 記錄

    [
      {
      "CorrelationId": "Y4x6ZabFE0+E8ERwMpd68w",
      "Level": "Informational",
      "OperationName": "CreateRoom",
      "OperationVersion": "2023-10-30-preview",
      "ResultType": "Succeeded",
      "ResultSignature": 201,
      "RoomId": "99466898241024408",
      "RoomLifespan": 61,
      "AddedRoomParticipantsCount": 4,
      "TimeGenerated": "5/25/2023, 4:32:49.469 AM",
      "PstnDialOutEnabled": false,
      }
    ]

範例 GetRoom 記錄

    [
      {
      "CorrelationId": "CNiZIX7fvkumtBSpFq7fxg",
      "Level": "Informational",
      "OperationName": "GetRoom",
      "OperationVersion": "2023-10-30-preview",
      "ResultType": "Succeeded",
      "ResultSignature": "200",
      "RoomId": "99466387192310000",
      "RoomLifespan": 61,
      "TimeGenerated": "2022-08-19T17:07:30.2400300Z",
      },
    ]

範例 UpdateRoom 記錄

    [
      {
      "CorrelationId": "Bwqzh0pdnkGPDwNcMnBkng",
      "Level": "Informational",
      "OperationName": "UpdateRoom",
      "OperationVersion": "2023-10-30-preview",
      "ResultType": "Succeeded",
      "ResultSignature": "200",
      "RoomId": "99466387192310000",
      "RoomLifespan": 121,
      "TimeGenerated": "2022-08-19T17:07:30.3543160Z",
      "PstnDialOutEnabled": false,
      },
    ]

範例 DeleteRoom 記錄

    [
      {
      "CorrelationId": "x7rMXmihYEe3GFho9T/H2w",
      "Level": "Informational",
      "OperationName": "DeleteRoom",
      "OperationVersion": "2023-10-30-preview",
      "ResultType": "Succeeded",
      "ResultSignature": "204",
      "RoomId": "99466387192310000",
      "RoomLifespan": 121,
      "TimeGenerated": "2022-08-19T17:07:30.5393800Z",
      },
    ]

範例 ListRooms 記錄

	[
	  {
	  "CorrelationId": "KibM39CaXkK+HTInfsiY2w",
	  "Level": "Informational",
	  "OperationName": "ListRooms",
	  "OperationVersion": "2023-10-30-preview",
	  "ResultType": "Succeeded",
	  "ResultSignature": "200",
	  "TimeGenerated": "2022-08-19T17:07:30.5393800Z",
	  },
	]

範例 UpdateParticipants 記錄

    [
      {
      "CorrelationId": "zHT8snnUMkaXCRDFfjQDJw",
      "Level": "Informational",
      "OperationName": "UpdateParticipants",
      "OperationVersion": "2023-10-30-preview",
      "ResultType": "Succeeded",
      "ResultSignature": "200",
      "RoomId": "99466387192310000",
      "RoomLifespan": 121,
      "UpsertedRoomParticipantsCount": 5,
      "RemovedRoomParticipantsCount": 1,
      "TimeGenerated": "2023-04-14T17:07:30.5393800Z",
      },
    ]

(另請參閱常見問題集)。

Share via