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.

Remarque

Quand vous déconnectez un espace de travail Power BI d’Azure Log Analytics, les journaux ne sont pas supprimés. Vos données restent, et suivent les stratégies de stockage et de conservation que vous définissez ici.

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.

Condition de déclencheur	Type	Message
Vous n’avez pas l’autorisation d’écrire dans l’espace de travail Log Analytics	Erreur - Impossible de continuer	Vous devez disposer d’autorisations d’accès en écriture sur cet espace de travail Log Analytics pour pouvoir le connecter à Power BI. Contactez la personne de votre organisation qui gère les abonnements Azure pour résoudre ce problème.
Vous n’avez pas l’autorisation d’écrire dans le compte de l’espace de travail Log Analytics	Erreur - Impossible de continuer	Vous devez disposer d’autorisations d’accès en écriture sur cet espace de travail Log Analytics pour pouvoir le connecter à Power BI.
Vous n’avez accès à aucun abonnement Azure	Erreur - Impossible de continuer	Vous n’avez accès à aucun abonnement Azure. Demandez à la personne qui gère les abonnements Azure dans votre organisation de vous octroyer un accès de contributeur ou supérieur.
Vous n’avez accès à aucun espace de travail Azure Log Analytics dans cet abonnement	Erreur - Impossible de continuer	Vous n’avez accès à aucun espace de travail Azure Log Analytics. Demandez à la personne qui gère les abonnements Azure dans votre organisation de vous ajouter au rôle de propriétaire ou de contributeur Log Analytics.
Log Analytics au niveau de l’espace de travail est désactivé au moment de la tentative de connexion	Information	Demandez à votre administrateur de locataire d’octroyer aux administrateurs d’espace de travail l’autorisation de connecter des espaces de travail Log Analytics.
Log Analytics au niveau de l’espace de travail est désactivé au moment de la tentative de déconnexion	Information	Votre administrateur de locataire a révoqué l’autorisation permettant aux administrateurs d’espace de travail de connecter leurs propres espaces de travail Azure Log Analytics. Si vous vous déconnectez, vous ne pouvez pas vous connecter à un autre.

É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.

Propriété	Propriété Azure Analysis Services existante	Description
TimeGenerated		Horodatage (UTC) de la génération du journal.
OperationName	EventClass_s	Opération associée à l’enregistrement de journal.
CorrelationId		ID des événements corrélés. Peut être utilisé pour identifier les événements corrélés entre plusieurs tables.
PowerBIWorkspaceId		Identificateur unique de l’espace de travail qui contient l’artefact utilisé.
PremiumCapacityId		Identificateur unique de la capacité Premium qui héberge l’artefact utilisé.
ApplicationContext	ApplicationContext_s	Conteneur des propriétés d’identificateurs uniques fournissant des détails sur l’application qui exécute la requête. par exemple ID de rapport.
ApplicationName	ApplicationName_s	Contient le nom de l'application cliente qui a créé la connexion au serveur. Cette colonne est remplie avec les valeurs passées par l'application plutôt que par le nom affiché du programme.
ArtifactId		Identificateur unique de la ressource qui journalise les données.
ArtifactKind		Type d’artefact qui journalise l’opération, par exemple modèle sémantique.
CpuTimeMs	CPUTime_s	Temps processeur (en millisecondes) utilisé par l'événement.
ArtifactName	DatabaseName_s	Nom de l’artefact Power BI qui journalise cette opération.
LogAnalyticsCategory	Unique	Catégorie des événements, par exemple Audit/Security/Request.
DatasetMode		Mode du modèle sémantique. Import, DirectQuery ou Composite.
DurationMs	Duration_s	Durée (en millisecondes) de l’opération.
Utilisateur	User_s	L’utilisateur associé à l’opération en cours d’exécution. Propriété utilisée quand l’identité d’un utilisateur final doit être empruntée sur le serveur.
ExecutingUser	EffectiveUsername_s	L’utilisateur exécutant l’opération.
OperationDetailName	EventSubclass_s	Plus de détails sur l’opération.
XmlaObjectPath	ObjectPath_s	Chemin d'accès de l'objet. Liste de parents séparés par une virgule, commençant par le parent de l'objet.
PowerBIWorkspaceName		Nom de l’espace de travail Power BI qui contient l’artefact.
StatusCode	Error_s	Code d’état de l’opération. Il couvre les réussites et les échecs.
ProgressCounter	ProgressTotal_s	Compteur de progression.
XmlaProperties	RequestProperties_s	Propriétés de la requête XMLA.
XmlaSessionId	SPID_s	Identificateur de session Analysis Services.
Niveau	Severity_s	Contient le niveau de gravité de l’opération journalisée. Success (réussite), Informational (informations), Warning (avertissement) ou Error (erreur).
Identité		Informations sur l’utilisateur et les revendications.
État		État de l’opération.
EventText	TextData_s	Contient des informations détaillées associées à l’opération, par exemple Requête DAX.
CustomerTenantId		Identificateur de locataire Power BI du client.
XmlaRequestId	RootActivityId_g	Identificateur unique de la requête.
ReplicaId		Identificateur de réplica qui vous permet d’identifier le réplica lorsque Scale-out des requêtes (QSO) est activé. Un réplica en lecture-écriture a toujours ReplicaId='AAA' et des réplicas en lecture seule ont ReplicaId commençant par « AAB ». Pour les modèles sémantiques non compatibles QSO, le ReplicaId est toujours « AAA »

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