Launch Soterre PBI Analyzer

Download and Launch

1. Download the latest Soterre PBI Analyzer release (.zip archive) provided by our team.

2. Extract the archive. Inside you will find:

   • pbi-analyzer.exe — Windows executable

3. Run the executable for your platform. A terminal window will open showing the server startup log.

4. Open your browser and navigate to:

   http://localhost:4633

   The Soterre PBI Analyzer UI will load automatically.

Tip: Keep the terminal window open while using the application. Closing it will stop the server.

---

Two Ways to Analyze Reports

Once the UI is loaded, you have two options:

Option A — Import a Local File

Use this when you already have a Power BI file on your machine.

1. On the main screen, choose Import Local File.

2. Select a file from your computer. Supported formats:

   Format	Description
   .pbix	Power BI Desktop report
   .pbit	Power BI template file

   Maximum file size: 100 MB.

3. The analyzer will process the file and display a full report — data model structure, visual statistics, unused elements, duplicates, and more.

Option B — Connect to Power BI Service

Use this to pull reports directly from your organization’s Power BI tenant.

1. On the main screen, choose Connect to Power BI Service.
2. You will need to provide your Tenant ID, Client ID, and Client Secret (Azure AD service principal credentials).
3. Once connected, you can browse workspaces, select datasets and reports, and run the analysis remotely.

First time connecting? Follow the Set Up Power BI Service Credentials guide to create and configure the required Azure AD application and permissions.

---

Add a New Tenant

After you have your service principal credentials ready (see Set Up Power BI Service Credentials), add a tenant in the app:

1. Open the Soterre PBI Analyzer UI at http://localhost:4633.

2. Go to Tenants in the left sidebar.

3. Click ”+ Add Tenant”.

4. Fill in the form:

   Field	Required	Where to Find It
   Name	Optional	Your choice (e.g., “My Organization”)
   Tenant ID	Yes	Azure Portal → Entra ID → Overview → Directory (tenant) ID
   Client ID	Yes	Azure Portal → App registrations → your app → Application (client) ID
   Client Secret	Yes	Copied when creating the secret (shown only once)
   Metrics Workspace ID	Optional*	URL of the Fabric Capacity Metrics workspace (GUID after /groups/)
   Metrics Dataset ID	Optional*	URL of the Fabric Capacity Metrics dataset (GUID after /datasets/)

   *Optional but recommended — without these, the Capacity module will fall back to the Admin API which provides less detailed CU consumption data.

5. Click Save. The tenant will appear in the list, and you can start browsing its workspaces.