Skip to content

Commit faa0e7e

Browse files
committed
Update voice-and-video-insights.md
1 parent 6f99c47 commit faa0e7e

File tree

1 file changed

+19
-22
lines changed

1 file changed

+19
-22
lines changed

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

Lines changed: 19 additions & 22 deletions
Original file line numberDiff line numberDiff line change
@@ -21,7 +21,7 @@ In each Communications Resource, we've provided 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,
2323
reliability, and quality for that calling resource. Since the dashboard
24-
is integrated with [Copilot in Azure](../../../copilot/overview.md) you
24+
is integrated with [Copilot in Azure](/azure/copilot/overview) you
2525
can chat with Copilot to quickly understand better understand what you are looking at and
2626
what actions you can take to improve users call experiences.
2727

@@ -35,8 +35,7 @@ There are two main tools you can use to monitor your calls and improve call qual
3535
1. [Call Diagnostics](../../voice-video-calling/call-diagnostics.md)
3636

3737
We recommend using Copilot in the **Voice and Video Insights** dashboards to start
38-
any quality investigations, and use Copilot in [Call Diagnostics](../../voice-video-calling/call-diagnostics.md)
39-
as needed to explore individual calls when you need granular detail.
38+
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.
4039

4140
**Voice and Video Insights** consists of four main sections.
4241
- **Volume:** Provides general statistics.
@@ -47,24 +46,10 @@ as needed to explore individual calls when you need granular detail.
4746

4847
## Enable Voice and Video Insights
4948

50-
You need to start storing call data and confirm you've enabled [Copilot in Azure](../../../copilot/overview.md) to start using the Voice and Video Insights dashboards.
51-
52-
### Collect Call Logs
53-
54-
The Insights Dashboards are powered by [Azure Monitor Workbooks](../../../../../azure/azure-monitor/visualize/workbooks-overview.md) which rely on data stored in your Azure account. Azure Communication Services generates call data in the form of metrics and events as you make calls. You must store these data in a Log Analytics workspace that is in the same resource group as your calling resource in order for any of the Insights Dashboard visuals to work. To store these data, you must enable a diagnostic setting in Azure Monitor that directs these call data to be stored in a Log Analytics workspace as they're created. These call data aren't retroactively available from Azure Communication Services, but once you set up your diagnostic setting you control the data retention periods for your Log Analytics resource.
55-
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.
5650

5751
> [!IMPORTANT]
58-
>To enable Call Diagnostics in your calling resource see: [How do I setup Voice and Video Insights?](#how-do-i-setup-voice-and-video-insights)
59-
>
60-
>
61-
> You need to start collecting the log data for Call Diagnostics to visualize. Call Diagnostics can only query data sent to a Log Analytics workspace that is located in the same resource group as your calling resource. Keep in mind, call data isn't stored anywhere until you set up a Diagnostic Setting to store it in a Log Analytics workspace. You need to enable a Diagonstic Setting for each Azure Communications Services resource ID you want to monitor.
62-
63-
64-
### Enable Copilot in Azure
65-
Your organization manages access to [Copilot in Azure](../../../copilot/overview.md). After your organization has access to Copilot in Azure, the Voice and Video Insights sections will display multiple Copilot icons you can interact with.
66-
67-
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.
52+
>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)
6853
6954
## Accessing Voice and Video Insights
7055

@@ -75,7 +60,7 @@ Inside your Azure Communication Services resource, scroll down on the left navig
7560

7661
## Voice and Video Insights
7762

78-
Since **Voice and video** logs are the most complex in nature, this modality is broken down into four subsections:
63+
Since **Voice and video** logs are complex, this modality is broken down into four subsections:
7964

8065
:::image type="content" source="..\media\workbooks\voice-and-video-nav.png" alt-text="Screenshot of voice and video navigation.":::
8166

@@ -132,13 +117,25 @@ For an in-depth description of workbooks, refer to the [Azure Monitor Workbooks]
132117
## Frequently asked questions
133118

134119
### How do I setup Voice and Video Insights?
120+
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.
121+
122+
#### Collect Call Logs
123+
124+
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.
125+
126+
Data isn’t stored retroactively, so you begin capturing call logs only after configuring the diagnostic setting.
135127

136128
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**.
137129

138130
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).
139131

140132
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.
141133

134+
#### Enable Copilot in Azure
135+
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.
136+
137+
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.
138+
142139
## Next steps
143140

144141
- Learn about Call Diagnostics: [Call Diagnostics](../../voice-video-calling/call-diagnostics.md)
@@ -159,7 +156,7 @@ If you have multiple Azure Communications Services resource IDs, you must enable
159156
so you can modify and save edits to the template we provided to better suite your needs. To learn more see, [build workbook reports on top of your data](/azure/azure-monitor/logs/data-platform-logs#built-in-insights-and-custom-dashboards-workbooks-and-reports).
160157

161158

162-
Azure Communication Services (ACS) integrates [Copilot in Azure](../../../copilot/overview.md)
159+
Azure Communication Services (ACS) integrates [Copilot in Azure](/azure/copilot/overview)
163160
with your call quality analytics and visualizations in the **Voice and Video Insights** dashboard.
164161
You will find the **Insights** dashboard in the monitoring section of your of your ACS resource when you
165162
are in your Azure Portal. You can interact with Copilot to quickly understand the high level
@@ -180,7 +177,7 @@ The **Insights Dashboard** is run with powered by
180177
so you can modify and save edits to the template we provided to better suite your needs. To learn more see, [build workbook reports on top of your data](/azure/azure-monitor/logs/data-platform-logs#built-in-insights-and-custom-dashboards-workbooks-and-reports).
181178

182179

183-
Azure Communication Services (ACS) integrates [Copilot in Azure](../../../copilot/overview.md)
180+
Azure Communication Services (ACS) integrates [Copilot in Azure](/azure/copilot/overview)
184181
with your call quality analytics and visualizations in the **Voice and Video Insights** blade.
185182
You will find the **Insights** blade in the monitoring section of your of your ACS resource when you
186183
are in your Azure Portal. You can interact with Copilot to quickly understand the high level

0 commit comments

Comments
 (0)