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.

Avant de commencer, utilisez la console pour configurer vos agents Data Gateway. Voir Configurer et enregistrer Data Gateway pour la production de rapports.

Cliquez sur Navigateur pour accéder aux pages de Data Gateway.

Description de GUID-12258C9F-20C9-4812-AED5-9A886A025BFE-default.png ci-après
.png

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 diagnostiquer les problèmes, vous effectuez généralement une recherche par date ou statut de travail :
  • 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.
Description de GUID-0476B3A6-F490-44F2-B7D4-E1EDE0FD0B49-default.png ci-après
.png

Cliquez sur un travail pour voir les informations de statut détaillées le concernant.
Description de GUID-DDFD4D08-83CA-4134-A739-517DE4EBBC0B-default.png ci-après
.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.
Description de GUID-B3F74324-7D86-492D-AF32-DD13F152A57F-default.png ci-après
.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.
Description de GUID-D263ECAE-DE5F-4FC7-8A4E-D468B24E0A90-default.png ci-après
.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 "REQUEST FINISHED WITH ERRORS" et si vous cliquez sur les demandes, vous voyez "[JDSError : 110] JDS - Invalid connect string / URL to external source, Cause: Invalid Oracle URL specified".

Solution de rechange :

  1. Modifiez le fichier <Data Gateway Install Directory>/oracle_common/jdk1.8.0_333/jre/lib/security/java.security.
  2. Localisez ce texte (aux environs de la ligne numéro 720) :

    jdk.tls.disabledAlgorithms=SSLv3, TLSv1, TLSv1.1, RC4, DES, MD5withRSA, \

  3. Modifiez-le à :

    jdk.tls.disabledAlgorithms=SSLv3, TLSv1, RC4, DES, MD5withRSA, \

  4. Redémarrez l'agent à l'aide de <Data Gateway Install Directory>/domain/bin/stopJetty.sh, puis <Data Gateway Install Directory>/domain/bin/startJetty.sh.
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.


Description de GUID-993A05E7-934B-4EFE-A233-29A85B823B8C-default.png ci-après
.png

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 https://<instance details>.oraclecloud.com/dv/ui, spécifiez cette URL : https://<instance details>.oraclecloud.com.

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)

  • Vérifiez si vous avez activé et configuré Data Gateway dans la console Oracle Analytics Cloud.
  • Assurez-vous de pouvoir accéder à l'URL d'Oracle Analytics Cloud depuis l'environnement dans lequel Data Gateway est exécuté. Par exemple, sous Linux vous pouvez utiliser une commande traceroute, telle que sudo traceroute -T -p 443 <Fully qualified domain name of your Oracle Analytics Cloud instance>.
  • Vérifiez que rien d'autre ne bloque la communication à travers le pare-feu.
  • Si vous utilisez un mandataire, naviguez jusqu'à la page Accueil dans l'agent Data Gateway et vérifiez les paramètres suivants pour le mandataire : Hôte, Port, Utilisateur et Mot de passe.
Ralentissement de la performance Révisez la page Journaux et effectuez une recherche par :
  • date
  • travaux en échec
  • ID travail
  • 'DISTANT'

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 :

  • 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.
  • 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.
  • Il n'y a pas de route réseau appropriée de l'agent Data Gateway vers Oracle Analytics Cloud.