Konfigurowanie usługi Azure Log Analytics dla usługi Power BI

Usługa Power BI integruje się z usługą Azure Log Analytics, aby umożliwić administratorom i właścicielom obszarów roboczych Premium skonfigurowanie połączenia usługi Log Analytics z subskrypcją usługi Power BI. W tym artykule opisano sposób działania integracji usługi Log Analytics z usługą Power BI oraz sposobu konfigurowania jej dla danego środowiska.

Istnieją dwa elementy umożliwiające rozpoczęcie pracy usługi Azure Log Analytics dla usługi Power BI:

• Skonfiguruj subskrypcję platformy Azure w witrynie Azure Portal.
• Włącz usługę Log Analytics dla usługi Power BI w portalu administracyjnym usługi Power BI.

W poniższych sekcjach wykonasz kroki opisane w temacie , aby wykonać oba te czynności.

Wymagania wstępne

Przed skonfigurowaniem integracji usługi Log Analytics z usługi Power BI należy utworzyć obszar roboczy usługi Log Analytics w witrynie Azure Portal. Musisz również udzielić uprawnień na platformie Azure, aby usługa Power BI zapisywać dzienniki. Dokładne wymagania są następujące:

• Dostęp współautora do subskrypcji platformy Azure.
• Zarejestruj dostawcę zasobów "microsoft.insights" w subskrypcji platformy Azure, w której będziesz zbierać dane dziennika usługi Power BI.
• Użytkownik, który konfiguruje integrację usługi Log Analytics w usłudze Power BI, musi należeć do roli Współautor usługi Log Analytics dla obszaru roboczego usługi Log Analytics. Zobacz Często zadawane pytania, aby uzyskać obejścia, jeśli nie można podać roli właściciela.

Włączanie dostawcy zasobów "microsoft.insights"

Usługa Log Analytics wymaga dostawcy zasobów "microsoft.insights" włączonego na poziomie subskrypcji platformy Azure. Poniższe kroki umożliwiają wykonanie tego procesu.

1. Zaloguj się do witryny Azure Portal, wybierz subskrypcję, której chcesz używać z usługą Log Analytics i która zawiera obszary robocze usługi Log Analytics. W sekcji Ustawienia wybierz pozycję Dostawcy zasobów, jak pokazano na poniższej ilustracji.

   

2. Wyszukaj ciąg microsoft.insights w obszarze Dostawcy zasobów. Następnie wybierz pozycję Zarejestruj.

   

Ustawianie uprawnień

1. Upewnij się, że użytkownik konfigurujący integrację usługi Log Analytics ma rolę Współautor usługi Log Analytics w obszarze roboczym usługi Log Analytics. Po wybraniu pozycji Kontrola dostępu (Zarządzanie dostępem i tożsamościami) dla subskrypcji w witrynie Azure Portal, a następnie wybraniu pozycji Przypisania ról z górnej części panelu bieżący użytkownik musi zobaczyć jeden wpis: Współautor usługi Log Analytics dla użytkownika, który konfiguruje usługę Log Analytics:

   

Po wykonaniu tych kroków część konfiguracji usługi Azure Log Analytics zostanie ukończona. W następnej sekcji pokazano, jak kontynuować i ukończyć konfigurację w portalu administracyjnym usługi Power BI.

Zezwalaj na rejestrowanie na poziomie obszaru roboczego z poziomu portalu administracyjnego

Administrator usługi Power BI musi wykonać następujący krok, aby włączyć usługę Azure Log Analytics dla obszarów roboczych usługi Power BI Premium. To ustawienie umożliwia administratorom obszarów roboczych usługi Power BI Premium wysyłanie dzienników obszarów roboczych do usługi Azure Log Analytics po spełnieniu wymagań wstępnych.

1. W portalu administracyjnym usługi Power BI przejdź do pozycji Ustawienia > dzierżawy Inspekcja i ustawienia użycia, a następnie rozwiń węzeł Połączenia usługi Azure Log Analytics dla administratorów obszaru roboczego. Aby zezwolić administratorom obszaru roboczego na włączanie usługi Log Analytics, ustaw suwak na Włączone i określ wymagane grupy zabezpieczeń w obszarze Zastosuj do, jak pokazano na poniższej ilustracji.

   

Konfigurowanie rejestrowania w obszarze roboczym Premium

1. W obszarze roboczym Premium administratorzy obszaru roboczego mogą włączyć usługę Log Analytics. W tym celu przejdź do pozycji Ustawienia , jak pokazano na poniższej ilustracji.

   

2. W okienku Ustawienia wybierz pozycję Połączenia platformy Azure, a następnie rozwiń węzeł Log Analytics , jak pokazano na poniższej ilustracji.

   

3. Wybierz subskrypcję platformy Azure, grupę zasobów, a następnie obszar roboczy usługi Log Analytics skonfigurowany w poprzedniej sekcji. Następnie wybierz polecenie Zapisz. Po pomyślnym zakończeniu rozszerzona sekcja Log Analytics na poziomie dzierżawy powinna wyglądać podobnie do poniższej ilustracji.

   

Odłączanie usługi Azure Log Analytics

Możesz odłączyć się od usługi Azure Log Analytics, aby zatrzymać wysyłanie dzienników na platformę Azure. Aby rozłączyć się, w obszarze Ustawienia obszaru roboczego usługi Power BI przejdź do ustawień usługi Log Analytics . Wybierz pozycję Rozłącz z platformą Azure. Następnie wybierz pozycję Zapisz , aby rozłączyć.

Scenariusze użycia

Istnieje wiele sposobów, na które usługi Azure Log Analytics i Power BI mogą pomóc w rozwiązywaniu rzeczywistych wyzwań dla organizacji. Rozważ następujące źródła:

• Identyfikowanie okresów dużego lub nietypowego działania aparatu usług Analysis Services według pojemności, obszaru roboczego, raportu lub użytkownika.
• Analizowanie wydajności zapytań i trendów, w tym zewnętrznych operacji DirectQuery.
• Analizowanie czasu trwania odświeżania modelu semantycznego, nakładania się i kroków przetwarzania.
• Analizowanie operacji niestandardowych wysyłanych przy użyciu punktu końcowego XMLA w warstwie Premium.

Wyślij nam opinię w Społeczność usługi Power BI, aby dowiedzieć się, jak używasz rejestrowania i jak pomógł Twojej organizacji.

Warunki i rozwiązania błędów

Poniższa tabela zawiera kolekcję typowych błędów, zdarzeń lub konfiguracji, które je wyzwoliły, i sugerowanych rozwiązań.

Zdarzenia i schemat

Po włączeniu usługi Azure Log Analytics rozpocznie się rejestrowanie następujących kategorii zdarzeń. Aby uzyskać więcej informacji na temat tych zdarzeń, zobacz Zdarzenia śledzenia usług Analysis Services.

• AggregateTableRewriteQuery
• Polecenie
• Zakleszczenie
• DirectQuery
• Odnajdywanie
• Błąd
• Raport postępu
• Query
• Inicjowanie sesji
• VertiPaqSEQuery
• Powiadomienie

W poniższej tabeli opisano schemat.

Zdarzenie ExecutionMetrics

Dla każdego żądania odnajdywania, polecenia i zapytania zdarzenie o nazwie ExecutionMetrics jest generowane na końcu żądania. To zdarzenie zawiera metryki wykonywania żądania, które mogą pomóc w bardziej efektywnym diagnozowaniu i rozwiązywaniu problemów. Ślad ExecutionMetrics jest skorelowany z najbliższym [Odnajdywanie|Polecenie|Zapytanie]Zdarzenie końcowe .

Następujące zapytanie KQL pobiera zdarzenia ExecutionMetrics dla wszystkich operacji odświeżania modelu semantycznego w ciągu ostatniego dnia:

let commands = PowerBIDatasetsWorkspace
    | where TimeGenerated > ago(1d)
    | where ArtifactId =~ "[Semantic Model Id]"
    | where OperationName in ("CommandEnd")
    | where EventText contains "<Refresh"
    | project TimeGenerated, ArtifactId, CommandOperationName = OperationName, XmlaRequestId, CorrelationId, CommandText = EventText;
let executionMetrics = PowerBIDatasetsWorkspace        
    | where OperationName == "ExecutionMetrics"
    | project TimeGenerated, XmlaRequestId, CorrelationId, EventText;
commands
| join kind=leftouter executionMetrics on XmlaRequestId

Następujące zapytanie KQL pobiera zdarzenia, które zostały ograniczone w ciągu ostatniego dnia według obszaru roboczego, elementu i użytkownika:

let executionMetrics = PowerBIDatasetsWorkspace
    | where TimeGenerated > ago(1d)    
    | where OperationName == "ExecutionMetrics"    
    | extend eventTextJson = parse_json(EventText)      
    | extend capacityThrottlingMs=toint(eventTextJson.capacityThrottlingMs)
    | where capacityThrottlingMs > 0;
let commands = PowerBIDatasetsWorkspace    
    | where OperationName in ("CommandEnd", "QueryEnd", "DiscoverEnd")    
    | project
        TimeGenerated,
        ExecutingUser,
        ArtifactId,
        PowerBIWorkspaceId,
        CommandOperationName = OperationName,
        XmlaRequestId,
        CorrelationId,
        CommandText = EventText;
commands
| join kind=inner executionMetrics on XmlaRequestId
| project
    TimeGenerated,
    ArtifactId,
    PowerBIWorkspaceId,
    ExecutingUser,
    CommandOperationName,
    XmlaRequestId,
    EventText,
    CommandText,
    capacityThrottlingMs
| summarize countThrottling = count(), avgThrottlingDuration = avg(capacityThrottlingMs) by PowerBIWorkspaceId, ArtifactId, ExecutingUser, CommandOperationName

Statystyki są prezentowane jako tekst JSON we właściwości EventText , zobacz następujące przykłady.

{
    "timeStart": "2024-03-20T12:39:59.681Z",
    "timeEnd": "2024-03-20T13:01:14.241Z",
    "durationMs": 1274559,    
    "vertipaqJobCpuTimeMs": 156,
    "mEngineCpuTimeMs": 9617484,
    "totalCpuTimeMs": 9618469,
    "executionDelayMs": 10,
    "approximatePeakMemConsumptionKB": 1683409,
    "mEnginePeakMemoryKB": 1676816,
    "tabularConnectionTimeoutMs": 18000000,    
    "refreshParallelism": 16,
    "vertipaqTotalRows": 114,
    "intendedUsage": 2
}

{
    "timeStart": "2024-05-07T13:42:21.362Z",
    "timeEnd": "2024-05-07T13:43:30.505Z",
    "durationMs": 69143,
    "datasourceConnectionThrottleTimeMs": 0,
    "directQueryConnectionTimeMs": 3,
    "directQueryIterationTimeMs": 1,
    "directQueryTotalTimeMs": 121872,
    "queryProcessingCpuTimeMs": 16,
    "totalCpuTimeMs": 63,
    "executionDelayMs": 0,
    "approximatePeakMemConsumptionKB": 3632,
    "directQueryTimeoutMs": 225000,
    "tabularConnectionTimeoutMs": 225000,
    "queryDialect": 3,
    "queryResultRows": 67,
    "directQueryRequestCount": 2,
    "directQueryTotalRows": 134
}

W poniższej tabeli opisano wszystkie możliwe właściwości. Nie każda właściwość jest emitowana w każdym zdarzeń, ponieważ zawartość będzie zależeć od żądania i modelu semantycznego.

• Wszystkie czasy trwania i czasy procesora SĄ prezentowane w milisekundach.
• Mogą wystąpić dodatkowe właściwości wykraczające poza te opisane w powyższej tabeli i należy je traktować jako nieudokumentowane i mogą ulec zmianie.

Przykładowe zapytania KQL usługi Log Analytics

Poniższa kolekcja przykładowych zapytań może być przydatna podczas korzystania z usługi Azure Log Analytics z usługą Power BI. Można je uruchamiać bezpośrednio w witrynie Azure Portal lub za pośrednictwem interfejsów API w celu wykonywania zapytań dotyczących najnowszych danych, zazwyczaj około 5–10 minut.

// 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

Przykładowy szablon raportu usługi Power BI

Eksplorowanie i uzyskiwanie szczegółowych informacji na temat danych usługi Power BI w usłudze Azure Log Analytics przy użyciu szablonu raportu usługi Power BI typu open source w usłudze GitHub.

Powiązana zawartość

Poniższe artykuły mogą pomóc ci dowiedzieć się więcej o usłudze Power BI i o integracji z usługą Azure Log Analytics.

• Korzystanie z usługi Azure Log Analytics w usłudze Power BI
• Usługa Azure Log Analytics w usłudze Power BI — często zadawane pytania
• Co to jest usługa Power BI Premium?
• Przestrzenie robocze w Power BI