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

Azure 通信服务聊天日志

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

重要

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

资源日志类别

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

• 使用情况日志 - 提供与每个计费服务产品相关联的使用情况数据
• 身份验证操作日志 - 提供与身份验证服务相关的基本信息
• 聊天操作日志 - 提供与聊天服务相关的基本信息

使用情况日志架构

properties	说明
Timestamp	生成日志的时间戳 (UTC)。
Operation Name	与日志记录相关联的操作。
Operation Version	如果使用 API 执行 operationName，则 api-version 与该操作关联。 如果没有与该操作相对应的 API，则此版本表示该操作的版本，以防与该操作关联的属性将来发生更改。
Category	事件的日志类别。 类别是可以在特定资源上启用或禁用日志的粒度。 在事件的属性 blob 内显示的属性在特定日志类别和资源类型中相同。
Correlation ID	关联事件的 ID。 可用于标识多个表之间的关联事件。
Properties	适用于各种通信服务模式的其他数据。
Record ID	给定使用情况记录的唯一 ID。
Usage Type	使用情况模式。 （例如 聊天、PSTN、NAT 等）
Unit Type	对于给定的使用情况模式，使用情况所基于的单位类型。 （例如分钟、兆字节、消息等）。
Quantity	此记录使用或消耗的单位数。

身份验证操作日志

properties	说明
TimeGenerated	生成日志的时间戳 (UTC)。
OperationName	与日志记录相关联的操作。
CorrelationID	关联事件的 ID。 可用于标识多个表之间的关联事件。
OperationVersion	如果使用 API 执行 operationName，则 api-version 与该操作关联。 如果没有与该操作相对应的 API，则此版本表示该操作的版本，以防与该操作关联的属性将来发生更改。
Category	事件的日志类别。 类别是可以在特定资源上启用或禁用日志的粒度。 在事件的属性 blob 内显示的属性在特定日志类别和资源类型中相同。
ResultType	操作的状态。
ResultSignature	操作的子状态。 如果该操作对应于 REST API 调用，则此字段为相应 REST 调用的 HTTP 状态代码。
DurationMs	操作持续时间，以毫秒为单位。
CallerIpAddress	调用方 IP 地址，前提是该操作对应于来自某个具有公开可用 IP 地址的实体的 API 调用。
Level	事件的严重级别。
URI	请求的 URI。
SdkType	请求中使用的 SDK 类型。
PlatformType	请求中使用的平台类型。
Identity	与操作相关的 Azure 通信服务或 Teams 用户的标识。
Scopes	访问令牌中显示的通信服务范围。

聊天操作日志

properties	说明
TimeGenerated	生成日志的时间戳 (UTC)。
OperationName	与日志记录相关联的操作。
CorrelationID	关联事件的 ID。 可用于标识多个表之间的关联事件。
OperationVersion	如果使用 API 执行 operationName，则 api-version 与该操作关联。 如果没有与该操作相对应的 API，则此版本表示该操作的版本，以防与该操作关联的属性将来发生更改。
类别	事件的日志类别。 类别是可以在特定资源上启用或禁用日志的粒度。 在事件的属性 blob 内显示的属性在特定日志类别和资源类型中相同。
ResultType	操作的状态。
ResultSignature	操作的子状态。 如果该操作对应于 REST API 调用，则此字段为相应 REST 调用的 HTTP 状态代码。
ResultDescription	此操作的静态文本说明。
DurationMs	操作持续时间，以毫秒为单位。
CallerIpAddress	调用方 IP 地址，前提是该操作对应于来自某个具有公开可用 IP 地址的实体的 API 调用。
Level	事件的严重级别。
URI	请求的 URI。
UserID	请求发送方的用户 ID。
ChatThreadId	与请求关联的聊天线程 ID。
ChatMessageId	与请求关联的聊天消息 ID。
SdkType	请求中使用的 SDK 类型。
PlatformType	请求中使用的平台类型。