You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: articles/communication-services/concepts/analytics/insights/voice-and-video-insights.md
+32-23Lines changed: 32 additions & 23 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -14,18 +14,16 @@ ms.subservice: data
14
14
15
15
# Voice and video Insights
16
16
17
-
This document introduces the Voice and Video section of your Insights dashboard.
18
-
19
-
<!-- and how to use Copilot in Azure to monitor and improve your call quality. -->
17
+
This document introduces the Voice and Video section of your Insights dashboard and how to use Copilot in Azure to monitor and improve your call quality.
20
18
21
19
## Overview
22
20
In each Communications Resource, we provide an Insights feature that
23
21
acts as a dashboard for all your calls in that resource. The Voice and Video
24
22
section of the dashboard gives high level summaries of your call usage,
25
23
reliability, and quality for that calling resource.
26
24
27
-
<!--This dashboard
28
-
is integrated with [Copilot in Azure](/azure/copilot/overview), allowing you to chat with Copilot to quickly understand the data you’re looking at and learn actions to improve your users' calling experiences.-->
25
+
This dashboard
26
+
is integrated with [Copilot in Azure](/azure/copilot/overview), allowing you to chat with Copilot to quickly understand the data you’re looking at and learn actions to improve your users' calling experiences.
29
27
30
28
<!-- Insert example prompts and images:
31
29
1
@@ -36,24 +34,19 @@ There are two main tools you can use to monitor your calls and improve call qual
We recommend using the **Voice and Video Insights** dashboards to start
40
-
any quality investigations, and using [Call Diagnostics](../../voice-video-calling/call-diagnostics.md) as needed to explore individual calls when you need granular detail.
41
-
42
-
<!-- We recommend using Copilot in the **Voice and Video Insights** dashboards to start
37
+
We recommend using Copilot in the **Voice and Video Insights** dashboards to start
43
38
any quality investigations, and using Copilot in [Call Diagnostics](../../voice-video-calling/call-diagnostics.md) as needed to explore individual calls when you need granular detail.
44
39
45
40
**Voice and Video Insights** consists of four main sections.
46
41
-**[Volume](#volume):** Provides general usage numbers.
47
42
-**[Reliability](#reliability):** Aggregates key calling API scenarios and error codes.
48
43
-**[User Facing Diagnostics (UFD)](#user-facing-diagnostics-ufd):** Summarizes events that can affect user call experiences.
49
-
- **[Quality](#quality):** Provides key media stream measurements.-->
44
+
-**[Quality](#quality):** Provides key media stream measurements.
50
45
51
46
52
47
## Enable Voice and Video Insights
53
48
54
-
You need to start storing call logs to start using the Voice and Video Insights dashboards.
55
-
56
-
<!-- You need to start storing call logs and enable [Copilot in Azure](/azure/copilot/overview) to start using the Voice and Video Insights dashboards. -->
49
+
You need to start storing call logs and enable [Copilot in Azure](/azure/copilot/overview) to start using the Voice and Video Insights dashboards.
57
50
58
51
59
52
> [!IMPORTANT]
@@ -72,9 +65,7 @@ Inside your Azure Communication Services resource, scroll down on the left navig
72
65
73
66
<!-- :::image type="content" source="..\media\workbooks\voice-and-video-nav.png" alt-text="Screenshot of voice and video navigation."::: -->
74
67
75
-
The **Volume** tab plots key usage metrics, such as call and participant volume, you can use the filters to focus your reviews and time frames.
76
-
77
-
<!-- You can use Copilot to get detailed explanations of key concepts at the bottom of this section. -->
68
+
The **Volume** tab plots key usage metrics, such as call and participant volume, you can use the filters to focus your reviews and time frames. You can use Copilot to get detailed explanations of key concepts at the bottom of this section.
78
69
79
70
This tab focuses on the composition and volume of your calls over time. You can see average call duration in a period or focus on top users by average call duration. We provide more information with breakdowns by SDK version, Teams interoperability, participant types, call type, endpoint type, and OS version.
80
71
@@ -89,6 +80,21 @@ The **Volume** tab contains a **Grouping** parameter, which helps visualize the
89
80
90
81
:::image type="content" source="..\media\workbooks\voice-and-video-volume-grouping.png" alt-text="Screenshot of voice and video volume grouping."::: -->
91
82
83
+
## Reliability
84
+
The **Reliability** tab summarizes the performance of key calling SDK APIs to help you focus on the lowest performing areas. The default view shows a trend of all the APIs to give you an overview of your reliability. You can get more details by selecting a single API scenario to focus on. When you choose a single API scenario the dashboard visuals update to show a detailed breakdown of that API.
85
+
86
+
<!-- The **Reliability** tab summarizes the performance of key calling SDK APIs to help you focus on the lowest performing areas. The default view shows a trend of all the APIs to give you an overview of your reliability. You can get more details by selecting a single API scenario to focus on. When you choose a single API scenario the dashboard visuals update to show a detailed breakdown of that API and highlight where you can chat with Copilot to learn about individual error codes and possible solutions to improve performance. -->
87
+
88
+
## User Facing Diagnostics (UFD)
89
+
90
+
The User Facing Diagnostic (UFD) tab opens with a summary of the top UFD events and highlights the recovery rate of each UFD for you to focus on. Like the Reliability tab, you see an overview of all the UFDs first, once you select an individual UFD you see further drill-down insights.
91
+
92
+
We recommend prioritizing improvements on a UFD that has a low recovery rate and a high volume, which can indicate the best opportunity to improve your user's call experiences. For example, the calling SDK might recover from some in call events and the user might not perceive an issue. By focusing on the poorest performing areas you can help identify root causes.
93
+
94
+
### How do you interpret UFDs?
95
+
96
+
During calls, the calling SDK might trigger events called User Facing Diagnostics (UFDs), these UFD events indicate a user may have perceived a poor call experience for various reasons. For example, their video freezes and their network quality drops in the middle of a call. Since UFDs are symptomatic by nature and are triggered based on broad quantitative criteria, there can be various root causes that trigger a UFD event. Additionally, a UFD can be triggered but the user might not perceive an issue during a call because the calling SDK was able to mitigate any potential issue. In contrast, the reliability tab attempts to provide more concrete error code and subcode information for your analysis.
97
+
92
98
<!-- ## Reliability
93
99
The **Reliability** tab summarizes the performance of key calling SDK APIs to help you focus on the lowest performing areas. The default view shows a trend of all the APIs to give you an overview of your reliability. You can get more details by selecting a single API scenario to focus on. When you choose a single API scenario the dashboard visuals update to show a detailed breakdown of that API and highlight where you can chat with Copilot to learn about individual error codes and possible solutions to improve performance.
94
100
@@ -114,7 +120,7 @@ The **Quality** tab under **Voice and video** allows users to inspect the qualit
114
120
115
121
- The proportion of **Impacted calls**, where an impacted call is defined as a call that has at least one poor quality stream
116
122
117
-
-**Participant end reasons**, which keep track of the reason why a participant left a call. End reasons are [SIP codes](https://en.wikipedia.org/wiki/List_of_SIP_response_codes), which are numeric codes that describe the specific status of a signaling request. SIP codes can be grouped into six categories: *Success*, *Client Failure*, *Server Failure*, *Global Failure*, *Redirection*, and *Provisional*. The distribution of SIP code categories is shown in the pie chart on the left hand side, while a list of the specific SIP codes for participant end reasons is provided on the right hand side
123
+
-**Participant end reasons**, which keep track of the reason why a participant left a call. End reasons are documented in our [Call Codes](https://en.wikipedia.org/wiki/List_of_SIP_response_codes) documentation, which are numeric codes that describe the specific status of an operation. Call Codes can be grouped into six categories: *Success*, *Client Failure*, *Server Failure*, *Global Failure*, *Redirection*, and *Provisional*. The distribution of Call Codes is shown in the pie chart on the left hand side, while a list of the specific codes for participant end reasons is provided on the right hand side.
118
124
119
125
<!-- :::image type="content" source="..\media\workbooks\voice-and-video-quality.png" alt-text="Screenshot of voice and video quality."::: -->
120
126
@@ -146,26 +152,29 @@ For an in-depth description of workbooks, refer to the [Azure Monitor Workbooks]
146
152
## Frequently asked questions
147
153
148
154
### How do I set up Voice and Video Insights?
149
-
Since the Voice and Video insights dashboard is powered by [Azure Monitor Workbooks](/azure/azure-monitor/visualize/workbooks-overview), you need to store call logs for it to visualize anything. The following section explains this requirement.
150
-
151
-
<!-- Since the Voice and Video insights dashboard is integrated with [Copilot in Azure](/azure/copilot/overview) and powered by [Azure Monitor Workbooks](/azure/azure-monitor/visualize/workbooks-overview), you need to store call logs for it to visualize anything. Also you must enable [Copilot in Azure](/azure/copilot/overview). The following sections explain these two requirements. -->
155
+
Since the Voice and Video insights dashboard is integrated with [Copilot in Azure](/azure/copilot/overview) and powered by [Azure Monitor Workbooks](/azure/azure-monitor/visualize/workbooks-overview), you need to store call logs for it to visualize anything. Also you must enable [Copilot in Azure](/azure/copilot/overview). The following sections explain these two requirements.
152
156
153
157
#### Collect Call Logs
154
158
155
159
The Insights Dashboards uses [Azure Monitor Workbooks](/azure/azure-monitor/visualize/workbooks-overview) which displays call log data from Azure Communication Services. These call logs aren't stored in your Azure account by default so you need to begin storing them for the dashboard to work. To collect these call logs, you need to enable a diagnostic setting that directs the call data to a Log Analytics workspace.
156
160
157
161
**Data isn’t stored retroactively, so you begin capturing call logs only after configuring the diagnostic setting.**
158
162
159
-
Follow instructions to add diagnostic settings for your resource in [Enable logs via Diagnostic Settings in Azure Monitor](../enable-logging.md). We recommend that you initially collect all logs. After you understand the capabilities in Azure Monitor, determine which logs you want to retain and for how long. When you add your diagnostic setting, you're prompted to [select logs](../enable-logging.md#adding-a-diagnostic-setting). To collect **all logs**, select **allLogs**.
163
+
Follow instructions to add diagnostic settings for your resource in [Enable logs via Diagnostic Settings in Azure Monitor](../enable-logging.md). We recommend that you initially collect all logs. When you add your diagnostic setting, you're prompted to [select logs](../enable-logging.md#adding-a-diagnostic-setting). To collect **all logs**, select **allLogs**.
160
164
161
165
Your data volume, retention, and usage in Log Analytics within Azure Monitor is billed through existing Azure data meters. We recommend that you monitor your data usage and retention policies for cost considerations as needed. For more information, see [Controlling costs](/azure/azure-monitor/essentials/diagnostic-settings#controlling-costs).
162
166
163
167
If you have multiple Azure Communications Services resource IDs, you must enable these settings for each resource ID. When you view Voice and Video Insights, it shows you details for the resourceID you're viewing.
164
168
165
-
<!--#### Enable Copilot in Azure
169
+
#### Enable Copilot in Azure
166
170
Your organization manages access to [Copilot in Azure](/azure/copilot/overview). After your organization has access to Copilot in Azure, the Voice and Video Insights sections will display multiple Copilot icons you can interact with.
167
171
168
-
Interact with Copilot in Azure for quality improvement guidance and explanations of common terms. Giving Copilot in Azure detailed information helps it identify fixes. If you want, you can use the visuals without Copilot in a limited capacity. -->
172
+
Interact with Copilot in Azure for quality improvement guidance and explanations of common terms. Giving Copilot in Azure detailed information helps it identify fixes. If you want, you can use the visuals without Copilot in a limited capacity.
173
+
174
+
### Can I use the legacy version of Voice and Video Insights?
175
+
You can find the legacy version of Voice and Video Insights inside your Azure Communication Services resource tab:
176
+
177
+
:::image type="content" source="..\media\workbooks\workbooks-tab.png" alt-text="Screenshot of the workbooks tab.":::
0 commit comments