.. _insights-reference-dashboards:

Insights Reference Dashboards 
------------------------------

.. _SP66|New dashboards for VOSS Automate MSgraph, MSteams, and Spark.:
.. _SP66|New dashboards for Webex API data.:
.. _SP25|Support added to probe Polycom phones API (Requires Dashboard SP66 Release for visualization).:
.. _22.1|EKB-12137:
.. _22.1|EKB-11561:
.. _22.1|EKB-11623:
.. _22.1|EKB-12135:
.. _21.3|VOSS-963:
.. _21.3|VOSS-987:
.. _23.1|VOSS-1135:
.. _23.1|EKB-15202:
.. _23.1|VOSS-1055:
.. _23.1|VOSS-1028:
.. _23.2|VOSS-1168:
.. _23.2|VOSS-1145:
.. _23.2|VOSS-1235:
.. _23.3|VOSS-1276|EKB-16989:
.. _24.1|VOSS-1340:
.. _24.2|EKB-22555:
.. _24.2|VOSS-1399:



Overview 
...........

Insights Dashboard ships with a collection of deployment-ready, read-only, standard reference dashboards that are configured 
with predefined policies (alerting dashboards only), probes, and probe groups. This means you'll be able to deploy Insights 
without having to manually add and assign probes to retrieve and display reporting data on these 
dashboards. 

.. image:: /src/images/insights-reference-dashboards.png

.. important:: 

   The Insights reference dashboards described in this topic is the standard set 
   shipped with the latest Insights release. This collection may be updated at each software release.


The Insights reference dashboards are read-only, they can't be edited, deleted, or moved. If you wish to use 
one of the Insights reference dashboards, you'll need to create a copy (clone), then modify the clone to 
create a new, custom dashboard that meets your requirements.

To access the reference dashboards, click the **Menu** icon (hamburger) |main-menu-icon| to 
display the dashboards library pane on the left of the GUI. Expand the tree to locate 
the **Insights Reference** dashboards folder. The dashboards are grouped in category sub-folders - 
at the time of writing, these are: 

* :ref:`insights-ref-dash-alerting`
* :ref:`insights-ref-dash-performance`
* :ref:`insights-ref-dash-diagnostics`
* :ref:`insights-ref-dash-usage`
* :ref:`insights-ref-dash-user`


.. tip:: 

   To view a description of the data displayed in any of the widgets added to the dashboards, click the 
   information icon in the widget header. 

   .. image:: /src/images/insights-ref-dash-information.png






Microsoft Teams Dashboards 
''''''''''''''''''''''''''''''''''

Dashboards displaying Microsoft Teams data obtain data from Microsoft Teams to report on user activity and 
resource usage in your system - for example, data relating to devices, chat, meetings, and calls. 
Data can also be obtained for user licenses and subscribed SKUs, which allows you to determine how 
licenses are being used in your organization so that you can manage license costs.

Call records from Microsoft Teams are pulled into the Arbitrator using Webhooks, and are used for alarms and reporting.




.. rubric:: Related Topics 

* :ref:`custom-dashboards`
*
  .. raw:: latex

     Policy Configuration in the Arbitrator Administration Guide

  .. raw:: html

     <a href="../VAA-arbitrator-correlation/policy-configuration.html">Policy Configuration</a>

*
  .. raw:: latex

     Network Observability in the Arbitrator Administration Guide

  .. raw:: html

     <a href="../VAA-arbitrator-correlation/arb-network-observability.html">Network Observability</a>  




.. _insights-ref-dash-alerting:

Alerting
..........

The Alerting reference dashboards are based on pre-defined policies that ship with the system define when an event coming 
in to the system will trigger an alert. When there's a match for the condition specified in the policy, 
an alert is raised and forwarded to the Dashboard system. 

* All Alerts Overview 

  The All Alerts Overview dashboard provides an overview of all alerts and alarms, such as alerts by 
  severity and alerts over time by customer. 

  .. image:: /src/images/insights-ref-dashboards-all-alerts-overview.png 

* Global Alarm Trend Analysis 

  .. image:: /src/images/insights-ref-dash-global-alarm-trend-analysis.png 

* Microsoft Teams Alerts 

  .. image:: /src/images/insights-ref-dash-ms-teams-alerts.png 


.. _insights-ref-dash-performance:

Performance - Service Monitoring
..................................

Reference dashboards in the **Performance - Service Monitoring** category display performance and service 
statistics for Cisco devices, Microsoft devices, and Insights components (DS9, Dashboard, and Arbitrator). 

.. image:: /src/images/insights-ref-dashboards-performance-service-monitoring.png 


Cisco 
''''''

* CUCM CPU & Memory Utilization 

  .. image:: /src/images/insights-ref-dash-performance-cisco-CUCM-CPU.png 

* Cisco CUCM Combined data 

  .. image:: /src/images/insights-ref-dash-performance-cisco-CUCM-combined-data.png 

* CUCM Service Status 

  .. image:: /src/images/insights-ref-dash-performance-cucm-service-status.png 

* CUCM Counters 

  .. image:: /src/images/insights-ref-dash-performance-cucm-counters.png 

* CUCM Resource Summary 

  .. image:: /src/images/insights-ref-dash-performance-cucm-resource-summary.png 

* UNITY Counters 

  .. image:: /src/images/insights-ref-dash-performance-unity-counters.png 



Microsoft 
''''''''''

* Microsoft Teams Experience Detail

  Reports on service reliability status, call quality, over time, cloud service status, jitter, including audio; 
  packet loss; round trip time
 
  .. image:: /src/images/insights-ref-dash-performance-ms-teams-experience-detail.png 

* Microsoft Managed Issues Detail 

  Reports on service reliability; cloud service status; top active event categories, service events, 
  feature events; incident resolved indicator; Microsoft event list and journal

  .. image:: /src/images/insights-ref-dash-performance-ms-managed-issues-detail.png 

* Microsoft Teams - End User Locations and Service Provider Performance Detail 

  Reports on top locations and service providers by poor audio density and quality, video density and 
  quality; call types; connection types

  .. image:: /src/images/insights-ref-dash-performance-ms-end-user-locations.png 


Insights 
''''''''''

* Insights Components Arbitrator 

  .. image:: /src/images/insights-ref-dash-performance-insights-components-arb.png 

* Insights Components Dashboard 

  .. image:: /src/images/insights-ref-dash-performance-insights-components-dashboard.png 

* Insights Components DS9 

  .. image:: /src/images/insights-ref-dash-performance-insights-components-ds9.png 


.. _insights-ref-dash-diagnostics:

Diagnostics 
...............

Reference dashboards in the **Diagnostics** category display diagnostics for SIP - E1, Cisco call quality, Microsoft 
call statistics, and synthetic transactions. 

.. image:: /src/images/insights-ref-dashboards-diagnostics.png 


Cisco Call Analysis > SIP - E1 
''''''''''''''''''''''''''''''''''

.. rubric:: Cisco UCM SIP Trunk Reports 

* Call Manager SIP Trunk Call Hour Stats

  .. image:: /src/images/insights-ref-dash-call-manager-sip-trunk-call-hour-stats.png 

* Call Manager SIP Trunk Call Success Status

  .. image:: /src/images/insights-ref-dash-call-manager-sip-trunk-call-success-stats.png 

* Call Manager SIP Trunk Utilization (Daily)

  .. image:: /src/images/insights-ref-dash-call-manager-sip-trunk-utilization-daily.png 

* Internal SIP Trunk Utilization (Daily) -BHCC 

  .. image:: /src/images/insights-ref-dash-internal-sip-trunk-utilization-daily-bhcc.png 


.. rubric:: Internal SIP Trunk Utilization

.. image:: /src/images/insights-ref-dash-internal-sip-trunk-utilization.png 


Cisco Call Analysis > Call Analysis All 
''''''''''''''''''''''''''''''''''''''''

.. image:: /src/images/insights-ref-dash-diagnostics-call-analysis-all.png 


Cisco Call Analysis > Cisco Call Detail - Cause Code Analysis 
'''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''

.. image:: /src/images/insights-ref-dash-diag-cisco-call-detail-cause-code-analysis.png 


Cisco Call Analysis > CUCM Route Pattern Analysis 
'''''''''''''''''''''''''''''''''''''''''''''''''''

.. image:: /src/images/insights-ref-dash-diag-cucm-route-patt-analysis.png 


Cisco Call Analysis > SIP Trunk / Gateway Status 
'''''''''''''''''''''''''''''''''''''''''''''''''

.. image:: /src/images/insights-ref-dash-diag-sip-trunk-gateway-status.png


Cisco Call Quality Dashboards 
''''''''''''''''''''''''''''''''

* Call Performance and Voice Quality 

  .. image:: /src/images/insights-ref-dash-call-performance-and-voice-quality.png 

* CUCM Voice Quality Site Performance 

  .. image:: /src/images/insights-ref-dash-cucm-voice-quality-site-perf.png 


Diagnostics > Microsoft Dashboards 
'''''''''''''''''''''''''''''''''''

Microsoft Teams dashboards display various data for understanding usage and overall health for a range of 
Microsoft Teams phones devices, including PSTN call records, and greater detail for Teamwork devices.

.. image:: /src/images/dashboards-diagnostics-msteams.png 


.. rubric:: Microsoft Teams - Call List 

Reports on vendor, call type, list and error, modality and quality. Clicking on a user opens the Call 
Debug Compact dashboard to view call statistics and incident detection and details for that user's call. 

.. image:: /src/images/insights-ref-dash-ms-teams-call-list.png 


.. rubric:: Microsoft Teams Call Detail 

.. image:: /src/images/insights-ref-dash-ms-teams-call-detail.png 


.. rubric:: Microsoft Teams - Calls with Issues 

This dashboard provides a count of poor quality calls, by category, for example, audio or video, and 
allows you to drill down into specific calls to view quality statistics showing why the call was poor or failed. 

Reports on call details, status, duration, quality, participant list, user agent details (caller and callee), 
failures by subnet/location. 
  
.. image:: /src/images/ms-teams-calls-with-issues-dashboard.png 


.. rubric:: Microsoft Teams - Call Debug Compact 

A user-centric dashboard to investigate call quality for specific users. This dashboard allows an admin or 
helpdesk support person to drill down to a user's calls, and to drill down to detected incidents on a 
specific call to understand exactly why a call failed or had poor quality - for example, you can 
see immediately whether an error may be related to one or more of jitter, video frame rate, packet loss, or some 
other indicated issue.  

.. image:: /src/images/ms-teams-dashboard-call-debug-compact.png 

.. image:: /src/images/ms-teams-dashboard-call-debug-compact-1.png 


.. rubric:: Microsoft Teams - Direct Routing Call Analysis 

This dashboard allows you to monitor the connectivity status between your SBC (Session Border Controller) 
and the direct routing interface so that you can track critical parameters related to your SBC, telephony 
service, and network conditions along the path to the direct routing interface. You can use details displayed 
on this dashboard to quickly detect and troubleshoot issues, including dropped calls. 
  
To collect this data, your Microsoft tenant must be enabled for call collection. This is configured on the 
Arbitrator via **System Configuration > Archive Management > Configuration Management > API Config**.

Data includes details for the top ten failure 
reasons, top ten caller and callee numbers based on attempt, top ten caller and callee numbers 
based on duration, as well as the call list, which provides summary data and details per call.   

By default, data is shown for the past two days, but can be configured to display data for a period 
not exceeding 90 days, which is the maximum period that Microsoft allows.  

.. image:: /src/images/ms-teams-dashboard-direct-routing-analysis.png 

   

.. rubric:: Microsoft Teams - Direct Routing Call Count 

.. image:: /src/images/ms-teams-dashboard-direct-routing-call-count.png 


.. rubric:: Microsoft Teams - Call Debug Full Detail 

Reports with full details on call quality for debugging purposes. See compact details for a specific user and their 
calls on the Call Debug Compact dashboard for Microsoft Teams. 

.. image:: /src/images/ms-teams-call-debug-full-detail-dashboard.png 

.. rubric:: Microsoft Teams Call Review Summary 

.. image:: /src/images/insights-ref-dash-ms-teams-call-rev-summary.png 


.. rubric:: Mcrosoft Teams Call Review Detailed 

.. image:: /src/images/insights-ref-dash-ms-teams-call-review-detailed.png 

.. rubric:: Microsoft Teams Call Feedback Detail 

.. image:: /src/images/insights-ref-dash-ms-teams-call-feedback-detail.png 




.. _synthetic-transactions-dashboards:

Synthetic Transactions Dashboards  
'''''''''''''''''''''''''''''''''''

These dashboards present data that allows you to understand why events such as packet loss are 
occurring, and to monitor performance indicators on router interfaces.

The dashboards are based on agents that can be deployed anywhere in a customer's network,
provided they can contact the Arbitrator, and allow monitoring of Linux systems.
For details on installing agents, see the topic on Digital Experience Monitoring (DEM) Agent Installation
in the Arbitrator Install Guide.

.. rubric:: Related Topics: 

* 
  .. raw:: latex

     Insights Agents in the Arbitrator Admin Guide

  .. raw:: html
  
     <a href="../VAA-arbitrator-correlation/configuration-agents.html">Insights Agents in the Arbitrator Admin Guide</a> 



.. rubric:: DEM Agent Stats Overview 

.. image:: /src/images/insights-ref-dash-dem-agent-stats.png


* Example Web performance stats: chart and table:
  
  
  .. image:: /src/images/Web-performance-chart.png
  
  .. image:: /src/images/Web-performance.png
  
  
* Example Connectivity performance stats: chart and table:

  .. image:: /src/images/DEM-Connectivity-chart.png

  .. image:: /src/images/DEM-connectivity.png



.. rubric:: Reported Incidents 

.. image:: /src/images/insights-ref-dash-reported-incidents.png 

.. rubric:: System Trace Details 

.. image:: /src/images/insights-ref-dash-system-trace-details.png 

.. rubric:: System Trace Status 

.. image:: /src/images/insights-ref-dash-system-trace-status.png 

.. rubric:: WEB Service Status 

.. image:: /src/images/insights-ref-dash-web-service-status.png 


.. _insights-ref-dash-usage:

Usage & Adoption  
....................

Microsoft 
''''''''''''

* Microsoft License Usage Activity 

  Reports on annual cost, user activity and inactivity by time periods (months, weeks), 
  as well as tenant and user breakdown by last teams activity and cost.

  .. image:: /src/images/insights-ref-dash-ms-license-usage-activity.png 

* Microsoft Teams License Trend 

  Reports on license usage by type and number of licenses used.

  .. image:: /src/images/insights-ref-dash-ms-teams-license-trend.png 

* Microsoft Teams Usage Analysis 

  .. image:: /src/images/insights-ref-dash-ms-license-usage-analysis.png 

* Microsoft Teams User Activity

  Reports on active user counts by calling, meetings, chat, busiest days

  .. image:: /src/images/insights-ref-dash-ms-teams-user-activity.png 

* Microsoft Teams User Activity Detailed 

  .. image:: /src/images/insights-ref-dash-ms-teams-user-activity-detailed.png 

* Microsoft Teams User Review 

  Reports on most active calling organizers, participants

  .. image:: /src/images/insights-ref-dash-ms-teams-user-review.png 



Webex 
''''''

* Meetings 

  * Meetings Quality 
  * Meetings Quality 1 
  * Meetings Who Joined 
  * Participant Summary 

    .. image:: /src/images/insights-ref-dash-participant-summary.png 

* Devices 

  .. image:: /src/images/insights-ref-dash-devices.png 

* Licenses 

  .. image:: /src/images/insights-ref-dash-webex-licenses.png

* Locations 

  .. image:: /src/images/insights-ref-dash-webex-locations.png 

* People 

  .. image:: /src/images/insights-ref-dash-webex-people.png 

* Webex Calling 
* Webex Insights 
* Webex Security 

.. _insights-ref-dash-user:

User & Device Inventory 
........................

Cisco 
''''''

* Cisco Headset Summary 

  .. image:: /src/images/insights-ref-dash-cisco-headset-summary.png 

* Phone Inventory 

  .. image:: /src/images/insights-ref-dash-phone-inventory.png 


Inventory 
''''''''''

* Device Inventory Dashboard 

  .. image:: /src/images/insights-ref-dash-device-inventory-dash.png 


Microsoft 
''''''''''

* Microsoft Teams Active Directory User List 

  Reports on user list with user details 

  .. image:: /src/images/insights-ref-dash-ms-teams-ad-user-list.png 

* Microsoft Teams Audio Device 

  .. image:: /src/images/insights-ref-dash-ms-teams-audio-device.png 

* Microsoft Teams Audio Devices Detailed 

  .. image:: /src/images/insights-ref-dash-ms-teams-audio-devices-detail.png 

* Microsoft Teams Devices 

  .. image:: /src/images/insights-ref-dash-ms-teams-devices.png 

* Microsoft Teams Teamwork Devices 

  Reports on device types, hardware models, buildings and meeting rooms





.. |main-menu-icon| image:: /src/images/analytics-main-menu-icon.png