Surveiller et optimiser les performances de la passerelle de données locale

Surveillance des performances de la passerelle (préversion publique)

Pour surveiller les performances, les administrateurs de passerelles s’appuyaient traditionnellement sur la surveillance manuelle des compteurs de performances via l’outil Analyseur de performances Windows. Nous proposons désormais une journalisation supplémentaire des requêtes et un fichier de modèle PBI des performances de la passerelle pour visualiser les résultats. Cette fonctionnalité offre de nouveaux insights sur l’utilisation de la passerelle. Vous pouvez l’utiliser pour résoudre les problèmes des requêtes lentes.

Journalisation des performances

Cette fonctionnalité est désormais activée par défaut.

Configurer la journalisation des performances

Il existe d’autres valeurs dans le fichier de configuration C:\Program Files\On-premises data gateway\Microsoft.PowerBI.DataMovement.Pipeline.GatewayCore.dll.config que vous pouvez mettre à jour au besoin :

• ReportFilePath : détermine le chemin où les quatre fichiers journaux sont stockés. Par défaut, ce chemin est \Users\PBIEgwService\AppData\Local\Microsoft\On-premises data gateway\Report ou \Windows\ServiceProfiles\PBIEgwService\AppData\Local\Microsoft\On-premises data gateway\Report. Le chemin d’accès dépend de la version du système d’exploitation. Si vous utilisez un compte de service pour la passerelle autre que PBIEgwService, remplacez cette partie du chemin d’accès par le nom du compte de service.
• ReportFileCount : détermine le nombre de fichiers journaux de chaque type à conserver. La valeur par défaut est 10.
• ReportFileSizeInBytes : détermine la taille du fichier à conserver. La valeur par défaut 104,857,600.
• QueryExecutionAggregationTimeInMinutes : détermine le nombre de minutes pendant lesquelles les informations d’exécution des requêtes sont agrégées. La valeur par défaut est 5.
• SystemCounterAggregationTimeInMinutes : détermine le nombre de minutes pendant lesquelles le compteur système est agrégé. La valeur par défaut est 5.

Après avoir apporté les modifications au fichier de configuration, redémarrez la passerelle pour que ces valeurs de configuration prennent effet. Les fichiers de rapport sont maintenant générés à l’emplacement que vous avez spécifié pour ReportFilePath.

Comprendre les journaux de performances

Quand vous activez cette fonctionnalité, quatre nouveaux fichiers journaux sont créés :

• Le rapport d’exécution de la requête
• Le rapport de démarrage de la requête
• Le rapport d’agrégation de l’exécution de la requête
• Le rapport d’agrégation du compteur système

Le rapport d’exécution de la requête contient des informations détaillées sur l’exécution de la requête. Les attributs suivants sont capturés.

Le rapport de démarrage de la requête contient la requête et l’heure de début de la requête. Les attributs suivants sont capturés.

Le rapport d’agrégation de l’exécution de la requête contient les informations de requête agrégées sur un intervalle de temps par GatewayObjectId, DataSource, Success et QueryType. La valeur par défaut est de 5 minutes, mais vous pouvez la changer. Les attributs suivants sont capturés.

Le rapport d’agrégation du compteur système contient des valeurs de compteur système agrégées sur un intervalle de temps. La valeur par défaut est de 5 minutes, mais vous pouvez la changer. Les attributs suivants sont capturés.

Visualiser les performances de la passerelle

Maintenant, vous pouvez visualiser les données contenues dans les fichiers journaux.

1. Téléchargez le modèle PBI des performances de la passerelle et ouvrez-le à l’aide de Power BI Desktop.

2. Dans la boîte de dialogue qui s’ouvre, vérifiez que le chemin d’accès du dossier correspond à la valeur du champ ReportFilePath.

   

3. Sélectionnez Charger et le fichier modèle commence à charger les données à partir de vos fichiers journaux. Tous les visuels sont remplis à l’aide des données des rapports.

4. Vous pouvez également enregistrer ce fichier au format PBIX et le publier sur votre service pour des actualisations automatiques. Si vous souhaitez en savoir plus, veuillez consulter la rubrique Publier des modèles sémantiques et des rapports depuis Power BI Desktop.

Vous pouvez également personnaliser ce fichier de modèle en fonction de vos besoins. Pour plus d’informations sur les modèles Power BI, consultez ce billet de blog Microsoft Power BI.

Surveillance du stockage en file d’attente

Par défaut, le stockage en file d’attente pour la passerelle se trouve à l’emplacement suivant : C:\Users\PBIEgwService\AppData\Local\Microsoft\Passerelle de données locale\Spooler. Veillez à surveiller cet emplacement pour vous assurer qu’il y a suffisamment d’espace disque libre. Plus d’informations : Données de mise en file d’attente de la passerelle

Requêtes lentes

Les requêtes lentes peuvent nécessiter une modification supplémentaire de votre source de données ou une optimisation supplémentaire de la requête elle-même. Il peut s’agir d’actualisations Power BI ou de requêtes de base de données directes, telles que Power BI DirectQuery, Power Apps ou Azure Logic Apps.

Par défaut, la passerelle procède à une journalisation de base. Si vous étudiez des requêtes lentes, en plus d’utiliser la fonction de surveillance des performances, vous pouvez temporairement activer Journalisation supplémentaire pour recueillir des informations de journal supplémentaires, y compris les journaux du moteur de mashup, les chaînes de requête et la traçabilité au niveau verbeux. Ces journaux sont écrits au même endroit que vos journaux de passerelle normaux. Pour ce faire, dans l’application de la passerelle de données locale, sélectionnez Diagnostic>Journalisation supplémentaire.

Selon l’utilisation de la passerelle, l’activation de ce paramètre peut considérablement augmenter la taille du journal. Nous recommandons, une fois les journaux consultés, de désactiver la journalisation supplémentaire. Nous vous déconseillons de laisser ce paramètre activé dans le cadre de l’utilisation normale de la passerelle.

Optimiser les performances en diffusant en continu des données

Par défaut, la passerelle de données locale enregistre les données sur un support intermédiaire avant de les renvoyer vers le modèle sémantique, ce qui peut potentiellement ralentir les performances pendant les opérations de chargement et d’actualisation des données. Le comportement par défaut peut être substitué.

1. Dans le fichier C:\Program Files\On-Premises data gateway\Microsoft.PowerBI.DataMovement.Pipeline.GatewayCore.dll.config, définissez le paramètre StreamBeforeRequestCompletes sur True, puis enregistrez-le.

   <setting name="StreamBeforeRequestCompletes" serializeAs="String">
      <value>True</value>
   </setting>
   

2. Dans Passerelle de données locale>Paramètre de service, redémarrez la passerelle.

Optimiser les performances en excluant des dossiers spécifiques de l’analyse antivirus

Pour éviter des impacts potentiels sur les performances, certains dossiers peuvent être exclus de l’analyse antivirus quand vous utilisez un logiciel antivirus au niveau des fichiers sur le serveur où une passerelle de données locale est installée. Si ces dossiers ne sont pas exclus, vous pourriez constater des impacts sur les performances et potentiellement d’autres comportements inattendus, car ces dossiers font l’objet d’une grande quantité d’opérations d’écriture et constituent en fait des pipelines de données de la passerelle de données locale.

Dossiers susceptibles d’être exclus de l’analyse antivirus sur le serveur de la passerelle de données locale

• Répertoire de journalisation : Lecteur:\Windows\ServiceProfiles\ CompteService \AppData\Local\Microsoft\On-premises data gateway
• Répertoire de stockage de file d’attente : Lecteur:\Windows\ServiceProfiles\ CompteService \AppData\Local\Microsoft\On-premises data gateway\Spooler

Étapes suivantes

• Outils de dépannage