你当前正在访问 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",
},
]
(另请参阅常见问题解答)。