你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站,请访问 https://docs.azure.cn

Azure 通信服务会议室日志

Azure 通信服务提供的日志记录功能可用于监视和调试通信服务解决方案。 可通过 Azure 门户配置这些功能。

重要

下面是通过 Azure Monitor 实现的日志(另请参阅常见问题解答)。 若要为通信服务启用这些日志,请参阅:在诊断设置中启用日志记录

先决条件

Azure 通信服务通过 Azure Monitor 日志概述Azure Monitor 指标提供监视和分析功能。 每个 Azure 资源都需有自身的诊断设置,其设置定义了以下条件:

  • 发送到设置中所定义目标的日志和指标数据的类别。 不同资源类型的可用类别各不相同。
  • 要将日志发送到的一个或多个目标。 当前目标包括 Log Analytics 工作区、事件中心和 Azure 存储。
  • 一个诊断设置只能为每个目标定义一种类型。 若要将数据发送到多个特定的目标类型(例如,两个不同的 Log Analytics 工作区),请创建多个设置。 每个资源最多可以有五个诊断设置。

下面说明了如何配置 Azure Monitor 资源,以开始为通信服务创建日志和指标。 有关对所有 Azure 资源使用诊断设置的详细文档,请参阅:启用诊断设置中的日志记录

注意

在诊断设置名称下,请选择“操作会议室日志”以启用会议室的日志。

概述

会议室操作日志是事件和活动的记录,可提供对会议室 API 请求的见解。 它们会捕获有关会议室基元的性能和功能的详细信息,包括每个会议室请求的状态以及其他属性。 会议室操作日志包含有助于识别会议室使用情况趋势和模式的信息。

日志类别

通信服务提供以下类型的日志,你可以启用:

  • 操作会议室日志 - 提供与会议室服务相关的基本信息

操作会议室日志架构

properties 说明
Correlation ID 请求的唯一 ID。
Level 事件的严重级别。
Operation Name 与日志记录相关联的操作。 例如,CreateRoom、PatchRoom、GetRoom、ListRooms、DeleteRoom、GetParticipants、UpdateParticipants。
Operation Version 与操作关联的 API 版本。
ResultType 操作的状态。
ResultSignature 操作的子状态。 如果该操作对应于 REST API 调用,则此字段为相应 REST 调用的 HTTP 状态代码。
.RoomId 会议室的 ID。
RoomLifeSpan 会议室生存期(以分钟为单位)。
AddedRoomParticipantsCount 添加到会议室的参与者计数。
UpsertedRoomParticipantsCount 会议室中插入或更新的参与者计数。
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",
      },
    ]

(另请参阅常见问题解答)。