Skip to content

Commit

Permalink
Merge pull request #15312 from MicrosoftDocs/main
Browse files Browse the repository at this point in the history
Publish main to live, Wednesday 3:30PM PDT, 07/31
  • Loading branch information
shdyas authored Jul 31, 2024
2 parents 3b36d65 + de7a3bf commit 07f6107
Show file tree
Hide file tree
Showing 4 changed files with 43 additions and 30 deletions.
4 changes: 2 additions & 2 deletions .github/workflows/PrFileCount.yml
Original file line number Diff line number Diff line change
Expand Up @@ -7,7 +7,7 @@ permissions:

on:
pull_request_target:
types: [opened, reopened, synchronize, labeled, unlabeled]
types: [opened, reopened, synchronize, labeled, unlabeled, edited]

jobs:

Expand All @@ -19,4 +19,4 @@ jobs:
AccessToken: ${{ secrets.GITHUB_TOKEN }}




59 changes: 35 additions & 24 deletions Teams/CQD-data-and-reports.md
Original file line number Diff line number Diff line change
Expand Up @@ -3,8 +3,8 @@ title: Data and reports in Call Quality Dashboard (CQD)
author: mkbond007
ms.author: mabond
manager: pamgreen
ms.reviewer: mikedav, siunies, gageames
ms.date: 11/28/2017
ms.reviewer: jamp, siunies, mikedav, gageames
ms.date: 07/31/2024
ms.topic: article
ms.tgt.pltfrm: cloud
ms.service: msteams
Expand All @@ -29,7 +29,7 @@ description: Learn about the data and reports available in Microsoft Call Qualit

# Data and reports in Call Quality Dashboard (CQD)

Microsoft Call Quality Dashboard (CQD) uses a near-real-time (NRT) data feed. Call records are available in CQD within 30 minutes of the end of a call and remain in CQD for 12 months, except for EUII fields which are removed after 28 days.
Microsoft Call Quality Dashboard (CQD) uses a near-real-time (NRT) data feed. Call records are available in CQD within 30 minutes of the end of a call and remain in CQD for 12 months, except for end user identifiable information (EUII) fields which are removed after 28 days.

## Many ways to access call quality data

Expand All @@ -39,12 +39,12 @@ You can access call quality data by several different avenues. Pick the one that
|---|---|
|Teams admin center [(https://admin.teams.microsoft.com)](https://admin.teams.microsoft.com)|Call quality data is included on the **Users** page in the Teams admin center, showing the most common data you need in an easy-to-read format. You can't customize the data that you find under **Users**.|
|CQD portal [(https://cqd.teams.microsoft.com)](https://cqd.teams.microsoft.com)|Robust summary and detailed reports that meet most needs, with drill-through filtering. You can also customize reports in the CQD portal. <br><br>Get two [CQD report templates](#import-the-cqd-report-templates) to help you analyze data in the CQD portal.|
|Power BI|Use direct queries to view your CQD data in Power BI using [customizable Power BI templates](CQD-Power-BI-query-templates.md). [Download Power BI query templates for CQD](https://www.microsoft.com/download/details.aspx?id=102291).<br><br>You can also [use the REST API to access CQD data](/skypeforbusiness/management-tools/call-quality-dashboard/data-api) through Power BI. Use this method if you want to download your CQD data so you can work on it offline. The benefit of using this method is better performance, especially useful for large data sets that bog down in Power BI when you're online.|
|Power BI|Use direct queries to view your CQD data in Power BI using [customizable Power BI templates](CQD-Power-BI-query-templates.md). The CQD Power BI templates are regularly updated to support new Teams features, calling scenarios, and the latest telemetry we have available in CQD.|
|Graph API|Access raw call quality data yourself using the [Graph API](/graph/api/resources/callrecords-api-overview). This is the most complex method, but it gives you the most control and flexibility in analyzing your call quality data. For example, if you need to join it with other data for your organization, you can use the Graph API to create a data model and incorporate call quality data. Please note that CallRecords Graph API may not contain all of the fields that are available in CQD and naming conventions may differ between the two products. |

## Import the CQD report templates

Download [two curated CQD report templates](https://aka.ms/qertemplates) (All Networks and Managed Networks) to help you get up to speed quickly with CQD. The All Networks template, though optimized to work with a building data file, can be used while you work toward collecting and uploading building information into CQD, as described in the next section.
Download [two curated CQD report templates](https://aka.ms/qertemplates) (All Networks and Managed Networks) to help you get up to speed quickly with CQD on the web. The All Networks template, though optimized to work with a building data file, can be used while you work toward collecting and uploading building information into CQD, as described in the next section.

**To import the templates (.CQDX) into CQD**:

Expand All @@ -57,25 +57,37 @@ Download [two curated CQD report templates](https://aka.ms/qertemplates) (All Ne
4. Repeat steps 2 and 3 for the second CQD template.

> [!NOTE]
> Each user must import the CQD templates into their CQD instance.
> Templates and saved reports are unique for each admin that logs into CQD. Each user must follow the steps to import the CQD templates if they wish to use them.
>
> For the best experience with using CQD, we recommend using [the latest QER experience in Power BI](cqd-power-bi-query-templates.md) instead.
## EUII data

For compliance reasons, end-user identifiable information (EUII) data (also known as personally-identifiable information or PII) is only kept for 28 days. As NRT data crosses the 28-day mark, fields that contain EUII are cleared, resulting in EUII-free NRT data. Fields that contain EUII data are:
For compliance reasons, EUII data (also known as personally-identifiable information or PII) is only kept for 28 days. As CQD's data crosses the 28-day mark, fields that contain EUII are cleared, resulting in EUII-free data. Fields that contain EUII data are:

- Full IP address
- Media Access Control (MAC) Address
- Basic Service Set identifier (BSSID)
- Session Initiation Protocol (SIP) URI (Skype for Business only)
- User Principal Name (UPN)
- Machine Endpoint Name
- User Verbatim Feedback
- Object ID (the Active Directory object ID of the endpoint's user)
- IP Address
- User ObjectId
- MAC Address
- Sip Uri (Skype for Business only)
- Phone Number
- UPN
- Feedback Text
- Client Endpoint Name
- Local Address
- Remote Address
- Base Address
- Local Site
- Remote Site
- Auto Attendant Identity
- Call Queue Identity
- Video Teleconferencing (VTC) Device Name
- Video Teleconferencing (VTC) Device Detail
- Transferred from Call Queue Identity
- Organizer ObjectId
- Organizer UPN
- Organizer Sip Uri (Skype for Business only)
- VTC Device Name
- VTC Device Detail



### Admin roles with and without EUII access

Expand Down Expand Up @@ -140,12 +152,12 @@ If you want to use Power BI to analyze your CQD data, read [Use Power BI to anal

### Select product data to see in reports

In the Summary and Location-Enhanced Reports, you can use the **Product Filter** drop-down to show all product data, only Microsoft Teams data, or only Skype for Business Online data.
In the Summary and Location-Enhanced Reports, you can use the **Product Filter** drop-down to show all product data, only Microsoft Teams data, or only Skype for Business data.

> [!div class="mx-imgBorder"]
> ![Screenshot: shows the Product Filter control options.](media/206ad818-0f72-4c8e-b25e-3cc8fcfbef05.png)
In Detailed reports, you can use the **Is Teams** dimension to filter the data to Microsoft Teams or Skype for Business Online data.
In Detailed reports, you can use the **Is Teams** dimension to filter the data to Microsoft Teams or Skype for Business data.

## Summary Reports

Expand Down Expand Up @@ -222,7 +234,6 @@ As the names indicate, the classification criteria is based on the type of clien
The CQD Summary Reports dashboard includes a **Tenant Data Upload** page, accessed by selecting **Tenant Data Upload** from the settings menu in the top-right corner. This page is used for admins to upload their own information, such as:

- A map of IP address and geographical information.
- A map of each wireless AP and its MAC address.
- A map of Endpoint to Endpoint Make/Model/Type, etc.

We recommend that you upload your tenant, building, and location data so CQD can include this information in your reports. If you haven't already uploaded this data, read [Upload tenant and building data](CQD-upload-tenant-building-data.md).
Expand Down Expand Up @@ -303,7 +314,7 @@ In order to select multiple filter values, begin by adding a new filter to the r

Then, click **Search** (a magnifying glass icon next to the new filter). You'll see a text field, and a number of options, including **Select All** and **Invert**. Enter a value, and click **Search** next to that field to search. Alternatively, leave the text field empty and click **Search** to view up to the first 100 options.

```powershell
```URL
/filter/[AllStreams].[Second Tenant Id]\|[YOUR TENANT ID HERE]
```

Expand All @@ -317,7 +328,7 @@ Certain CQD reports have dashboard-level filters added to them, making it easy t

![Screenshot of a dashboard filter.](media/qerguide-image-dashboardfilters.png)

```powershell
```URL
/filter/[AllStreams].[Is Teams]|[TRUE | FALSE]
```

Expand All @@ -328,7 +339,7 @@ Excluding federated data from CQD reports is useful when you're remediating mana

To add a filter, append the following to the end of the URL:

```console
```URL
/filter/[AllStreams].[Second Tenant Id]\|[YOUR TENANT ID HERE]
```

Expand All @@ -354,7 +365,7 @@ To apply URL filters with multi-select values, separate each value with a pipe (

If you specify an invalid name or value, the URL filter won't be applied.

You can use a URL filter to filter every report for a specific dimension. The most common URL filters are used to filter reports to exclude federated participant telemetry, or focus on only Teams or Skype for Business Online. Excluding federated data from CQD reports is useful when you're remediating managed buildings or networks where federated endpoints might influence your reports.
You can use a URL filter to filter every report for a specific dimension. The most common URL filters are used to filter reports to exclude federated participant telemetry, or focus on only Teams or Skype for Business. Excluding federated data from CQD reports is useful when you're remediating managed buildings or networks where federated endpoints might influence your reports.

|Filter|Description|CQD query filter example|
|---|---|---|
Expand Down
8 changes: 4 additions & 4 deletions Teams/set-up-your-team-hierarchy.md
Original file line number Diff line number Diff line change
Expand Up @@ -113,7 +113,7 @@ You can add bucket columns to create buckets, which are groupings into which tas

By categorizing the work items one time centrally, the publishing team can preorganize the task list for all the tens, hundreds, or thousands of recipient teams that receive the task list. The recipient teams can then sort and filter their tasks by bucket to focus on the area most relevant to their work.

When you add a bucket column, note the following:
When you add a bucket column, keep the following things in mind:

* The column name becomes the name of the bucket. Each bucket you specify appears in the Buckets list in the Teams apps that use the hierarchy.
* We recommend that you don't include sensitive information in bucket names. At this time, publishing teams can't remove a bucket through publishing after it's created.
Expand All @@ -122,7 +122,7 @@ When you add a bucket column, note the following:

### Example

Here's an example of a schema CSV file that would be created to support the hierarchy shown in the previous image. This schema contains the following:
Here's an example of a schema CSV file that would be created to support the hierarchy shown in the previous image. This schema contains the following columns:

* Three required columns named `TargetName`, `ParentName`, and `TeamId`
* Three attribute columns named `Store layout`, `Departments:Clothing`, and `Departments:Foods`
Expand All @@ -143,8 +143,8 @@ New York Store,Northeast Zone,e2ba65f6-25e7-488b-b8f0-b8562d5de60a,Large,1,1,,,
Boston Store,Northeast Zone,0454f08a-0507-437c-969a-682eb2fae7fc,Standard,1,1,,,
Miami Store,Southeast Zone,619d6e4e-5f68-4b36-8e1f-16c98d7396c1,Compact,0,1,,,
New Orleans Store,Southeast Zone,6be960b8-72af-4561-a343-9ac4711874eb,Compact,0,1,,,
Seattle Store,West Regional Zone,487c0d20-4e55-4dc2-8187-a24c826e0fee,Standard,1,1,,,
Los Angeles Store,West Regional Zone,204a1287-2efb-4a8a-88e0-56fbaf5a2389,Large,1,1,,,
Seattle Store,West Regional Office,487c0d20-4e55-4dc2-8187-a24c826e0fee,Standard,1,1,,,
Los Angeles Store,West Regional Office,204a1287-2efb-4a8a-88e0-56fbaf5a2389,Large,1,1,,,
```

## Apply your hierarchy
Expand Down
2 changes: 2 additions & 0 deletions Teams/sip-gateway-plan.md
Original file line number Diff line number Diff line change
Expand Up @@ -279,7 +279,9 @@ If you have a 3PIP or SIP device, you must have the following:
| |D735<sup>3</sup> |10.1.141.13 |10.1.141.13 |IP Phone | |

<sup>1</sup> Device supports dynamic location discovery through LLDP with SIP Gateway.

<sup>2</sup> Device supports dynamic location discovery with SIP Gateway.

<sup>3</sup> Device supports only static location with SIP Gateway.

> [!NOTE]
Expand Down

0 comments on commit 07f6107

Please sign in to comment.