통화 종료 설문 조사
참고 항목
통화 종료 설문 조사는 현재 JavaScript/웹 SDK에서만 지원됩니다.
필수 조건
Azure Communications Services는 Azure Monitor 로그 개요 및 Azure Monitor 메트릭을 통해 모니터링 및 분석 기능을 제공합니다. 각 Azure 리소스에는 다음 기준을 정의하는 자체 진단 설정이 필요합니다.
- 설정에 정의된 대상으로 전송된 로그 및 메트릭 데이터의 범주입니다. 사용 가능한 범주는 리소스 종류에 따라 달라집니다.
- 로그를 보낼 하나 이상의 대상입니다. 현재 대상에는 Log Analytics 작업 영역, Event Hubs 및 Azure Storage가 포함됩니다.
- 단일 진단 설정으로 각 대상 중 하나만 정의할 수 있습니다. 데이터를 2개 이상의 특정 대상 유형(예: 두 개의 다른 Log Analytics 작업 영역)으로 보내려면 여러 개의 설정을 만듭니다. 각 리소스에는 최대 5개의 진단 설정이 있을 수 있습니다.
Important
설문 조사 데이터를 받아 분석하려면 Azure Monitor에서 진단 설정을 사용하도록 설정하여 설문 조사의 로그 데이터를 Log Analytics 작업 영역이나 Event Hubs 또는 Azure Storage 계정으로 보내야 합니다. 설문 조사 데이터를 이러한 옵션 중 하나로 보내지 않으면 설문 조사 데이터가 저장되지 않고 손실됩니다. 다음은 Communications Services에 대한 로그 및 메트릭 만들기를 시작하기 위해 Azure Monitor 리소스를 구성하기 위한 지침입니다. 모든 Azure 리소스에서 진단 설정 사용에 대한 자세한 설명은 진단 설정에서 로깅 사용을 참조하세요.
참고 항목
진단 설정 이름 아래에서 “통화 설문 조사”를 선택하여 통화 종료 설문 조사에 대한 로그를 사용하도록 설정하세요.
개요
통화 종료 설문 조사 로그의 구현은 Azure Communication Services(Azure Communication Services) 내에서 보강된 기능을 나타내며, Contoso가 설문 조사를 제출하여 통화 환경에 대한 고객의 주관적인 피드백을 수집할 수 있도록 해줍니다. 이 방법은 오디오 및 비디오 비트 전송률, 지터 및 대기 시간과 같은 객관적인 메트릭을 넘어 통화 품질 평가를 보완하는 것을 목표로 하며, 이는 고객이 만족스럽거나 만족스럽지 못한 경험을 가지고 있는지 여부를 완전히 포착하지 못할 수 있습니다. Contoso는 Azure 로그를 활용하여 설문 조사 데이터를 게시하고 검사함으로써 개선이 필요한 영역을 분석하고 식별하기 위한 인사이트를 얻습니다. 이러한 설문 조사 결과는 Azure Communication Services가 품질과 안정성을 지속적으로 모니터링하고 향상시키는 데 유효한 리소스 역할을 합니다. 통화 종료 설문 조사에 대한 자세한 내용
통화 종료 설문 조사는 최종 사용자가 JavaScript/웹 SDK 통화 솔루션의 품질과 안정성을 인식하는 방법에 대한 인사이트를 수집할 수 있는 유용한 도구입니다. 함께 제공되는 로그에는 다음을 포함하여 최종 사용자의 환경을 평가하는 데 도움이 되는 중요한 데이터가 포함되어 있습니다.
전체 통화: 응답은 통화 참가자가 전반적인 통화 품질을 어떻게 받아들이는지 나타냅니다.
- 오디오: 응답은 사용자가 오디오 문제를 인식했는지 여부를 나타냅니다.
- 비디오: 응답은 사용자가 비디오 문제를 인식했는지 여부를 나타냅니다.
- 화면 공유: 응답은 사용자가 화면 공유 문제를 인식했는지 여부를 나타냅니다. 위의 태그 외에도 응답의 선택적 태그는 오디오, 비디오 또는 화면 공유와 관련된 특정 유형의 문제에 대한 추가 인사이트를 제공합니다.
통화 종료 설문 조사 로그에 캡처된 데이터를 분석해 개선이 필요한 영역을 정확히 파악하여 전반적인 사용자 환경을 향상시킬 수 있습니다.
리소스 로그 범주
Communication Services는 사용할 수 있는 다음 유형의 로그를 제공합니다.
- 통화 종료 설문 조사 로그 - 통화 종료 시 설문 조사와 관련된 기본 정보를 제공합니다.
속성
| Property | 설명 |
|---|---|
Timegenerated |
이 필드는 로그가 생성된 시점의 타임스탬프(UTC)를 나타냅니다. |
CorrelationId |
상관 관계 이벤트의 ID를 사용하여 여러 테이블 간의 상관 관계가 있는 이벤트를 식별할 수 있습니다. |
Category |
이벤트의 로그 범주입니다. 로그 범주 및 리소스 종류가 동일한 로그에는 동일한 속성 필드가 있습니다. |
ResourceId |
사용자 리소스의 전체 길이 식별자입니다. |
OperationName |
로그 레코드와 연결된 작업 |
OperationVersion |
API 버전은 API를 사용하여 operationName이 수행된 경우 작업 또는 작업 버전과 연결됩니다. |
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
}
}
]