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
+13-13Lines changed: 13 additions & 13 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -36,9 +36,9 @@ We recommend using Copilot in the **Voice and Video Insights** dashboards to sta
36
36
any quality investigations, and use Copilot in [Call Diagnostics](../../voice-video-calling/call-diagnostics.md) as needed to explore individual calls when you need granular detail.
37
37
38
38
**Voice and Video Insights** consists of four main sections.
39
-
-**[Volume](#volume):** Provides general statistics.
40
-
-**[Reliability](#reliability):** Aggregates all API functionality and error codes to focus your analysis.
41
-
-**[User Facing Diagnostics (UFD)](#user-facing-diagnostics-ufd):**Highlights trends that can impact users call experiences.
39
+
-**[Volume](#volume):** Provides general usage numbers.
40
+
-**[Reliability](#reliability):** Aggregates all API functionality and error codes.
41
+
-**[User Facing Diagnostics (UFD)](#user-facing-diagnostics-ufd):**Summarizes events that can affect user call experiences.
42
42
-**[Quality](#quality):** Provides key media stream measurements.
43
43
44
44
@@ -76,24 +76,24 @@ The **Volume** tab contains a **Grouping** parameter, which helps visualize the
76
76
:::image type="content" source="..\media\workbooks\voice-and-video-volume-grouping.png" alt-text="Screenshot of voice and video volume grouping."::: -->
77
77
78
78
## Reliability
79
-
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. You need to select a single API scenario to focus on then the dashboard visuals will change and show you a detailed breakdown of that API. You can then ask Copilot for help understanding individual error codes and possible solutions to improve performance.
79
+
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.
80
80
81
81
## User Facing Diagnostics (UFD)
82
82
83
-
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’ll see an overview of all the UFDs first. Then you can interact with Copilot and select an individual UFD for further drill-down insights.
83
+
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. Then you can interact with Copilot and select an individual UFD for further drill-down insights.
84
84
85
-
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 will try to re-attempt or mitigate some in call events, finding the poorest performing areas can help identify root causes.
85
+
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.
86
86
87
87
### How do you interpret UFDs?
88
88
89
-
During calls, the calling SDK may trigger events called User Facing Diagnostics (UFDs), these UFD events can indicate a user had 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 broader quantitative criteria, there can be various root causes that trigger a UFD event. Additionally, a UFD can be triggered but the user may not have perceived an issue during a call. In contrast the reliability tab attempts to provide more concrete error code and subcode information for your analysis.
89
+
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.
90
90
91
91
92
92
## Quality
93
93
94
94
The **Quality** tab under **Voice and video** allows users to inspect the quality distribution of calls, where quality is defined at three levels for this dashboard:
95
95
96
-
- The proportion of poor-quality media streams (**Stream quality** plot), where a stream’s quality is classified as Poor when it has at least one unhealthy telemetry value, where unhealthy ranges are defined as:
96
+
- The proportion of poor-quality media streams (**Stream quality** plot), where a stream’s quality is classified as Poor when it has at least one unhealthy value, unhealthy ranges are defined as:
97
97
- Jitter > 30 milliseconds
98
98
- Packet loss rate > 10%
99
99
- Round trip time > 500 milliseconds
@@ -104,11 +104,11 @@ The **Quality** tab under **Voice and video** allows users to inspect the qualit
104
104
105
105
<!-- :::image type="content" source="..\media\workbooks\voice-and-video-quality.png" alt-text="Screenshot of voice and video quality."::: -->
106
106
107
-
Quality can also be filtered by the types of media streams (**Media Type** parameter) used in the call, e.g. to only get the impacted calls in terms of video stream quality:
107
+
Quality can also be filtered by the types of media streams (**Media Type** parameter) used in the call, for example, to only get the impacted calls in terms of video stream quality:
108
108
109
109
<!-- :::image type="content" source="..\media\workbooks\voice-and-video-quality-params.png" alt-text="Screenshot voice and video quality media type parameter."::: -->
110
110
111
-
And can also be filtered by endpoint types (**Endpoint Type** parameter), e.g. getting the participant end reasons for PSTN participants. These filters allow for multiple selections:
111
+
And can also be filtered by endpoint types (**Endpoint Type** parameter), for example, getting the participant end reasons for PSTN participants. These filters allow for multiple selections:
112
112
113
113
<!-- :::image type="content" source="..\media\workbooks\voice-and-video-params-2.png" alt-text="Screenshot voice and video quality endpoint type parameter."::: -->
114
114
@@ -132,19 +132,19 @@ For an in-depth description of workbooks, refer to the [Azure Monitor Workbooks]
132
132
## Frequently asked questions
133
133
134
134
### How do I set up Voice and Video Insights?
135
-
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 and confirm you've enabled[Copilot in Azure](/azure/copilot/overview). The following sections explain these two requirements.
135
+
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.
136
136
137
137
#### Collect Call Logs
138
138
139
-
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 sends call data to a Log Analytics workspace in the same resource group as your calling resource.
139
+
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 sends call data to a Log Analytics workspace in the same resource group as your calling resource.
140
140
141
141
Data isn’t stored retroactively, so you begin capturing call logs only after configuring the diagnostic setting.
142
142
143
143
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**.
144
144
145
145
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).
146
146
147
-
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.
147
+
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.
148
148
149
149
#### Enable Copilot in Azure
150
150
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.
0 commit comments