Update voice-and-video-insights.md

Author: amagginetti

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

@@ -14,10 +14,29 @@ ms.subservice: data
 
 # Voice and video Insights
 
-Azure Communication Services (ACS) integrates [Copilot in Azure)](../../../copilot/overview.md) with your call quality analytics and visualizations in the **Voice and Video Insights** blade. You will find the **Insights** blade in the monitoring section of your of your ACS resource when you are in your Azure Portal. You can interact with Copilot to quickly understand the high level summary of the calling health of your ACS calling resource and learn how to improve the call quality for your call participants. We recommend using the **Voice and Video Insights** sections described in this article first to understand and improve your overall call quality, and as needed, use Call Diagnostics to troubleshoot individual calls in granular detail. 
+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. 
 
 ## Overview
-The **Insights** blade is run with  powered by [Azure Monitor Workbooks](/azure/azure-monitor/visualize/workbooks-overview) so you can modify and save edits to the template we provided to better suite your needs. By editing the workbook you can also explore the logic behind each visual. 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). 
+In each Communications Resource, we've provided an Insights feature that 
+acts as a dashboard for all your calls in that resource. The Voice and Video 
+section of the dashboard gives high level summaries of your call usage, 
+reliability, and quality for that calling resource. Since the dashboard 
+is integrated with [Copilot in Azure](../../../copilot/overview.md) you 
+can chat with Copilot to quickly understand  better understand what you are looking at and 
+what actions you can take to improve users call experiences. 
+
+Insert example prompts and images:
+1
+2
+3
+
+There are two main tools you can use to monitor your calls and improve call quality. 
+1. Voice and Video Insights dashboards
+1. [Call Diagnostics](../../voice-video-calling/call-diagnostics.md)
+
+We recommend using Copilot in the **Voice and Video Insights** dashboards to start 
+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. 
 
 **Voice and Video Insights** consists of four main sections. 
 - **Volume:** Provides general statistics
@@ -27,28 +46,30 @@ The **Insights** blade is run with  powered by [Azure Monitor Workbooks](/azure/
 
 :::image type="content" source="..\media\workbooks\insights-overview-2.png" alt-text="Screenshot of Communication Services Insights dashboard.":::
 
-## How to enable Voice and Video Insights
+## Enable Voice and Video Insights
 
-### Collect Call Logs
-Azure Communication Services generates call logs that you can capture. For Voice and Video Insights to show anything, you must enable a diagnostic setting in Azure Monitor to store these call logs for each calling resource that you want to monitor. Azure Monitor will start sending this data to a Log Analytics workspace for Voice and Video Insights to view.
+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. 
 
-Follow instructions to add diagnostic settings for your resource in [Enable logs via Diagnostic Settings in Azure Monitor](../analytics/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](../analytics/enable-logging.md#adding-a-diagnostic-setting). To collect all logs, select **allLogs**.
+### Collect Call Logs
 
-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).
+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.
 
-If you have multiple Azure Communications Services resource IDs, you must enable these settings for each resource ID and query call details for participants within their respective resource IDs.
 
 > [!IMPORTANT]
-> Voice and Video Insights only works if there's data that's sent to a Log Analytics workspace. Diagnostic settings begin collecting data for a single Azure Communications Services resource ID after you enable the diagnostic setting. Keep in mind data collection is not retroactive. 
+>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)
+>
+>
+> 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.
+
 
 ### Enable Copilot in Azure
-Your organization manages access to [Microsoft Copilot in Azure (preview)](../../../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.
+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.
 
-Interact with Copilot in Azure for quality improvement guidance and explanations of common terms. Giving Copilot in Azure detailed information will help it enhance analysis, identify problems, and identify fixes.
+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.
 
-## Accessing Insights
+## Accessing Voice and Video Insights
 
-Inside your Azure Communication Services resource, scroll down on the left nav bar to the **Monitor** category and click on the **Insights** tab:
+Inside your Azure Communication Services resource, scroll down on the left navigation bar to the **Monitor** category and click on the **Insights** tab:
 
 :::image type="content" source="..\media\workbooks\acs-insights-nav.png" alt-text="Screenshot of the Insights navigation blade.":::
 
@@ -92,24 +113,6 @@ And can also be filtered by endpoint types (**Endpoint Type** parameter), e.g. g
 
 :::image type="content" source="..\media\workbooks\voice-and-video-params-2.png" alt-text="Screenshot voice and video quality endpoint type parameter.":::
 
-The **Details** tab offers a quick way to navigate through the **Voice and video** calls made in a time range by grouping calls by dates, and showing the details of every call made in terms of the participants in that call and the outgoing streams per participant, together with duration and telemetry values for these:
-
-:::image type="content" source="..\media\workbooks\voice-and-video-details.png" alt-text="Screenshot of voice and video details.":::
-
-The details of a call are initially hidden. A list of the participants is displayed after clicking on a call:
-
-:::image type="content" source="..\media\workbooks\voice-and-video-details-participants.png" alt-text="Screenshot of voice and video participant details.":::
-
-And clicking on a participant displays a list of the outgoing streams for that participant, together with their duration (proportional to the full call duration) and telemetry values, where unhealthy values are displayed in red:
-
-:::image type="content" source="..\media\workbooks\voice-and-video-details-streams.png" alt-text="Screenshot of voice and video stream details.":::
-
-## Authentication insights
-
-The **Authentication** tab shows authentication logs, which are created through operations such as issuing an access token or creating an identity. The data displayed includes the types of operations performed and the results of those operations:
-
-:::image type="content" source="..\media\workbooks\auth.png" alt-text="Screenshot of the authentication overview.":::
-
 ## More information about workbooks
 
 For an in-depth description of workbooks, refer to the [Azure Monitor Workbooks](/azure/azure-monitor/visualize/workbooks-overview) documentation.
@@ -127,6 +130,16 @@ Editing these dashboards doesn't modify the **Insights** tab, but rather creates
 For an in-depth description of workbooks, refer to the [Azure Monitor Workbooks](/azure/azure-monitor/visualize/workbooks-overview) documentation.
 
 
+## Frequently asked questions
+
+### How do I setup Voice and Video Insights?
+
+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**.
+
+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).
+
+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. 
+
 ## Next steps
 
 - Learn about Call Diagnostics: [Call Diagnostics](../../voice-video-calling/call-diagnostics.md)
@@ -135,4 +148,27 @@ For an in-depth description of workbooks, refer to the [Azure Monitor Workbooks]
 - Learn about other quality best practices: [Best practices: Azure Communication Services calling SDKs](../best-practices.md).
 - Learn how to use the Log Analytics workspace: [Log Analytics tutorial](/azure/azure-monitor/logs/log-analytics-tutorial).
 - Create your own queries in Log Analytics: [Get started with log queries in Azure Monitor](/azure/azure-monitor/logs/get-started-queries).
-- Explore known call issues: [Known issues in the SDKs and APIs](../known-issues.md).
+- Explore known call issues: [Known issues in the SDKs and APIs](../known-issues.md).
+- 
+- 
+- 
+- 
+- NOTES
+- 
+- The **Insights Dashboard** is powered by 
+[Azure Monitor Workbooks](/azure/azure-monitor/visualize/workbooks-overview) 
+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). 
+
+
+Azure Communication Services (ACS) integrates [Copilot in Azure](../../../copilot/overview.md) 
+with your call quality analytics and visualizations in the **Voice and Video Insights** dashboard. 
+You will find the **Insights** dashboard in the monitoring section of your of your ACS resource when you 
+are in your Azure Portal. You can interact with Copilot to quickly understand the high level 
+summary of the calling health of your ACS calling resource and learn how to improve the call 
+quality for your call participants. 
+
+
+In order to take advantage of Workbooks, follow the instructions outlined 
+in [Enable Azure Monitor in Diagnostic Settings](../enable-logging.md). 
+To enable Workbooks, you need to send your logs to a 
+[Log Analytics workspace](/azure/azure-monitor/logs/log-analytics-overview) destination.