Dépanner Data Gateway
Dans un agent Data Gateway, utilisez les options du navigateur Data Gateway pour afficher les pages Statut, Journaux et Interrogation afin de surveiller le trafic de connexion distante et dépanner les problèmes courants de connectivité et de performance.
Diagnostic des problèmes de connexion à l'aide de la page Statut
Utilisez cette page pour réviser les demandes de base de données effectuées par un agent Data Gateway avec la base de données distante.
Dans un agent Data Gateway, cliquez sur Navigateur, puis sur Statut pour réviser les demandes de base de données.
- Pour effectuer une recherche par date, dans le champ Rechercher une demande, entrez la totalité ou une partie de la date et de l'heure au format "AAAA-MM-JJ HH-MM-SS". Par exemple, entrez "2022-03-28" pour rechercher les entrées du 28 mars 2022.
- Pour rechercher des travaux en échec, dans le champ Rechercher une demande, entrez "Demande terminée avec des erreurs".
Effacez le champ Rechercher une demande pour vérifier tous les travaux.
.png
Cliquez sur un travail pour voir les informations de statut détaillées le concernant.
.png
Diagnostic des problèmes de connexion à l'aide de la page Journaux
Utilisez cette page pour vérifier les entrées de journal d'un agent Data Gateway afin de pouvoir analyser le trafic de connexion.
Dans un agent Data Gateway, cliquez sur Navigateur, puis sur Journaux pour réviser les entrées de journal. Activez l'option Activer la scrutation des journaux et sélectionnez un niveau de journalisation approprié. Par exemple, pour diagnostiquer des problèmes de connexion, vous pouvez régler Type de journal à Déboguer.
.png
Oracle recommande de désactiver l'option Activer la scrutation des journaux ou d'ajuster le type de journal lorsque vous avez terminé le dépannage pour saisir moins d'informations.
Diagnostic des problèmes de connexion à l'aide de la page Interrogation
Utilisez cette page pour interroger une base de données distante à partir d'un agent Data Gateway afin de tester la connexion et d'évaluer la performance.
Dans un agent Data Gateway, cliquez sur Navigateur, puis sur Interrogation afin d'exécuter un énoncé SQL directement à partir de l'agent Data Gateway sur la base de données (sur place). Par exemple, vous pouvez copier la chaîne d'interrogation, la chaîne de connexion et la classe de pilote provenant d'un travail en échec répertorié dans la page Statut. Indiquez les données d'identification de base de données et exécutez l'interrogation pour réviser le résultat et les statistiques de performance (temps d'exécution). Note : La base de données distante doit prendre en charge la connexion à l'aide d'une chaîne de connexion JDBC.
.png
Problèmes et conseils relatifs à la connectivité distante
Voici quelques problèmes de connectivité susceptibles de se produire et les conseils relatifs à leur résolution.
Problèmes liés aux tableaux de bord et aux analyses
| Problème signalé | Effectuer cette action |
|---|---|
| Code d'erreur 603 - Aucun agent n'est connecté |
Vérifiez que l'agent Data Gateway est en cours d'exécution et activé dans la page Configuration de Data Gateway. Avec Data Gateway sur Linux : Exécutez $ <Data Gateway Install Directory>/domain/bin/status.sh et vérifiez si "Data Gateway Status" indique UP ou DOWN. Avec Data Gateway sur Windows : Dans l'onglet Détails du gestionnaire des tâches, recherchez les processus "datagateway.exe". |
| [nQSError: 77031] Une erreur se produit lors de l'appel du service distant DatasourceService. Détails : [JDSError : 78] Erreur liée à une URL incorrecte | Révisez la réserve de connexions dans le modèle sémantique et vérifiez les paramètres dans l'onglet Général et les onglets Divers. |
Problèmes liés aux connexions ou aux jeux de données
| Problème signalé | Effectuer cette action |
|---|---|
| Code d'erreur 603 - Aucun agent n'est connecté | Vérifiez que l'agent Data Gateway est en cours d'exécution. Avec Data Gateway sur Linux : Exécutez$ <Data Gateway Install Directory>/domain/bin/status.sh vérifiez si "Data Gteway Status" indique UP ou DOWN. Pour les agents Data Gateway sur Windows, dans l'onglet Détails du gestionnaire des tâches, recherchez les processus "datagateway.exe". |
| Échec de l'enregistrement de la connexion. Des détails de connexion non valides ont été fournis. Entrez de nouveau les détails corrects et réessayez. | Vous voyez cette erreur dans la boîte de dialogue Connexion lorsque vous créez une connexion à DB2 ou à SQL Server.
Dans la page Statut de l'agent, vous voyez également Solution de rechange :
|
| JDSError : 110 - La chaîne/l'URL de connexion à la source externe n'est pas valide | Vérifiez que l'agent Data Gateway peut se connecter à la source de données. Par exemple, si vous vous connectez à une base de données Oracle, puis effectuez un test à l'aide de "telnet <hostname> <port>" sur l'ordinateur où Data Gateway est installé. |
| Aucune colonne n'est affichée | Mettez à niveau votre agent Data Gateway. Ce problème se produit généralement si vous utilisez une mise à jour antérieure de l'agent Data Gateway qui ne concorde pas avec votre mise à jour d'Oracle Analytics Cloud. |
| L'option Utiliser la connectivité de données distante est manquante |
Vérifiez que l'option Activer Data Gateway est activée dans la page Connectivité de données distante de la console. |
Problèmes généraux
| Problème signalé | Effectuer cette action |
|---|---|
| La modification de l'état de l'agent a échoué avec une erreur : nom d'agent ou URL Oracle Analytics Cloud non indiqués ou paire de clés non générée | Cliquez sur Enregistrer, puis sur Activer. Si le problème persiste, redémarrez l'application. Au besoin, vérifiez votre réseau. |
| L'authentification a échoué avec une erreur : le code 401" est retourné à l'issue du test. Les raisons possibles sont les suivantes :
- La clé de l'agent Data Gateway n'a pas été copiée dans la page Connectivité de données distante de la console Oracle Analytics Cloud Par exemple, vous avez peut-être cliqué sur le bouton Tester avant de coller la clé dans la page Connectivité de données distante de la console OAC. - La clé de l'agent Data Gateway a été de nouveau générée mais la nouvelle clé n'a pas été copiée dans la page Connectivité de données distante de la console Oracle Analytics Cloud. Par exemple, vous avez peut-être déjà enregistré un agent Data Gateway dans la page Connectivité de données distante de la console mais son ID ne correspond pas à celui de la clé définie dans la page d'accueil de l'agent Data Gateway. |
Si la clé de l'agent Data Gateway n'a pas été copiée, collez la clé dans la console pour enregistrer l'agent. Si la clé de l'agent Data Gateway a été de nouveau générée, supprimez celui-ci dans la console, puis collez la clé dans la console pour l'enregistrer de nouveau. |
| L'authentification a échoué avec une erreur : le code 404" est retourné à l'issue de l'enregistrement.
Cette erreur se produit généralement lorsque l'instance Oracle Analytics a été mise à jour. |
Voir : - Conseils relatifs à l'utilisation de Remote Data Gateway dans des environnements mis à niveau depuis Oracle Analytics Cloud 105.2 ou une version antérieure (ID documentation 2574387.1) - Oracle Analytics Cloud - Version classique : Comment activer Remote Data Gateway dans une instance classique d'Oracle Analytics Cloud gérée par le client mise à niveau depuis la version 105.2 ou une version antérieure (ID documentation ID 2632064.1). |
| URL OAC non valide /Exception d'hôte inconnu ou aucune erreur/aucun message n'est retourné à l'issue du test.
Les raisons possibles sont les suivantes : - Une URL incorrecte est spécifiée dans la page d'accueil de l'agent Data Gateway. Par exemple, vous avez peut-être fourni une URL telle que https://oacinst-tenancy.analytics.ocp.oraclecloud.com/dv/ui or https://oacinst-tenancy.analytics.ocp.oraclecloud.com/analytics - Il n'y a pas de route réseau appropriée de l'agent Data Gateway vers l'instance Oracle Analytics Cloud. Par exemple, vous avez peut-être un serveur mandataire pour l'accès Internet et un pare-feu bloque l'accès de l'agent Data Gateway vers Oracle Analytics Cloud. Si aucun serveur mandataire n'est requis, confirmez la connectivité entre l'ordinateur où Data Gateway est exécuté et Oracle Analytics Cloud. |
Si une URL incorrecte est spécifiée dans la page d'accueil de l'agent Data Gateway, mettez à jour l'URL dans le champ URL. Par exemple, si l'URL Oracle Analytics Cloud URL est Il n'y a pas de route réseau appropriée de l'agent Data Gateway vers l'instance Oracle Analytics Cloud : - Sous Linux, exécutez la commande $ sudo traceroute -T -p 443 https://<instance details>.oraclecloud.com - Sous Windows, émettez la commande C:\> telnet https://<instance details>.oraclecloud.com 443. Si un serveur mandataire est requis, vérifiez les détails de serveur mandataire pour Data Gateway. Voir URL d'Oracle Analytics Cloud non valide (Data Gateway ne peut pas communiquer avec Oracle Analytics Cloud). |
|
URL d'Oracle Analytics Cloud non valide (Data Gateway ne peut pas communiquer avec Oracle Analytics Cloud) |
|
| Ralentissement de la performance | Révisez la page Journaux et effectuez une recherche par :
Une fois que vous avez trouvé des entrées de journal, cliquez sur un travail et vérifiez la boîte de dialogue Statut de la demande pour voir le temps d'exécution en millisecondes. Demandez des conseils relatifs au dimensionnement de Data Gateway à l'équipe chargée du compte de ventes. |
| Le test échoue dans la page Connectivité de données distante de la console |
Si le test échoue, l'agent Data Gateway ne peut pas s'authentifier pour diverses raisons, notamment :
|
