Résoudre les problèmes de passerelle de données locale

Cet article traite de certains problèmes courants rencontrés lors de l’utilisation de la passerelle de données locale.

Notes

Si vous rencontrez un problème qui n’est pas répertorié ici, créez un ticket de support pour le service cloud particulier qui exécute la passerelle.

Mettre à jour avec la dernière version

Nous vous recommandons de vérifier que vous possédez bien une version prise en charge. Nous publions une nouvelle mise à jour pour les passerelles de données locales chaque mois. Actuellement, Microsoft ne prend en charge que les six dernières versions de la passerelle de données locale. Si vous rencontrez des problèmes avec la version que vous utilisez, essayez de passer à la dernière version, car votre problème a peut-être été résolu dans la dernière version.

Versions incohérentes entre les membres de la passerelle dans un cluster

Veillez à assurer la synchronisation des versions des membres de la passerelle dans un cluster. Le fait d’avoir la même version dans un cluster permet d’éviter les échecs d’actualisation inattendus. Ces échecs d’actualisation peuvent se produire, car le membre de passerelle vers lequel une requête spécifique est acheminée peut ne pas être en mesure de l’exécuter en raison d’une version inférieure.

Résoudre les problèmes de gestion de passerelle

Voici quelques problèmes de gestion courants et les résolutions qui ont aidé d’autres clients.

Erreur lors de la suppression du nœud principal d’un cluster de passerelle

Le nœud principal d’une passerelle ne peut pas être supprimé s’il y a d’autres membres dans le cluster. La suppression du nœud principal signifie également la suppression du cluster de passerelle.

Résoudre les problèmes d’installation courants

Voici quelques problèmes d’installation courants et les résolutions qui ont aidé d’autres clients.

Erreur : Impossible d’ajouter l’utilisateur au groupe. (-2147463168 PBIEgwService Utilisateurs du journal de performances)

Vous pouvez recevoir cette erreur si vous essayez d’installer la passerelle sur un contrôleur de domaine. Le déploiement sur un contrôleur de domaine n’est pas pris en charge. Vous devrez déployer la passerelle sur un ordinateur qui ne joue pas le rôle de contrôleur de domaine.

Logiciel antivirus obsolète

Vous pouvez rencontrer des échecs d’installation si le logiciel antivirus sur l’ordinateur d’installation est obsolète. Vous pouvez mettre à jour l’installation de l’antivirus, ou désactiver l’antivirus seulement pendant la durée de l’installation de la passerelle. Une fois l’installation terminée, réactivez le logiciel antivirus.

Logiciel McAfee Endpoint Defender activé

Vous pourriez rencontrer un échec d’installation lors de l’activation du logiciel antivirus, comme McAfee Endpoint Defender. Configurez votre logiciel antivirus pour ignorer le processus de passerelle.

Version de passerelle identique ou plus ancienne

Vous pouvez rencontrer l’erreur suivante si vous essayez d’installer la même version ou une version précédente de la passerelle par rapport à celle que vous avez déjà.

Erreur d’installation de la passerelle.

Erreur : Le profil utilisateur est un profil temporaire

Un problème s’est produit avec la machine. Contactez votre équipe informatique interne pour supprimer le profil temporaire.

Configuration de la résolution des problèmes

Pare-feu ou proxy

Pour tester si la passerelle a accès à tous les ports requis, exécutez le test des ports réseau. Les deux résultats possibles sont Terminé (réussite) et Terminé (échec, voir les derniers résultats des tests). Si le test a réussi, cela signifie que votre passerelle s’est connectée avec succès à tous les ports nécessaires. Si le test a échoué, cela signifie que votre environnement peut bloquer ces ports et ces serveurs nécessaires.

Pour plus d’informations sur la fourniture d’informations de proxy pour votre passerelle, consultez Configurer les paramètres de proxy pour les passerelles de données locales.

Le pare-feu peut également bloquer les connexions effectuées par Azure Service Bus vers les centres de données Azure. Si tel est le cas, débloquez les adresses IP de votre région pour ces centres de données. Vous pouvez obtenir une liste des adresses IP Azure depuis ce site Web. Pour trouver la région actuelle du centre de données dans laquelle vous vous trouvez, consultez Définir la région du centre de données.

Authentification auprès du serveur proxy

Votre proxy peut nécessiter l’authentification à partir d’un compte utilisateur de domaine. Par défaut, la passerelle utilise un SID de service pour l’utilisateur de connexion au service Windows. Remplacer l’utilisateur de connexion par un utilisateur de domaine peut vous y aider. Pour plus d’informations, voir Remplacer le compte de service de passerelle par un utilisateur de domaine.

Votre proxy autorise uniquement le trafic vers les ports 80 et 443.

Certains proxys limitent le trafic aux ports 80 et 443. Par défaut, la communication avec Azure Service Bus a lieu sur des ports différents du port 443.

Vous pouvez forcer la passerelle à communiquer avec Azure Service Bus en utilisant HTTPS au lieu d’une connexion TCP directe.

Le proxy de passerelle ne parvient pas à se connecter à Managed Data Lake

Si vous utilisez un proxy pour accéder aux données local à l’aide d’une passerelle de données local, vous ne pourrez peut-être pas vous connecter à un lac de données géré (MDL) à l’aide des paramètres de proxy par défaut. Pour vous connecter à MDL, assurez-vous d’ajouter des adresses *.dfs.core.windows.net et *.blob.core.windows.net à la liste d’autorisation sur votre serveur proxy.

Erreurs courantes

Erreur : Échec de la création d’une passerelle. Réessayez.

Cette erreur peut également être dues à des problèmes de configuration de proxy. Le journal de la passerelle fournit des détails supplémentaires pour la résolution des problèmes. Pour en savoir plus, voir Configurer des paramètres de proxy pour la passerelle de données locale.

Erreur : Le service Power BI a signalé que la passerelle locale est inaccessible. Redémarrez la passerelle, puis réessayez.

À la fin de la configuration, le service Power BI est rappelé pour valider la passerelle. Le service Power BI ne signale pas la passerelle comme étant active. Un redémarrage du service Windows peut permettre à la communication d’aboutir. Pour obtenir plus de détails, collectez et consultez les journaux, comme décrit dans la section suivante.

Erreur : des informations sont nécessaires pour combiner les données

Vous pouvez rencontrer un échec d’actualisation dans le service Power BI avec une erreur « Des informations sont nécessaires pour combiner des données », même si l’actualisation fonctionne sur Power BI Desktop. Ce problème se produit lorsque l’actualisation dans Power BI Desktop fonctionne avec le groupe d’options Fichier > Options et paramètres > Choix > Confidentialité > Toujours ignorer les paramètres de niveau de confidentialité, mais génère une erreur de pare-feu lorsque d’autres options sont sélectionnées. Si vous tentez d’effectuer cette actualisation dans le service Power BI, l’actualisation ne fonctionnera pas, car Toujours ignorer les paramètres de niveau de confidentialité n’est pas disponible dans le service Power BI. Pour résoudre cette erreur, essayez de modifier le niveau de confidentialité dans les paramètres Power BI Desktop Choix > Général > Confidentialité et Choix > Fichier actuel > Confidentialité afin qu’il n’ignore pas la confidentialité des données. Republiez le fichier sur le service Power BI et mettez à jour les informations d’identification sur « Organisationnel » dans le service Power BI.

Outils de résolution des problèmes

Collecter des journaux à partir de l’application de passerelle de données locale

Il existe plusieurs journaux que vous pouvez collecter pour la passerelle et vous devez toujours commencer avec eux. La façon la plus simple de collecter des journaux après avoir installé la passerelle est via l’application de passerelle de données locale. Dans l’application de passerelle de données locale, sélectionnez Diagnostic, puis le lien Exporter les journaux, comme indiqué dans l’image suivante.

Journaux de l’application de la passerelle de données locale.

Ce fichier est enregistré dans le dossier ODGLogs sur votre bureau Windows au format .zip.

Journaux d’événements

Pour rechercher les journaux des événements pour le service de passerelle de données locale, procédez comme suit :

  1. Sur l’ordinateur avec l’installation de la passerelle, ouvrez l’Observateur d’événements.

  2. Développez Observateur d’événements > Journaux des applications et des services.

  3. Sélectionnez Passerelle de données locale.

Journaux des événements de la passerelle de données locale.

Considérations et limitations

Les API REST des passerelles Power BI ne prennent pas en charge les clusters de passerelles.

Étapes suivantes

Notes

Pouvez-vous nous indiquer vos préférences de langue pour la documentation ? Répondez à un court questionnaire. (veuillez noter que ce questionnaire est en anglais)

Le questionnaire vous prendra environ sept minutes. Aucune donnée personnelle n’est collectée (déclaration de confidentialité).