Wat gebeurt er als de prompt alleen dit is?
Install https://aka.ms/fuam
Dat is genoeg om discovery te starten. Het is niet genoeg om een tenantwijziging te autoriseren, een capacity te kiezen, credentials te maken of succes te definiëren.
Nieuwere agentic models kunnen de repository inspecteren, gelinkte documentatie volgen, notebooks lezen en een deploymentplan voorbereiden. Dat is nuttig. Het haalt de omgevingsspecifieke beslissingen niet weg.
Dit artikel laat zien waar ik Copilot zou laten helpen met Fabric Unified Admin Monitoring, en waar ik expliciete menselijke goedkeuring zou houden.
Wat FUAM is
FUAM staat voor Fabric Unified Admin Monitoring. Het is een solution accelerator in de Microsoft Fabric Toolbox-repository.
Het combineert administratieve en operationele data zoals:
- tenant- en delegated-tenantsettings;
- activity events;
- workspace- en iteminventory;
- capacities en Capacity Metrics-data;
- refreshable items;
- Git connections; en
- Scanner API-metadata.
Het gebruikt Fabric-pipelines, notebooks, een Lakehouse, semantic models en Power BI-reports. Raw en getransformeerde data blijven beschikbaar voor custom monitoring.
FUAM is geen officieel Microsoft-product of -service. Het is een open-source solution accelerator zonder officiële Microsoft-support. Gebruik eerst een non-production capacity en gebruik de issue tracker van de repository voor templatespecifieke problemen.
Waarom de korte prompt te weinig specificeert
Hij zegt niet:
- welke tenant of capacity moet worden gebruikt;
- of een workspace en service principal mogen worden gemaakt;
- welke tenant settings zijn ingeschakeld;
- of er een compatibele Capacity Metrics app bestaat;
- waar credentials thuishoren;
- of dit een test- of production-deployment is;
- welke historieperioden moeten worden geladen; of
- wat “klaar” betekent.
Er is ook geen enkel installatiecommando. De officiële route downloadt en draait een notebook, configureert twee cloud connections, draait een orchestration pipeline, refresht semantic models, opent het report en plant latere loads.
Een veiligere prompt van één regel
Deploy FUAM from https://aka.ms/fuam into my Fabric tenant. Read the official repository and deployment guide first, create a preflight checklist, and stop for approval before changing tenant settings, creating identities, storing credentials, or deploying resources.
Daarmee laat je Copilot eerst onderzoeken en ontbrekende beslissingen zichtbaar maken.
De prompt die ik voor een echte deployment zou gebruiken
I want to deploy Fabric Unified Admin Monitoring from https://aka.ms/fuam.
Goal:
- Deploy FUAM into a dedicated, non-production, capacity-backed Fabric workspace.
- Run the initial load successfully.
- Refresh and validate the supplied semantic models and report.
- Configure a daily incremental run only after the initial validation passes.
Source of truth:
- Use only the current Microsoft fabric-toolbox FUAM repository and its linked documentation.
- Read the README, How_to_deploy_FUAM.md, authorization guidance, and deployment notebook before making changes.
- If the documentation and code disagree, stop and show me the conflict.
Safety:
- Do not create or modify a service principal, tenant setting, cloud connection, Key Vault secret, workspace role, or schedule without my explicit approval.
- Never print or commit secrets.
- Prefer Key Vault for unattended authentication.
- Test on a non-production capacity.
- Do not assume that a successful notebook run means the solution works.
Process:
1. Produce a preflight checklist and identify the values you still need from me.
2. Verify capacity, permissions, tenant settings, Capacity Metrics prerequisites, and XMLA access.
3. Prepare the official Deploy_FUAM.ipynb notebook and explain every manual portal step.
4. Guide me through deployment.
5. Configure the required Power BI and Fabric API cloud connections.
6. Run Load_FUAM_Data_E2E with safe initial-load parameters.
7. Refresh FUAM_Core_SM and FUAM_Item_SM.
8. Validate FUAM_Core_Report and the Lakehouse tables.
9. Propose daily incremental parameters and a schedule.
Success criteria:
- The deployment notebook completes.
- The two API connections authenticate.
- The initial orchestration pipeline succeeds.
- FUAM Lakehouse tables contain current data.
- Both semantic models refresh.
- The core report opens without model-field errors.
- A second incremental run does not duplicate or unexpectedly remove data.
Keep a checklist with evidence for every completed step. Stop when an action
needs tenant-admin approval or a secret.
Het belangrijke deel is niet de lengte. Het is het operationele contract: bron, bevoegdheid, veiligheidsgrenzen, proces en acceptance tests.
1. Inspecteer de bron
Set-Location D:\
git clone https://github.com/microsoft/fabric-toolbox.git
Set-Location D:\fabric-toolbox\monitoring\fabric-unified-admin-monitoring
Lees:
README.md;how-to/How_to_deploy_FUAM.md;scripts/Deploy_FUAM.ipynb;media/documentation/FUAM_Authorization.md;media/documentation/FUAM_Technical_Deep_Dive.md; en- de configuratie- en sourcefolders die de notebook gebruikt.
Vraag Copilot die bestanden om te zetten in een prerequisites matrix. Vraag niet om gaten vanuit het geheugen in te vullen.
2. Rond de preflight af
De deploymentguidance vereist:
- een Power BI- of Fabric-capacity;
- permission om een Fabric-workspace te maken;
- permission om een service principal te maken;
- een permanente Fabric Administrator of het gedocumenteerde alternatief met service principal en Key Vault;
- de tenant setting waarmee FUAM-workspaceadministrators items kunnen maken;
- XMLA endpoints ingeschakeld;
- een dedicated Capacity Metrics app-workspace op P- of F-capacity met XMLA read access; en
- een compatibele Capacity Metrics app-versie.
De FUAM service principal moet in een groep zitten waarvoor dit is ingeschakeld:
- Service principals can use Fabric APIs; en
- Service principals can access read-only admin APIs.
De repository zegt dat je Power BI API-permissions niet “voor de zekerheid” moet toevoegen. Volg de actuele authorization guidance.
3. Maak een dedicated workspace
Maak een workspace zoals FUAM op een test-P- of F-capacity. Leg naam, ID,
capacity, administrators, deployment owner, environment, retentionkeuze en
activity-anonymizationkeuze vast.
Dat zijn deploymentinputs, geen administratieve bijzaken.
4. Importeer en draai de notebook
Download
Deploy_FUAM.ipynb
en importeer hem in de workspace. Draai alle cells.
De notebook maakt of actualiseert FUAM-items. Bestaande system objects worden op naam gekoppeld en kunnen worden overschreven, dus inspecteer customizations voordat je hem opnieuw draait.
Als een cell faalt, bewaar dan de eerste fout en classificeer die als prerequisite failure of code defect voordat je de notebook wijzigt.
5. Configureer de API-connections
Configureer deze Web v2-connections:
| Connection | Base URL | Token audience |
|---|---|---|
fuam pbi-service-api admin | https://api.powerbi.com/v1.0/myorg/admin | https://analysis.windows.net/powerbi/api |
fuam fabric-service-api admin | https://api.fabric.microsoft.com/v1/admin | https://api.fabric.microsoft.com |
Plak geen client secret in Copilot. Voer het in via Fabric of haal het op via het goedgekeurde secret-managementpad.
6. Bereid Capacity Metrics voor
Gebruik waar mogelijk een aparte Capacity Metrics app-instance. Verplaats de workspace van de standaard Pro-workspace naar P- of F-capacity en leg workspace- of model-ID, appversie, XMLA-configuratie en toegang van de deployment owner vast.
7. Draai de eerste load
Open Load_FUAM_Data_E2E. Voor de eerste run staat de guidance toe:
metric_days_in_scope: maximaal14;activity_days_in_scope:28; endisplay_data:truevoor diagnostics.
De andere parameters dekken domains, inventory scope, Key Vault authentication, activity anonymization, raw-file retention en het aantal semantic models. Privacy en retention zijn governancebeslissingen. Laat de data owner ze goedkeuren vóór de run.
8. Refresh en inspecteer reports
Na de load:
- refresh
FUAM_Core_SM; - refresh
FUAM_Item_SM; - open
FUAM_Core_Report; - inspecteer meerdere pagina’s;
- bevestig deploymentmetadata; en
- verifieer verwachte workspaces, capacities en activities.
Als een visual niet rendert, refresh dan modelmetadata. De repository beschrijft een herstelpad via Edit tables en Confirm wanneer API-fields eerst ontbraken.
9. Valideer het Lakehouse
Vraag Copilot om queries voor:
- laatste ingestion timestamps;
- row counts per grote tabel;
- distinct capacities en workspaces;
- duplicate business keys;
- activity-date coverage;
- ontbrekende tenant identifiers; en
- verschillen tussen de eerste en tweede run.
“De query draaide” is niet hetzelfde als “FUAM is compleet”.
10. Plan de incremental load
Na validatie van de initial load:
metric_days_in_scope = 2
activity_days_in_scope = 2
Plan Load_FUAM_Data_E2E dagelijks. Het overlappende venster van twee dagen
helpt bij vertraagde events, maar valideer hoe de implementatie met die overlap
omgaat.
Gebruik voor unattended execution de gedocumenteerde Key Vault- en service principal-route in plaats van te leunen op de interactieve identity van de notebook owner.
Is de kleine prompt dus genoeg?
Hij kan genoeg zijn voor Copilot om de repository te vinden, guide en notebook te lokaliseren, een plan te maken en betere vragen te stellen dan oudere modellen.
Hij is niet genoeg om dit te autoriseren:
- tenantbrede settingwijzigingen;
- het maken van identity of secrets;
- capacityselectie;
- privacy- en retentionkeuzes;
- production-deployment; of
- acceptatie van onvolledige monitoringdata.
Het model is capabeler. De tenant blijft specifiek.
De echte test is of Copilot deze keten bewaart:
official source
-> prerequisites
-> approvals
-> deployment
-> credentials
-> initial load
-> model refresh
-> data validation
-> incremental schedule
Ontbreekt één schakel, dan heeft de agent wat Fabric-items gemaakt. FUAM is niet geïnstalleerd.
Bronnen
- FUAM short link
- FUAM in de Microsoft Fabric Toolbox
- Officiële FUAM deployment guide
- FUAM deployment notebook
- FUAM technical deep dive
- GitHub Copilot voor de command line
Als FUAM helpt, geef de Fabric Toolbox-repository een star en meld deploymentbevindingen via de issue tracker.
Reacties laden…