Azure Log Analytics configureren voor Power BI

Power BI integreert met Azure Log Analytics om beheerders en Premium-werkruimte-eigenaren in staat te stellen een Log Analytics-verbinding met hun Power BI-abonnement te configureren. In dit artikel wordt beschreven hoe de integratie tussen Log Analytics en Power BI werkt en hoe u deze configureert voor uw omgeving.

Er zijn twee elementen om Azure Log Analytics te laten werken voor Power BI:

• Configureer uw Azure-abonnement in Azure Portal.
• Schakel Log Analytics in voor Power BI in de Power BI Beheer-portal.

In de volgende secties doorloopt u de stappen om beide uit te voeren.

Vereisten

Voordat u Log Analytics-integratie vanuit Power BI kunt configureren, moet u een Log Analytics-werkruimte maken in Azure Portal. U moet ook toestemming geven in Azure voor de Power BI-service om logboeken te schrijven. De exacte vereisten zijn:

• Inzendertoegang tot Azure-abonnement.
• Registreer de resourceprovider microsoft.insights in het Azure-abonnement waar u Power BI-logboekgegevens verzamelt.
• De gebruiker die Log Analytics-integratie in Power BI instelt, moet de rol Log Analytics-inzender hebben voor de Log Analytics-werkruimte. Zie de veelgestelde vragen voor tijdelijke oplossingen als de rol Eigenaar niet kan worden opgegeven.

De resourceprovider microsoft.insights inschakelen

Log Analytics vereist dat de resourceprovider microsoft.insights is ingeschakeld op azure-abonnementsniveau. Met de volgende stappen doorloopt u het proces.

1. Meld u aan bij Azure Portal, selecteer het abonnement dat u wilt gebruiken met Log Analytics en die uw Log Analytics-werkruimten bevat. Selecteer resourceproviders in de sectie Instellingen, zoals wordt weergegeven in de volgende afbeelding.

   

2. Zoek naar microsoft.insights onder Resourceproviders. Selecteer vervolgens Registreren.

   

Machtigingen instellen

1. Zorg ervoor dat de gebruiker die Log Analytics-integratie configureert, de rol Log Analytics-inzender heeft van de Log Analytics-werkruimte. Wanneer u Toegangsbeheer (IAM) selecteert voor het abonnement in Azure Portal en vervolgens roltoewijzingen selecteert in de bovenste selecties in het deelvenster, moet de huidige gebruiker één vermelding zien: Log Analytics-inzender voor de gebruiker die Log Analytics configureert:

   

Nadat u deze stappen hebt voltooid, is het configuratiegedeelte van Azure Log Analytics voltooid. In de volgende sectie ziet u hoe u de configuratie kunt voortzetten en voltooien in de Power BI Beheer-portal.

Logboekregistratie op werkruimteniveau vanuit de Beheer-portal toestaan

Een Power BI-beheerder moet de volgende stap uitvoeren om Azure Log Analytics voor Power BI Premium-werkruimten in te schakelen. Met deze instelling kunnen Power BI Premium-werkruimtebeheerders hun werkruimtelogboeken verzenden naar Azure Log Analytics wanneer aan de vereisten is voldaan.

1. Ga in de Power BI Beheer-portal naar Tenant Instellingen > Instellingen voor controle en gebruik en vouw Azure Log Analytics-verbindingen uit voor werkruimtebeheerders. Als u wilt toestaan dat werkruimtebeheerders Log Analytics inschakelen, stelt u de schuifregelaar in op Ingeschakeld en geeft u de benodigde beveiligingsgroepen op onder Toepassen op, zoals wordt weergegeven in de volgende afbeelding.

   

Logboekregistratie configureren in een Premium-werkruimte

1. In de Premium-werkruimte kunnen werkruimtebeheerders Log Analytics inschakelen. Hiervoor gaat u naar Instellingen, zoals wordt weergegeven in de volgende afbeelding.

   

2. Selecteer Azure-verbindingen in het deelvenster Instellingen en vouw Log Analytics uit, zoals wordt weergegeven in de volgende afbeelding.

   

3. Selecteer het Azure-abonnement, de resourcegroep en vervolgens de Log Analytics-werkruimte die in de vorige sectie is geconfigureerd. Kies vervolgens Opslaan. Wanneer dit is voltooid, moet de uitgevouwen log analytics-sectie op tenantniveau er ongeveer uitzien als in de volgende afbeelding.

   

Verbinding verbreken met Azure Log Analytics

U kunt de verbinding met Azure Log Analytics verbreken om te stoppen met het verzenden van logboeken naar Azure. Als u de verbinding wilt verbreken, gaat u in de Power BI-werkruimte Instellingen naar de Log Analytics-instellingen. Selecteer Verbinding verbreken vanuit Azure. Kies Vervolgens Opslaan om de verbinding te verbreken.

Notitie

Wanneer u een Power BI-werkruimte loskoppelt van Azure Log Analytics, worden logboeken niet verwijderd. Uw gegevens blijven en volgen het opslag- en bewaarbeleid dat u daar hebt ingesteld.

Gebruiksscenario's

Er zijn veel manieren waarop Azure Log Analytics en Power BI u kunnen helpen bij het oplossen van echte uitdagingen voor uw organisatie. Denk aan het volgende:

• Identificeer perioden met een hoge of ongebruikelijke Analysis Services-engineactiviteit op basis van capaciteit, werkruimte, rapport of gebruiker.
• Analyseer queryprestaties en trends, waaronder externe DirectQuery-bewerkingen.
• Analyseer de vernieuwingsduur van het semantische model, overlapt en verwerkingsstappen.
• Analyseer aangepaste bewerkingen die worden verzonden met behulp van het Premium XMLA-eindpunt.

Stuur ons feedback in de Power BI-community voor hoe u logboekregistratie gebruikt en hoe het uw organisatie heeft geholpen.

Foutvoorwaarden en oplossingen

De volgende tabel bevat een verzameling veelvoorkomende fouten, de gebeurtenissen of configuraties die deze hebben geactiveerd en voorgestelde oplossingen.

Triggervoorwaarde	Type	Bericht
U bent niet gemachtigd om naar de Log Analytics-werkruimte te schrijven	Fout: kan niet doorgaan	U hebt schrijfmachtigingen nodig voor deze Log Analytics-werkruimte om deze te verbinden met Power BI. Neem contact op met de persoon in uw organisatie die Azure-abonnementen beheert om dit probleem op te lossen.
U bent niet gemachtigd om naar het Log Analytics-werkruimteaccount te schrijven	Fout: kan niet doorgaan	U hebt schrijfmachtigingen nodig voor deze Log Analytics-werkruimte om deze te verbinden met Power BI.
U hebt geen toegang tot Azure-abonnementen	Fout: kan niet doorgaan	U hebt geen toegang tot Azure-abonnementen. Vraag de persoon die Azure-abonnementen beheert in uw organisatie om u inzendertoegang of hoger te verlenen.
U hebt geen toegang tot Azure Log Analytics-werkruimten binnen dat abonnement	Fout: kan niet doorgaan	U hebt geen toegang tot een Azure Log Analytics-werkruimte. Vraag de persoon die Azure-abonnementen beheert in uw organisatie om u toe te voegen aan de rol log analytics-eigenaar of inzender.
Log Analytics op werkruimteniveau is uitgeschakeld wanneer u verbinding probeert te maken	Gegevens	Vraag uw tenantbeheerder om werkruimtebeheerders toestemming te geven om Verbinding te maken met Log Analytics-werkruimten.
Log Analytics op werkruimteniveau uitgeschakeld bij het verbreken van de verbinding	Gegevens	Uw tenantbeheerder heeft de machtiging voor werkruimtebeheerders ingetrokken om verbinding te maken met hun eigen Azure Log Analytics-werkruimten. Als u de verbinding verbreekt, kunt u geen verbinding maken met een andere verbinding.

Gebeurtenissen en schema

Nadat u Azure Log Analytics hebt ingeschakeld, worden de volgende gebeurteniscategorieën vastgelegd. Zie Analysis Services Trace Events voor meer informatie over deze gebeurtenissen.

• AggregateTableRewriteQuery
• Opdracht
• Impasse
• DirectQuery
• Detecteren
• Error
• Voortgangsrapport
• Query’s uitvoeren
• Sessie initialiseren
• VertiPaqSEQuery
• Melding

In de volgende tabel wordt het schema beschreven.

Eigenschappen	Bestaande azure Analysis Services-eigenschap	Beschrijving
TimeGenerated		De timestamp (UTC) van het moment waarop het logboek werd gegenereerd.
OperationName	EventClass_s	De bewerking die is gekoppeld aan de logboekrecord.
CorrelationId		De id voor gecorreleerde gebeurtenissen. Kan worden gebruikt om gecorreleerde gebeurtenissen tussen meerdere tabellen te identificeren.
PowerBIWorkspaceId		Unieke id van de werkruimte met het artefact waarop het artefact wordt uitgevoerd.
PremiumCapacityId		Unieke id van de Premium-capaciteit die als host fungeert voor het artefact waarop het artefact wordt uitgevoerd.
ApplicationContext	ApplicationContext_s	Eigenschappenverzameling met unieke id's die details geven over de toepassing die de aanvraag uitvoert. Bijvoorbeeld rapport-id.
ApplicationName	ApplicationName_s	Bevat de naam van de clienttoepassing die de verbinding met de server heeft gemaakt. Deze kolom wordt gevuld met de waarden die door de toepassing worden doorgegeven in plaats van de weergegeven naam van het programma.
ArtifactId		De unieke id van de resource die de gegevens in logboekregistratie opgeeft.
ArtifactKind		Type artefactregistratie van de bewerking, bijvoorbeeld semantisch model.
CpuTimeMs	CPUTime_s	De hoeveelheid CPU-tijd (in milliseconden) die door de gebeurtenis wordt gebruikt.
ArtifactName	DatabaseName_s	De naam van het Power BI-artefact dat deze bewerking aanmeldt.
LogAnalyticsCategory	Uniek	Categorie van de gebeurtenissen, zoals Controle/Beveiliging/Aanvraag.
DatasetMode		De modus van het semantische model. Importeren, DirectQuery of Samengesteld.
DurationMs	Duration_s	De hoeveelheid tijd (in milliseconden) die door de bewerking wordt genomen.
Gebruiker	User_s	De gebruiker die is gekoppeld aan de actieve bewerking. Wordt gebruikt wanneer een identiteit van een eindgebruiker moet worden geïmiteerd op de server.
ExecutingUser	EffectiveUsername_s	De gebruiker die de bewerking uitvoert.
OperationDetailName	EventSubclass_s	Meer informatie over de bewerking.
XmlaObjectPath	ObjectPath_s	Objectpad. Een door komma's gescheiden lijst met bovenliggende items, te beginnen met het bovenliggende object.
PowerBIWorkspaceName		Naam van de Power BI-werkruimte die het artefact bevat.
StatusCode	Error_s	Statuscode van de bewerking. Het behandelt succes en mislukking.
ProgressCounter	ProgressTotal_s	Voortgangsteller.
XmlaProperties	RequestProperties_s	Eigenschappen van de XMLA-aanvraag.
XmlaSessionId	SPID_s	Analysis Services-sessie-id.
Niveau	Severity_s	Bevat het ernstniveau van de bewerking die wordt geregistreerd. Geslaagd, informatief, waarschuwing of fout.
Identiteit		Informatie over gebruikers en claims.
-Status		Status van de bewerking.
EventText	TextData_s	Bevat uitgebreide informatie die is gekoppeld aan de bewerking, bijvoorbeeld DAX Query.
CustomerTenantId		De Power BI-tenant-id van de klant.
XmlaRequestId	RootActivityId_g	Unieke id van aanvraag.
Replicaid		Replica-id waarmee u de replica kunt identificeren wanneer Query Scale Out (QSO) is ingeschakeld. Replica voor lezen/schrijven heeft altijd ReplicaId='AAA' en alleen-lezen replica's hebben ReplicaId vanaf AAB. Voor niet-QSO ingeschakelde semantische modellen is de ReplicaId altijd 'AAA'

Voorbeeld van KQL-query's in Log Analytics

De volgende verzameling voorbeeldquery's kan handig zijn wanneer u Azure Log Analytics met Power BI gebruikt. Ze kunnen rechtstreeks worden uitgevoerd in Azure Portal of via API's om een query uit te voeren op de meest recente gegevens, meestal ongeveer 5-10 minuten oud.

// log count per day for last 30d
PowerBIDatasetsWorkspace
| where TimeGenerated > ago(30d)
| summarize count() by format_datetime(TimeGenerated, 'yyyy-MM-dd')


// average query duration by day for last 30d
PowerBIDatasetsWorkspace
| where TimeGenerated > ago(30d)
| where OperationName == 'QueryEnd'
| summarize avg(DurationMs) by format_datetime(TimeGenerated, 'yyyy-MM-dd')


//query duration percentiles for a single day in 1 hour bins
PowerBIDatasetsWorkspace
| where TimeGenerated >= todatetime('2021-04-28') and TimeGenerated <= todatetime('2021-04-29')
| where OperationName == 'QueryEnd'
| summarize percentiles(DurationMs, 0.5, 0.9) by bin(TimeGenerated, 1h)


// refresh durations by workspace and semantic model for last 30d
PowerBIDatasetsWorkspace
| where TimeGenerated > ago(30d)
| where OperationName == 'CommandEnd'
| where ExecutingUser contains 'Power BI Service'
| where EventText contains 'refresh'
| project PowerBIWorkspaceName, DatasetName = ArtifactName, DurationMs

// query count, distinctUsers, avgCPU, avgDuration by workspace for last 30d
PowerBIDatasetsWorkspace  
| where TimeGenerated > ago(30d)
| where OperationName == "QueryEnd" 
| summarize QueryCount=count()
    , Users = dcount(ExecutingUser)
    , AvgCPU = avg(CpuTimeMs)
    , AvgDuration = avg(DurationMs)
by PowerBIWorkspaceId

Power BI-voorbeeldrapportsjabloon

Verken en krijg inzichten in Azure Log Analytics Power BI-gegevens met behulp van een opensource Power BI-rapportsjabloon op GitHub.

Gerelateerde inhoud

De volgende artikelen kunnen u helpen meer te weten te komen over Power BI en over de integratie met Azure Log Analytics.

• Azure Log Analytics gebruiken in Power BI
• Azure Log Analytics in Power BI - Veelgestelde vragen
• Wat is Power BI Premium?
• Werkruimten in Power BI