通过

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

通话结束调查

  • 项目

注意

目前只有我们的 JavaScript/Web SDK 支持通话结束调查。

先决条件

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

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

重要

必须在 Azure Monitor 中启用诊断设置，才能将调查的日志数据发送到 Log Analytics 工作区、事件中心或 Azure 存储帐户，以便接收和分析调查数据。 如果不向其中一个选项发送调查数据，那么不会保存调查数据且会丢失。以下说明解释如何配置 Azure Monitor 资源以开始为通信服务创建日志和指标。 有关对所有 Azure 资源使用诊断设置的详细文档，请参阅：启用诊断设置中的日志记录

注意

在诊断设置名称下，请选择“通话调查”以启用通话结束调查日志。

通话调查诊断设置的屏幕截图。

概述

通话结束调查日志的实现代表着 Azure 通信服务（Azure 通信服务）中的一项增强功能，使 Contoso 能够提交调查，以收集客户有关通话体验的主观反馈。 此方法旨在补充对通话质量的评估，而不是客观指标，例如音频和视频比特率、抖动和延迟，这些指标可能无法完全捕获客户体验是满意还是不满意。 通过利用 Azure 日志来发布和检查调查数据，Contoso 将获得用于分析和识别需要改进的领域的见解。 这些调查结果充当 Azure 通信服务持续监视并提高质量和可靠性的宝贵资源。 有关通话结束调查的更多详细信息

通话结束调查是一个有价值的工具，可用于收集最终用户对 JavaScript/Web SDK 通话解决方案的质量和可靠性的想法的见解。 随附的日志包含有助于评估最终用户体验的关键数据，包括：

整体通话：响应指示通话参与者如何看待他们的整体通话质量。

  • 音频：响应指示用户是否察觉到任何音频问题。
  • 视频：响应指示用户是否察觉到任何视频问题。
  • 屏幕共享：响应指示用户是否察觉到任何屏幕共享问题。 除了上述内容，响应中的可选标记还进一步深入探讨了与音频、视频或屏幕共享相关的特定类型问题。

通过分析通话结束调查日志中捕获的数据，你可以确定需要改进的区域，从而增强整体用户体验。

资源日志类别

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

  • 通话结束调查日志 - 提供与通话结束时的调查相关的基本信息

属性

属性 说明
Timegenerated 此字段表示生成日志时的时间戳 (UTC)
CorrelationId 相关性事件 ID 可用于标识多个表之间的关联事件
Category 事件的日志类别。 具有相同日志类别和资源类型的日志将具有相同的属性字段
ResourceId 用户资源的完整长度标识符
OperationName 与日志记录关联的操作
OperationVersion 如果使用 API 执行 operationName，则 API-version 与该操作或操作版本关联
CallId 用于关联的通话的标识符。 可用于标识多个表之间的关联事件
ParticipantId 参与者 ID
SurveyId 参与者提交的调查的标识符。 可用于标识多个表之间的关联事件
OverallCallIssues 此字段表示与整体通话相关的任何问题，其值是逗号分隔的说明列表
AudioIssues 此字段表示与音频体验相关的任何问题，其值是逗号分隔的说明列表
VideoIssues 此字段表示与视频体验相关的任何问题，其值是逗号分隔的说明列表
ScreenshareIssues 此字段表示与屏幕共享体验相关的任何问题，其值是逗号分隔的说明列表
OverallRatingScore 此字段表示参与者对整体通话体验的评分
OverallRatingScoreLowerBound 此字段表示 OverallRatingScore 级别的最小值
OverallRatingScoreUpperBound 此字段表示 OverallRatingScore 级别的最大值
OverallRatingScoreThreshold 此字段指示一个值，OverallRatingScore 超过该值表示质量更佳
AudioRatingScore 此字段表示参与者对音频体验的评分
AudioRatingScoreLowerBound 此字段表示 AudioRatingScore 级别的最小值
AudioRatingScoreUpperBound 此字段表示 AudioRatingScore 级别的最大值
AudioRatingScoreThreshold 此字段指示一个值，AudioRatingScore 超过该值表示质量更佳
VideoRatingScore 此字段表示参与者对视频体验的评分
VideoRatingScoreLowerBound 此字段表示 VideoRatingScore 级别的最小值
VideoRatingScoreUpperBound 此字段表示 VideoRatingScore 级别的最大值
VideoRatingScoreThreshold 此字段指示一个值，VideoRatingScore 超过该值表示质量更佳
ScreenshareRatingScore 此字段表示参与者对屏幕共享体验的评分
ScreenshareLowerBound 此字段表示 ScreenshareRatingScore 级别的最小值
ScreenshareUpperBound 此字段表示 ScreenshareRatingScore 级别的最大值
ScreenshareRatingThreshold 此字段指示一个值，ScreenshareRatingScore 超过该值表示质量更佳

示例日志

整体通话示例

[
{
"TimeGenerated":"2023-04-12T14:21:35.0700920Z", 
"CorrelationId":"aaaa0000-bb11-2222-33cc-444444dddddd",
"Category":"CallSurvey", 
"ResourceId":"/SUBSCRIPTIONS/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/RESOURCEGROUPS/ACS-DATALYTICS-SPGW-RG/PROVIDERS/MICROSOFT.COMMUNICATION/COMMUNICATIONSERVICES/ACS-DATALYTICS-ALLTELEMETRY", 
"OperationName":"CallSurvey", 
"OperationVersion":"0.0"

"properties": 
    {
        "CallId":"fcc1234f-ce69-ZZZZ-b73f-b036051test4",
        "SurveyId":"a6dd61c4-b924-4885-96a4-a991d4c09e8b",
        "ParticipantId":"aaaa0000-bb11-2222-33cc-444444dddddd",
        "OverallCallIssues":"CallCannotJoin",
        "OverallRatingScore":7,
        "OverallRatingScoreLowerBound":0,
        "OverallRatingScoreUpperBound":10,
        "OverallRatingScoreThreshold":5        
    }

}
]

音频质量示例

[
{
"TimeGenerated":"2023-04-12T14:21:35.0700920Z", 
"CorrelationId":"aaaa0000-bb11-2222-33cc-444444dddddd",
"Category":"CallSurvey", 
"ResourceId":"/SUBSCRIPTIONS/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/RESOURCEGROUPS/ACS-DATALYTICS-SPGW-RG/PROVIDERS/MICROSOFT.COMMUNICATION/COMMUNICATIONSERVICES/ACS-DATALYTICS-ALLTELEMETRY", 
"OperationName":"EndOfCallSurvey", 
"OperationVersion":"0.0"

"properties": 
    {
        "CallId":"fcc1234f-ce69-ZZZZ-b73f-b036051test4",
        "SurveyId":"a6dd61c4-xxxx-4885-96a4-a991d4c09e8b",
        "ParticipantId":"aaaa0000-bb11-2222-33cc-444444dddddd",
        "AudioIssues":"NoRemoteAudio",      
        "AudioRatingScore":6,
        "AudioRatingScoreLowerBound":0,
        "AudioRatingScoreUpperBound":10,
        "AudioRatingScoreThreshold":4        	
    }
]

视频质量示例

[
{
"TimeGenerated":"2023-04-12T14:21:35.0700920Z", 
"CorrelationId":"aaaa0000-bb11-2222-33cc-444444dddddd",
"Category":"CallSurvey", 
"ResourceId":"/SUBSCRIPTIONS/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/RESOURCEGROUPS/ACS-DATALYTICS-SPGW-RG/PROVIDERS/MICROSOFT.COMMUNICATION/COMMUNICATIONSERVICES/ACS-DATALYTICS-ALLTELEMETRY", 
"OperationName":"CallSurvey", 
"OperationVersion":"0.0"

"properties": 
    {
        "CallId":"fcc87f7f-ce69-eeed-7777-b036051faea4",
        "SurveyId":"a6dd61c4-zzzz-4885-tttt-a991d4c09e8b",
        "ParticipantId":"aaaa0000-bb11-2222-33cc-444444dddddd",
        "VideoIssues":"NoVideoReceived",
        "VideoRatingScore":9,
        "VideoRatingScoreLowerBound":0,
        "VideoRatingScoreUpperBound":10,
        "VideoRatingScoreThreshold":7
    }
}
]

屏幕共享示例

[
{
"TimeGenerated":"2023-04-12T14:21:35.0700920Z", 
"TimeGenerated":"2023-04-12T14:21:35.0700920Z", 
"CorrelationId":"aaaa0000-bb11-2222-33cc-444444dddddd",
"Category":"CallSurvey", 
"ResourceId":"/SUBSCRIPTIONS/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/RESOURCEGROUPS/ACS-DATALYTICS-SPGW-RG/PROVIDERS/MICROSOFT.COMMUNICATION/COMMUNICATIONSERVICES/ACS-DATALYTICS-ALLTELEMETRY", 
"OperationName":"EndOfCallSurvey", 
"OperationVersion":"0.0"

"properties": 
    {
        "CallId":"1237f7f-ce69-ffff-b73f-b036051f6666",
        "SurveyId":"a6dd6bbb-b924-zzzz-96a4-a991d4c01000",
        "ParticipantId":"aaaa0000-bb11-2222-33cc-444444dddddd",
        "ScreenshareIssues":"StoppedUnexpectedly,CannotPresent",
        "ScreenshareRatingScore":2,
        "ScreenshareRatingScoreLowerBound":0,
        "ScreenshareRatingScoreUpperBound":10,
        "ScreenshareRatingScoreThreshold":3
    }
}
]