Az Azure Log Analytics konfigurálása a Power BI-hoz

A Power BI integrálva van az Azure Log Analytics szolgáltatással, hogy a rendszergazdák és a prémium szintű munkaterület-tulajdonosok log Analytics-kapcsolatot konfigurálhassanak a Power BI-előfizetésükhöz. Ez a cikk a Log Analytics és a Power BI integrációjának működését, valamint a környezethez való konfigurálását ismerteti.

Az Azure Log Analytics a Power BI-hoz való használatának két eleme van:

  • Az Azure-előfizetés konfigurálása az Azure Portalon.
  • A Power BI naplóelemzésének engedélyezése a Power BI Rendszergazda portálon.

A következő szakaszok végigvezetik a két lépésen.

Screenshot of the Azure connections tab open in the settings pane.

Előfeltételek

Mielőtt konfigurálhatja a Log Analytics-integrációt a Power BI-ból, létre kell hoznia egy Log Analytics-munkaterületet az Azure Portalon. Emellett engedélyt kell adnia az Azure-ban a naplók írására vonatkozó Power BI szolgáltatás. A pontos követelmények a következők:

  • Közreműködői hozzáférés az Azure-előfizetéshez.
  • Regisztrálja a "microsoft.insights" erőforrás-szolgáltatót az Azure-előfizetésben, ahol Power BI-naplóadatokat fog gyűjteni.
  • A Log Analytics-integrációt a Power BI-ban létrehozó felhasználónak a Log Analytics-munkaterület Log Analytics-közreműködői szerepkörében kell lennie. Ha a tulajdonosi szerepkör nem adható meg, tekintse meg a gyakori kérdéseket.

A "microsoft.insights" erőforrás-szolgáltató engedélyezése

A Log Analytics használatához engedélyezni kell a "microsoft.insights" erőforrás-szolgáltatót az Azure-előfizetés szintjén. Az alábbi lépések végigvezetik a folyamaton.

  1. Jelentkezzen be az Azure Portalra, válassza ki a Log Analytics szolgáltatással használni kívánt előfizetést, és tartalmazza a Log Analytics-munkaterületeket. A Gépház szakaszban válassza ki az erőforrás-szolgáltatókat az alábbi képen látható módon.

    Screenshot of the settings menu options, resource providers is selected.

  2. Keressen rá a microsoft.insights kifejezésre az Erőforrás-szolgáltatók területen. Ezután kattintson a Regisztrálás elemre.

    Screenshot of resource providers in the main pane with Microsoft.insights is registered.

Engedélyek beállítása

  1. Győződjön meg arról, hogy a Log Analytics-integrációt konfiguráló felhasználó rendelkezik a Log Analytics-munkaterület Log Analytics-közreműködői szerepkörével. Amikor az Azure Portalon kiválasztja az előfizetés hozzáférés-vezérlését (IAM), majd a panel felső beállításai közül választja ki a szerepkör-hozzárendeléseket , az aktuális felhasználónak egy bejegyzést kell látnia: Log Analytics-közreműködő a Log Analyticset konfiguráló felhasználóhoz:

    Screenshot of the Access control pane with role highlighted.

A lépések elvégzése után az Azure Log Analytics konfigurációs része befejeződött. A következő szakasz bemutatja, hogyan folytathatja és fejezheti be a konfigurációt a Power BI Rendszergazda portálon.

Munkaterületszintű naplózás engedélyezése a Rendszergazda portálról

A Power BI-rendszergazdáknak végre kell hajtaniuk a következő lépést az Azure Log Analytics Power BI Premium-munkaterületekhez való engedélyezéséhez. Ezzel a beállítással a Power BI Premium-munkaterület rendszergazdái elküldhetik a munkaterületi naplóikat az Azure Log Analyticsnek, ha teljesülnek az előfeltételek.

  1. A Power BI Rendszergazda portálon nyissa meg a bérlői Gépház > naplózási és használati beállításokat, és bontsa ki az Azure Log Analytics-kapcsolatokat a munkaterület-rendszergazdák számára. Ha engedélyezni szeretné a munkaterület rendszergazdáinak a Log Analytics engedélyezését, állítsa a csúszkát Engedélyezve értékre, és adja meg a szükséges biztonsági csoportokat az Alkalmaz területen, ahogyan az alábbi képen látható.

    Screenshot of tenant settings in the Admin portal. Azure log analytics connections for workspace administrators is expanded and enabled.

Naplózás konfigurálása prémium szintű munkaterületen

  1. A Prémium munkaterületen a munkaterület rendszergazdái engedélyezhetik a Log Analytics szolgáltatást. Ehhez lépjen Gépház az alábbi képen látható módon.

    Screenshot of the settings pane in a Premium workspace.

  2. A Gépház panelen válassza az Azure-kapcsolatokat, majd bontsa ki a Log Analyticst az alábbi képen látható módon.

    Screenshot of the Azure connections tab open in the settings pane, Log Analytics is expanded.

  3. Válassza ki az Azure-előfizetést, az erőforráscsoportot, majd az előző szakaszban konfigurált Log Analytics-munkaterületet. Ezután válassza a Mentés lehetőséget. Ha sikeresen befejeződött, a kibontott bérlőszintű Log Analytics szakasznak az alábbi képhez hasonlóan kell kinéznie.

    Screenshot of the Azure connections tab open in the settings pane showing sample information.

Az Azure Log Analytics leválasztása

Ha nem szeretne naplókat küldeni az Azure-ba, leválaszthatja a kapcsolatot az Azure Log Analytics szolgáltatásról. A kapcsolat bontásához a Power BI-munkaterület Gépház lépjen a Log Analytics beállításaihoz. Válassza a Leválasztás az Azure-ból lehetőséget. Ezután válassza a Mentés lehetőséget a kapcsolat bontásához.

Screenshot of the disconnect warning on the settings pane.

Feljegyzés

Ha leválaszt egy Power BI-munkaterületet az Azure Log Analyticsről, a naplók nem törlődnek. Az adatok megmaradnak, és követik az ott beállított tárolási és adatmegőrzési szabályzatokat.

Használati forgatókönyvek

Az Azure Log Analytics és a Power BI számos módon segíthet a szervezet valós kihívásainak megoldásában. A következőket kell fontolóra venni:

  • Az Analysis Services-motor tevékenységi időszakainak azonosítása kapacitás, munkaterület, jelentés vagy felhasználó szerint.
  • A lekérdezések teljesítményének és trendjeinek elemzése, beleértve a külső DirectQuery-műveleteket is.
  • A szemantikai modell frissítési időtartamának, átfedéseinek és feldolgozási lépéseinek elemzése.
  • Elemezze a Prémium XMLA-végponttal küldött egyéni műveleteket.

Küldjön nekünk visszajelzést a Power BI-közösség, hogy hogyan használja a naplózást, és hogyan segített a szervezetének.

Hibafeltételek és -feloldások

Az alábbi táblázat a gyakori hibák, az őket kiváltó események és konfigurációk gyűjteményét és a javasolt megoldásokat tartalmazza.

Eseményindító feltétel Típus Üzenet
Nincs engedélye a Log Analytics-munkaterületre való írásra Hiba – nem folytatható A Log Analytics-munkaterület írási engedélyére van szüksége a Power BI-hoz való csatlakozáshoz. A probléma megoldásához lépjen kapcsolatba a szervezet azon személyével, aki azure-előfizetéseket kezel.
Nincs engedélye a Log Analytics-munkaterületfiókba való írásra Hiba – nem folytatható A Log Analytics-munkaterület írási engedélyére van szüksége a Power BI-hoz való csatlakozáshoz.
Nincs hozzáférése azure-előfizetésekhez Hiba – nem folytatható Nincs hozzáférése azure-előfizetésekhez. Kérje meg a szervezet Azure-előfizetéseit kezelő személyt, hogy biztosítson közreműködői hozzáférést vagy magasabb szintű hozzáférést.
Nincs hozzáférése az előfizetésen belüli Azure Log Analytics-munkaterületekhez Hiba – nem folytatható Nincs hozzáférése az Azure Log Analytics-munkaterülethez. Kérje meg a szervezet Azure-előfizetéseit kezelő személyt, hogy vegye fel Önt a Log Analytics-tulajdonosi vagy közreműködői szerepkörbe.
A munkaterületszintű Log Analytics le van tiltva a csatlakozáskor Tájékoztatás Kérje meg a bérlő rendszergazdáját, hogy adjon engedélyt a munkaterület rendszergazdáinak a Log Analytics-munkaterületek csatlakoztatására.
A munkaterületszintű Log Analytics le van tiltva a kapcsolat bontásakor Tájékoztatás A bérlői rendszergazda visszavonta a munkaterület rendszergazdáinak a saját Azure Log Analytics-munkaterületek csatlakoztatására vonatkozó engedélyét. Ha leválasztja a kapcsolatot, nem tud csatlakozni egy másikhoz.

Események és séma

Az Azure Log Analytics engedélyezése után a rendszer elkezdi naplózni a következő eseménykategóriákat. További információ ezekről az eseményekről: Analysis Services Trace Events.

  • AggregateTableRewriteQuery
  • Parancs
  • Holtpont
  • DirectQuery
  • Felderítés
  • Hiba
  • ProgressReport
  • Lekérdezés
  • Munkamenet inicializálása
  • VertiPaq Standard kiadás Query
  • Értesítés

Az alábbi táblázat a sémát ismerteti.

Tulajdonság Meglévő Azure Analysis Services-tulajdonság Leírás
TimeGenerated A napló létrehozásának időbélyege (UTC).
OperationName EventClass_s A naplórekordhoz társított művelet.
Korrelációs azonosító A korrelált események azonosítója. Több tábla közötti korrelált események azonosítására használható.
PowerBIWorkspaceId A munkaterület egyedi azonosítója, amely tartalmazza a műterméket, amelyen dolgozik.
PremiumCapacityId A üzemeltetett összetevőt üzemeltető Premium-kapacitás egyedi azonosítója.
ApplicationContext ApplicationContext_s Egyedi azonosítókat tartalmazó tulajdonságtáska, amely a kérést végrehajtó alkalmazás adatait tartalmazza. például jelentésazonosító.
ApplicationName ApplicationName_s Annak az ügyfélalkalmazásnak a nevét tartalmazza, amely létrehozta a kapcsolatot a kiszolgálóval. Ez az oszlop a program megjelenített neve helyett az alkalmazás által átadott értékekkel van feltöltve.
ArtifactId Az adatokat naplózó erőforrás egyedi azonosítója.
ArtifactKind A művelet naplózásának típusa, például szemantikai modell.
CpuTimeMs CPUTime_s Az esemény által használt processzoridő (ezredmásodpercben).
ArtifactName DatabaseName_s A műveletet naplózó Power BI-összetevő neve.
LogAnalyticsCategory Egyedi Az események kategóriája, például naplózás/biztonság/kérés.
DatasetMode A szemantikai modell módja. Importálás, DirectQuery vagy Összetett.
DurationMs Duration_s A művelet által igénybe vett idő (ezredmásodpercben).
Felhasználó User_s A futó művelethez társított felhasználó. Akkor használatos, ha egy végfelhasználói identitást meg kell adni a kiszolgálón.
ExecutingUser EffectiveUsername_s A műveletet futtató felhasználó.
OperationDetailName EventSubclass_s További részletek a műveletről.
XmlaObjectPath ObjectPath_s Objektum elérési útja. A szülők vesszővel tagolt listája, kezdve az objektum szülőjével.
PowerBIWorkspaceName Az összetevőt tartalmazó Power BI-munkaterület neve.
StatusCode Error_s A művelet állapotkódja. A sikert és a kudarcot ismerteti.
ProgressCounter ProgressTotal_s Folyamatszámláló.
XmlaProperties RequestProperties_s Az XMLA-kérelem tulajdonságai.
XmlaSessionId SPID_s Analysis Services-munkamenet azonosítója.
Szinten Severity_s A naplózott művelet súlyossági szintjét tartalmazza. Sikeres, tájékoztató, figyelmeztetés vagy hiba.
Identitás Információk a felhasználóról és a jogcímekről.
Állapot A művelet állapota.
EventText TextData_s Részletes információkat tartalmaz a művelethez, például a DAX-lekérdezéshez.
CustomerTenantId Az ügyfél Power BI-bérlőazonosítója.
XmlaRequestId RootActivityId_g A kérés egyedi azonosítója.
ReplicaId Replikaazonosító, amely lehetővé teszi a replika azonosítását, ha a lekérdezési horizontális felskálázás (QSO) engedélyezve van. Az írási-olvasási replika mindig ReplicaId='AAA', az írásvédett replikák pedig az "AAB" kezdetű ReplicaId-et indítják el. Nem QSO-kompatibilis szemantikai modellek esetén a ReplicaId mindig "AAA"

Minta Log Analytics KQL-lekérdezések

A mintalekérdezések alábbi gyűjteménye hasznos lehet, ha az Azure Log Analyticset a Power BI-val használja. Ezek futtathatók közvetlenül az Azure Portalon vagy API-kon keresztül a legújabb adatok lekérdezéséhez, általában körülbelül 5–10 percesek.

// 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-jelentéssablon minta

Az Azure Log Analytics Power BI-adatainak megismerése és elemzése nyílt forráskódú Power BI-jelentéssablon használatával a GitHubon.

Az alábbi cikkek segítségével többet tudhat meg a Power BI-ról és az Azure Log Analyticsbe való integrálásáról.