Configurer Azure Log Analytics pour Power BI

Power BI s’intègre à Azure Log Analytics (LA) pour permettre aux administrateurs et aux propriétaires d’espaces de travail Premium de configurer une connexion Log Analytics à leur abonnement Power BI. Cet article décrit le fonctionnement de l’intégration entre Log Analytics et Power BI ainsi que la façon de le configurer pour votre environnement.

Deux actions doivent être effectuées pour qu’Azure Log Analytics fonctionne pour Power BI :

• Configurer votre abonnement Azure dans le portail Azure.
• Activer Log Analytics pour Power BI dans le portail d’administration Power BI.

Les sections suivantes vont vous guider dans les étapes pour effectuer ces deux actions.

Prérequis

Avant de pouvoir configurer l’intégration de Log Analytics à partir de Power BI, vous devez créer un espace de travail Log Analytics dans le portail Azure. Au sein d’Azure, vous devez également autoriser le service Power BI à écrire dans les journaux. Les impératifs exacts sont les suivants :

• Accès contributeur à l’abonnement Azure.
• Inscrivez le fournisseur de ressources « microsoft.insights » dans l’abonnement Azure où vous allez collecter les données des journaux Power BI.
• L’utilisateur qui configure l’intégration de Log Analytics dans Power BI doit avoir le rôle Contributeur Logs Analytics pour l’espace de travail Log Analytics. Consultez les Questions fréquentes (FAQ) pour obtenir des solutions de contournement si le rôle Propriétaire ne peut pas être attribué.

Activer le fournisseur de ressources « microsoft.insights »

Log Analytics nécessite l’activation du fournisseur de ressources « microsoft.insights » au niveau de l’abonnement Azure. Les étapes suivantes vont vous guider tout au long du processus.

1. Connectez-vous au portail Azure, sélectionnez l’abonnement que vous voulez utiliser avec Log Analytics et qui contient vos espaces de travail Log Analytics. Dans la section Paramètres, sélectionnez Fournisseurs de ressources, comme indiqué dans l’image suivante.

   

2. Recherchez microsoft.insights sous Fournisseurs de ressources. Sélectionnez ensuite Inscription.

   

Définir des autorisations

1. Vérifiez que l’utilisateur qui configure l’intégration de Log Analytics dispose du rôle Contributeur Log Analytics de l’espace de travail Log Analytics. Lorsque vous sélectionnez Contrôle d’accès (IAM) pour l’abonnement dans le Portail Azure, puis que vous sélectionnez Attributions de rôles dans les premières sélections du panneau, l’utilisateur actuel doit voir une entrée : Contributeur Logs Analytics pour l’utilisateur qui configure Log Analytics :

   

Une fois que vous avez effectué ces étapes, la partie Configuration d’Azure Log Analytics est terminée. La section suivante vous montre comment poursuivre et effectuer la configuration dans le portail d’administration Power BI.

Autoriser la journalisation au niveau de l’espace de travail à partir du portail d’administration

Un administrateur Power BI doit effectuer l’étape suivante afin d’activer Azure Log Analytics pour les espaces de travail Power BI Premium. Ce paramètre permet aux administrateurs d’espace de travail Power BI Premium d’envoyer leurs journaux d’espace de travail à Azure Log Analytics une fois les prérequis remplis.

1. Dans le portail d’administration Power BI, accédez à Paramètres du locataire > Paramètres d’audit et d’utilisation et développez Connexions Azure Log Analytics pour les administrateurs d’espace de travail. Pour autoriser les administrateurs d’espace de travail à activer Log Analytics, basculez le curseur sur Activé et spécifiez les groupes de sécurité nécessaires sous Appliquer à, comme indiqué dans l’image suivante.

   

Configurer la journalisation dans un espace de travail Premium

1. Dans l’espace de travail Premium, les administrateurs d’espace de travail peuvent activer Log Analytics. Pour cela, accédez à Paramètres, comme indiqué dans l’image suivante.

   

2. Dans le volet Paramètres, sélectionnez Connexions Azure, puis développez Log Analytics, comme indiqué dans l’image suivante.

   

3. Sélectionnez l’abonnement Azure, le groupe de ressources, puis l’espace de travail Log Analytics configuré dans la section précédente. Puis choisissez Enregistrer. Une fois l’opération réussie, la section Log Analytics au niveau du locataire développée est similaire à l’image suivante.

   

Se déconnecter d’Azure Log Analytics

Vous pouvez vous déconnecter d’Azure Log Analytics pour arrêter l’envoi de journaux à Azure. Pour vous déconnecter, dans Paramètres d’espace de travail Power BI, accédez aux paramètres Log Analytics. Sélectionnez Déconnecter d’Azure. Choisissez ensuite Enregistrer pour vous déconnecter.

Scénarios d’usage

Azure Log Analytics et Power BI peuvent vous aider à résoudre les problèmes réels de votre organisation de nombreuses façons. Tenez compte des éléments suivants :

• Identifiez les périodes d’activité élevées ou inhabituelles du moteur Analysis Services par capacité, espace de travail, rapport ou utilisateur.
• Analysez les tendances et les performances des requêtes, y compris les opérations DirectQuery externes.
• Analysez la durée d’actualisation, les chevauchements et les étapes de traitement du modèle sémantique.
• Analysez les opérations personnalisées envoyées en utilisant le point de terminaison XMLA Premium.

Faites-nous part de votre feedback dans la Communauté Power BI sur la façon dont vous utilisez la journalisation et sur l’aide qu’elle a apportée à votre organisation.

Conditions d’erreur et résolutions

Le tableau suivant fournit un ensemble d’erreurs courantes, les événements ou configurations qui les ont déclenchées ainsi que des suggestions de résolutions.

Événements et schéma

Une fois que vous avez activé Azure Log Analytics, il commence à journaliser les catégories d’événements suivantes. Pour plus d’informations sur ces événements, consultez Événements de trace d’Analysis Services.

• AggregateTableRewriteQuery
• Commande
• Deadlock
• DirectQuery
• Découvrez
• Error
• ProgressReport
• Requête
• Initialisation de la session
• VertiPaqSEQuery
• Notification

Le tableau suivant décrit le schéma.

Événement ExecutionMetrics

Pour chaque requête Discover, Command et Query, un événement nommé ExecutionMetrics est généré à la fin de la requête. Cet événement contient des métriques d’exécution pour la requête, qui peuvent vous aider à diagnostiquer et à résoudre les problèmes plus efficacement. La trace ExecutionMetrics est corrélée avec le plus proche événement [Discover|Command|Query]End.

La requête KQL suivante récupère les événements ExecutionMetrics pour toutes les opérations d’actualisation d’un modèle sémantique effectuées au cours du dernier jour :

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

La requête KQL suivante récupère les événements qui ont été limités au cours du dernier jour par espace de travail, élément et utilisateur :

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

Les statistiques sont présentées sous forme de texte JSON dans la propriété EventText. Voir les exemples suivants.

{
    "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
}

Le tableau suivant décrit toutes les propriétés possibles. Toutes les propriétés ne sont pas émises dans chaque événement, car le contenu dépend de la requête et du modèle sémantique.

• Toutes les durées et temps processeur sont présentés en millisecondes.
• Des propriétés supplémentaires au-delà de celles décrites dans le tableau ci-dessus peuvent être rencontrées, et elles doivent être considérées comme non documentées et susceptibles de changer.

Exemples de requêtes KQL Log Analytics

La collection suivante d’exemples de requêtes peut être utile quand vous utilisez Azure Log Analytics avec Power BI. Elles peuvent être exécutées directement dans le portail Azure ou via des API pour interroger les données les plus récentes, généralement des 5 à 10 dernières minutes.

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

Exemple de modèle de rapport Power BI

Explorez et obtenez des insights sur les données Power BI Azure Log Analytics à l’aide d’un modèle de rapport Power BI open source sur GitHub.

Contenu connexe

Les articles suivants peuvent vous permettre d’en savoir plus sur Power BI et sur son intégration à Azure Log Analytics.

• Utilisation d’Azure Log Analytics dans Power BI
• Azure Log Analytics dans Power BI – FAQ
• Qu’est-ce que Power BI Premium ?
• Espaces de travail dans Power BI