Set up the Power BI dashboard

The Power BI dashboard provides a holistic overview with visualizations and insights into resources in your tenant: environments, apps, Power Automate flows, connectors, connection references, makers, and audit logs. Telemetry from the audit log is stored from the moment you set up the Center of Excellence (CoE) Starter Kit, so you can look back and identify trends over time.

CoE Starter Kit Power BI dashboard.

Watch a walk-through on how to set up the Power BI dashboard.

Which dashboard to use?

You can get the CoE Power BI dashboard by downloading the CoE Starter Kit compressed file (aka.ms/CoeStarterKitDownload). Extract the zip file after downloading - it contains two Power BI template files:

  • Use the Production_CoEDashboard_MMMYY.pbit file if your Power Platform inventory data source is retrieved via cloud flows.
  • Use the BYODL_CoEDashboard_MMMYY.pbit file if your Power Platform inventory data source is retrieved via Data Export.
  • Use the PowerPlatformGovernance_CoEDashboard_MMMYY.pbit file in addition to the above dashboards to gain further actionable governance and compliance insights into your adoption.

Note

Get the environment URL

You need the environment URL of the Microsoft Power Platform environment the CoE Starter Kit is installed in. Power BI will connect to the Microsoft Dataverse tables in that environment.

  1. Go to the Power Platform admin center.

  2. Select Environments, and select the environment where the CoE solution is installed.

  3. Copy the organization URL in the details window. Power Platform admin center, with the environment URL highlighted.

    If the URL is truncated, you can see the full URL by selecting See all > Environment URL. Environment settings available in the Power Platform admin center.

Configure the Production and Governance Power BI dashboard

You can configure and modify the Power BI dashboard by working directly with the Power BI (.pbit) file and Power BI Desktop. Using Power BI Desktop gives you flexibility to modify the dashboard to your own branding, and including (or excluding) pages or visuals you want to see (or not see) in the dashboard.

  1. Download and install Microsoft Power BI Desktop.

  2. In Power BI Desktop, open the .pbit file, which can be found in the CoE Starter Kit you downloaded from aka.ms/CoeStarterKitDownload.

  3. Enter the URL of your environment instance. If you're using the Production_CoEDashboard_MMMYY.pbit and PowerPlatformGovernance_CoEDashboard_MMMYY.pbit, include the https:// prefix for OrgUrl. If prompted, sign in to Power BI Desktop with your organization account that has access to the environment you installed the CoE Starter Kit in.

    Enter OrgUrl to configure Power BI dashboard.

  4. Save the dashboard locally, or select Publish and choose the workspace you want to publish the report to.

  5. Configure scheduled refresh for your Power BI Dataset to update the report daily.

You can find the report later by going to app.powerbi.com.

Configure the BYODL Power BI dashboard

Copy Azure Storage Account URL

  1. Navigate to portal.azure.com.
  2. Search for or select the storage account configured to receive Data Export data.
  3. Select Endpoints.
  4. Copy the Data Lake Storage URL to notepad. Copy Data Lake Storage URL from Storage Account endpoints.
  5. Append /powerplatform to the URL.

Import Power BI dataflows

Power BI dataflows are used to transform data from the Azure Storage account into tables that are then used by the dashboard. You'll first have to configure the Power BI dataflows.

  1. Navigate to app.powerbi.com.

  2. Select Workspaces > Create a workspace.

  3. Provide a name and description, select Advanced and choose Premium per user or Premium per capacity depending on what’s available in your tenant. Select Large dataset storage format. You can also use an existing premium workspace, if available. Create a new premium workspace.

    Note

    A Power BI Premium trial is sufficient, if you are only testing out the integration of the Data Export feature with the CoE Starter Kit.

  4. Select + New > Dataflow (if prompted select No, create dataflow instead of datamart). Create a dataflow.

  5. Select Import Model and upload the PowerPlatformAdminAnalytics-DF.json file, which can be found in the CoE Starter Kit you downloaded from aka.ms/CoeStarterKitDownload. Import a dataflow model.

  6. From the workspace, select Datasets + Dataflows to see your imported dataflow.

  7. Edit the dataflow. Edit the imported dataflow.

  8. Select Edit tables. Edit the tables of the imported dataflow.

  9. Select the Datalake URL parameter. Update the Datalake URL parameter to point to your Azure Storage Account URL.

  10. Paste the Azure Storage Account URL and make sure it ends with /powerplatform and doesn’t include a trailing /.

  11. From the Queries view, select one table after the other to configure connections and login with your account. If creating the connection fails, try selecting Source under Applied steps and retry configuring the connection. Configure connections for the data sources.

  12. Select Continue when you see a notification about connecting data from multiple sources.

  13. Select Save and Close and wait for the validation to finish.

  14. Select Close to close the edit tables view.

  15. Select … > Settings on the dataflow.

  16. Configure a daily schedule refresh. Check when files are usually written to your storage account by the Data Export feature, and set the daily refresh of the dataflow up for after that. This means the dataflow will run after data is exported to your storage account. Configure scheduled refresh for the dataflow.

  17. Refresh the dataflow manually. The initial refresh may take 1-2hrs to run, depending on how big your inventory is. Check the Refresh History to see when it completes.

  18. Copy the Power BI workspace and dataflow ID

    1. Select the dataflow and copy the Workspace ID by looking at the URL copying the GUID after /groups/. Copy workspace ID
    2. Select the dataflow and copy the Dataflow ID by looking at the URL and copying the GUID after /dataflows/. Copy dataflow ID

Configure the Power BI dashboard

  1. In Power BI Desktop, open the BYODL_CoEDashboard_MMMYY.pbit file, which can be found in the CoE Starter Kit you downloaded from aka.ms/CoeStarterKitDownload.

  2. Enter the URL of your environment instance, including the https:// prefix for OrgUrl. Enter the ID to your Power BI Workspace for Power BI Workspace ID. Enter the ID to your Power BI Dataflow for Power BI Dataflow ID. If prompted, sign in to Power BI Desktop with your organization account that has access to the environment you installed the CoE Starter Kit in.

  3. Save the dashboard locally, or select Publish and choose the workspace you want to publish the report to.

  4. Configure scheduled refresh for your Power BI Dataset to update the report daily.

You can find the report later by going to app.powerbi.com.

Troubleshooting

The Data source error: Information is needed in order to combine data; Information about a data source is required error message when using the BYODL Dashboard means that you have not configured the correct privacy settings for Power BI to combine data from the Azure storage account and Dataverse. Change the privacy level and update the credentials to resolve the issue:

  1. Open Power BI Desktop.

  2. Select File > Options and settings > Options.

  3. Select Global > Privacy and set the privacy level to Always combine data according to your Privacy Level settings for each source.

    Set the privacy level to: Always combine data according to your Privacy Level setting for each data source.

  4. Select OK, and then select File > Options and settings > Options again.

  5. Select Current File > Privacy and set the privacy level to Combine data according to your Privacy Level settings for each source.

    Set the privacy level to: Combine data according to your Privacy Level setting for each data source.

  6. Select OK.

  7. Select File > Options and settings > Data source settings.

  8. Select Edit Permissions and set the privacy level to Organizational for both data sources.

    Set the privacy level to: Organizational.

  9. Save the report and refresh it in Power BI Desktop.

  10. Select Publish.

  11. Navigate to app.powerbi.com and select your workspace.

  12. Select Datasets + dataflows.

  13. Select Settings on the dataset.

    Select settings on the dataset.

  14. Select Data Source Credentials.

  15. Select Edit credentials, set the privacy level to Organizational for both data sources, and select Sign in for each data source.

    Set the privacy level to: Organizational and sign in.

The Unable to connect (provider Named Pipes Provider, error: 40 – Couldn't open a connection to SQL Server) error message means that the connector has failed to connect to the TDS endpoint. This error can occur when the URL used with the connector includes https:// and/or the ending /. Remove the https:// and ending forward slash so that the URL is in the form orgname.crm.dynamics.com.

Error message: Unable to connect.

The A connection was successfully established with the server, but then an error occurred during the pre-login handshake error message means that the connector has failed to connect to the TDS endpoint. This error can also occur if the ports the TDS endpoint uses are blocked. Learn more: Ports required for using SQL to query data

Error message: A connection was successfully established with the server, but then an error occurred.

When you see Unable to open document: The queries were authored with a newer version of Power BI Desktop and might not work with your version as an error message and you are on the current version of Power BI Desktop, select Close to continue, and set up the latest version.

Error message: Unable to open document.

When you see sign-in issues, you may have issues with your data source settings being cached to the wrong user or tenant. Here are a few examples of what that might look like:

Error message: Data Source Error. The remote name could not be resolved. Error message: Authorization wasn't specified.

The solution in this case is to clear the permissions:

  1. Open Power BI Desktop.
  2. Select File > Options and settings > Data source settings.
  3. Select the data source you need to connect to (for example, https://mycoe.crm.dynamics.com) and select Clear Permissions.
  4. Then, try to open the Power BI template file again.

Configure embedded apps in the CoE dashboard

The Production_CoEDashboard_MMMYY.pbit and BYODL_CoEDashboard_MMMYY.pbit dashboards can be configured to use embedded apps to enable you to drive action based on insights you find. With the embedded apps, you can grant yourself access to resources, delete apps and flows, and reach out to the maker through email. You must configure the Power Apps visuals in the Power BI dashboard before you can use them.

In order to configure the embedded apps, you must meet these pre-requisites:

  • You must be an owner or co-owner of the Admin – Access this app and Admin – Access this flow apps to be able to embed them.
  • Because this app uses Microsoft Dataverse, end-users must have a Power Apps Per User license, the app must be assigned a Power Apps Per App license, or the environment must be covered by pay-as-you-go.
  • This app is intended to be used only by admins. Power Platform Service Admin or Global Admin permission is required.

Once you meet these requirements, embed the apps.

  1. Open the CoE Power BI dashboard in Power BI Desktop.

  2. Go to the App Detail page.

    Go to App Detail page in Power BI Desktop.

  3. Select the existing Power Apps visual, select Format visual and select Reset to default.

    Select Reset to default to format the visual.

  4. Select Choose app.

  5. Select the environment of your CoE (where you imported the apps to).

    Select the environment in Power Apps for the Power BI visual.

  6. Search for and select Admin – Access this app.

    Select Admin - Access this app to embed this app into Power BI.

  7. If you see an error like one of these, ignore it. The app will not work when browsing directly to this page, only when an app is sent in via drillthrough

    Select Admin - Access this flow to embed this app into Power BI - Error 1. Select Admin - Access this flow to embed this app into Power BI. - Error 2

  8. Next, go to the Cloud flow detail tab and repeat the above steps, selecting the Admin - Access this flow app this time.

Republish the dashboard, and view it under app.powerbi.com.

It looks like I found a bug with the CoE Starter Kit; where should I go?

To file a bug against the solution, go to aka.ms/coe-starter-kit-issues.