Skip to content

Commit 30b0913

Browse files
committed
Update voice-and-video-insights.md
1 parent 4c1d413 commit 30b0913

File tree

1 file changed

+16
-18
lines changed

1 file changed

+16
-18
lines changed

articles/communication-services/concepts/analytics/insights/voice-and-video-insights.md

Lines changed: 16 additions & 18 deletions
Original file line numberDiff line numberDiff line change
@@ -17,13 +17,11 @@ ms.subservice: data
1717
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.
1818

1919
## Overview
20-
In each Communications Resource, we've provided an Insights feature that
20+
In each Communications Resource, we provide an Insights feature that
2121
acts as a dashboard for all your calls in that resource. The Voice and Video
2222
section of the dashboard gives high level summaries of your call usage,
23-
reliability, and quality for that calling resource. Since the dashboard
24-
is integrated with [Copilot in Azure](/azure/copilot/overview) you
25-
can chat with Copilot to quickly understand better understand what you are looking at and
26-
what actions you can take to improve users call experiences.
23+
reliability, and quality for that calling resource. This dashboard
24+
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.
2725

2826
<!-- Insert example prompts and images:
2927
1
@@ -38,24 +36,24 @@ We recommend using Copilot in the **Voice and Video Insights** dashboards to sta
3836
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.
3937

4038
**Voice and Video Insights** consists of four main sections.
41-
- **Volume:** Provides general statistics.
42-
- **Reliability:** Aggregates all API functionality and error codes to focus your analysis.
43-
- **User Facing Diagnostics (UFD):** Highlights trends that can impact users call experince.
44-
- **Quality:** Provides key media stream measurements.
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.
42+
- **[Quality](#quality):** Provides key media stream measurements.
4543

4644

4745
## Enable Voice and Video Insights
4846

49-
You need to start storing call logs and confirm you've enabled [Copilot in Azure](/azure/copilot/overview) to start using the Voice and Video Insights dashboards.
47+
You need to start storing call logs and enable [Copilot in Azure](/azure/copilot/overview) to start using the Voice and Video Insights dashboards.
5048

5149
> [!IMPORTANT]
5250
>You must collect logs to use the dashboard. To enable Voice and Video Insights see: [**How do I setup Voice and Video Insights?**](#how-do-i-setup-voice-and-video-insights)
5351
5452
## Accessing Voice and Video Insights
5553

56-
Inside your Azure Communication Services resource, scroll down on the left navigation bar to the **Monitor** category and click on the **Insights** tab:
54+
Inside your Azure Communication Services resource, scroll down on the left navigation bar to the **Monitor** category and select the **Insights** tab:
5755

58-
:::image type="content" source="..\media\workbooks\acs-insights-nav.png" alt-text="Screenshot of the Insights navigation blade.":::
56+
:::image type="content" source="..\media\workbooks\acs-insights-nav.png" alt-text="Screenshot of the Insights navigation icon.":::
5957

6058

6159
## Volume
@@ -78,13 +76,13 @@ The **Volume** tab contains a **Grouping** parameter, which helps visualize the
7876
:::image type="content" source="..\media\workbooks\voice-and-video-volume-grouping.png" alt-text="Screenshot of voice and video volume grouping."::: -->
7977

8078
## Reliability
81-
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 and the visuals will update 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. 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.
8280

8381
## User Facing Diagnostics (UFD)
8482

85-
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’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.
8684

87-
We recommend prioritizing improvements on a UFD that has a low recovery rate and a high volume, which indicates the issue causes the biggest impact to 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 will try to re-attempt or mitigate some in call events, finding the poorest performing areas can help identify root causes.
8886

8987
### How do you interpret UFDs?
9088

@@ -133,7 +131,7 @@ For an in-depth description of workbooks, refer to the [Azure Monitor Workbooks]
133131

134132
## Frequently asked questions
135133

136-
### How do I setup Voice and Video Insights?
134+
### How do I set up Voice and Video Insights?
137135
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.
138136

139137
#### Collect Call Logs
@@ -146,12 +144,12 @@ Follow instructions to add diagnostic settings for your resource in [Enable logs
146144

147145
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).
148146

149-
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 are 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.
150148

151149
#### Enable Copilot in Azure
152150
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.
153151

154-
Interact with Copilot in Azure for quality improvement guidance and explanations of common terms. Giving Copilot in Azure detailed information will help it identify fixes. If you want you can use the visuals without Copilot in a limited capacity.
152+
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.
155153

156154
## Next steps
157155

0 commit comments

Comments
 (0)