Dépannage de Direct Access gateway
Cette section décrit plusieurs actions à entreprendre pour résoudre les problèmes rencontrés par Direct Access gateway.
Affichage et téléchargement de fichiers journaux
Les fichiers journaux fournissent des informations sur les opérations Direct Access gateway. Qlik Support peut vous demander de fournir des fichiers journaux à des fins de dépannage. Vous pouvez afficher ou télécharger les fichiers journaux dans la visionneuse du journal. Dans des circonstances normales, il n'y a pas de raison d'examiner les fichiers journaux ; mais si vous rencontrez des échecs répétés ou d'autres problèmes, les fichiers journaux permettront généralement de repérer la cause.
Pour ouvrir la visionneuse du journal :
-
Dans le centre d'activités Administration, accédez à Passerelles de données et repérez votre Direct Access gateway.
-
Cliquez sur
à la fin de la ligne et sélectionnez Afficher les journaux.
La fenêtre Visionneuse du journal s'ouvre.
-
Dans la liste déroulante dans le coin supérieur gauche, sélectionnez le type de journal que Qlik Support vous a demandé d'afficher ou de télécharger.
Les journaux suivants sont disponibles :
- Journaux Direct Access gateway (DirectAccessAgent)
- Journaux DCaaS(dcaas_logs)
- Journaux de connecteur basé sur ODBC (odbc-connector_logs)
- Journaux de connecteur SAP BW (QvSAPBwConnector-<date + horodatage>)
- Journaux de connecteur SAP ODP (QvSapConnectorPackage-<id_de_processus>)
- Journaux de connecteur SAP SQL (QvSqlBwConnector-<date + horodatage>)
- Journaux d'agent de connecteurs (connector-agent_logs_<date>)
-
Dans la liste déroulante adjacente, sélectionnez le journal à afficher ou télécharger. Les fichiers journaux sont triés du plus récent (le fichier journal actuellement actif) au plus ancien. Après avoir sélectionné un fichier journal, vous pouvez utiliser les boutons
et
pour passer au début ou à la fin du fichier journal, respectivement.
Note ConseilLa vue du fichier journal n'est pas mis à jour automatiquement avec les messages les plus récents. Pour mettre la vue à jour, cliquez surpour passer à la fin du fichier journal, qui sera actualisé à l'aide des messages les plus récents.
-
Pour télécharger le fichier journal, cliquez sur Télécharger.
Suivant les paramètres de votre navigateur, le fichier est téléchargé sur votre ordinateur ou vous serez invité à l'enregistrer.
Ouverture des journaux Direct Access gateway sur le poste Direct Access gateway
Outre le fait de pouvoir télécharger les journaux Direct Access gateway (DirectAccessAgent) depuis le centre d'activités Administration, vous pouvez également les ouvrir directement depuis le poste Direct Access gateway. Avec une installation par défaut, ces journaux sont placés dans :
C:\Program Files\Qlik\ConnectorAgent\data\logs
Modification du niveau de journalisation
Vous pouvez modifier le niveau de journalisation des journaux de Direct Access gateway comme décrit ci-dessous.
Modification du niveau de journalisation des composants du connecteur
À des fins de dépannage, vous devrez peut-être modifier le niveau de journalisation des journaux des composants du connecteur.
Pour cela :
- Ouvrez C:\ProgramData\Qlik\Gateway\configuration.properties en tant qu'administrateur. Si vous le faites via Windows Explorer, assurez-vous que l'option Afficher >Éléments masqués est sélectionnée.
-
Recherchez la propriété <COMPONENT>_LOG_LEVEL, où COMPONENT peut être l'une des valeurs suivantes :
- AGENT
- DCAAS
- ODBC
- SAPBW
- SAPSQL
- SAPPACKAGE
- FILE
- Définissez-la sur l'une des valeurs suivantes : ERROR, WARN, INFO ou DEBUG.
-
Enregistrez le fichier configuration.properties et redémarrez le service Qlik Data Gateway - Direct Access.
Note InformationsÀ partir de Direct Access gateway 1.7.1, si vous n'avez modifié que le composant AGENT, vous n'avez pas besoin de redémarrer le service Qlik Data Gateway - Direct Access.
Modification du niveau de journalisation DirectAccessAgent
À des fins de dépannage, vous devrez peut-être modifier le niveau de journalisation des journaux DirectAccessAgent. DirectAccessAgent est responsable de la connexion aux services Qlik Cloud. Pour afficher et modifier le niveau de détail de journalisation des journaux DirectAccessAgent, exécutez les commandes suivantes depuis le sous-dossier ConnectorAgent (C:\Program Files\Qlik\ConnectorAgent\ConnectorAgent avec une installation par défaut) :
-
Pour afficher le niveau de journalisation existant, exécutez :
connectoragent configuration getloggers -
Pour définir le niveau de journalisation sur Trace, exécutez :
connectoragent configuration setloggers -l Root -v DEBUG -
Pour définir le niveau de journalisation sur Verbose, exécutez :
connectoragent configuration setloggers -l Root –v DETAILED_DEBUG
Mise à jour de la clé d'inscription
Il peut être nécessaire de modifier la clé d'inscription en cas de corruption éventuelle de la clé ou si vous pensez qu'un utilisateur non autorisé a accédé au serveur de passerelles de données.
Pour mettre la clé d'inscription à jour :
- Sur le serveur de la passerelle Accès direct, ouvrez une invite de commande en tant qu'administrateur et définissez le répertoire de travail sur le sous-dossier ConnectorAgent (C:\Program Files\Qlik\ConnectorAgent\ConnectorAgent avec une installation par défaut).
-
Exécutez les commandes suivantes :
-
Générez la nouvelle clé :
connectoragent qcs generate_keys
-
Affichez la clé :
connectoragent qcs get_registration
La clé s'affiche :
-
-
Copiez la clé complète, comme indiqué dans l'exemple ci-dessus.
-
Dans le centre d'activités Administration, ouvrez les paramètres de la passerelle de données en cliquant sur le bouton
à la fin de la ligne correspondante et en sélectionnant Modifier.
-
Collez la clé dans le champ Clé (en remplaçant la clé existante) et enregistrez les paramètres.
-
Revenez au serveur de la passerelle Accès direct et redémarrez le service Qlik Data Gateway - Direct Access, comme décrit dans Gestion du service Qlik Data Gateway - Direct Access.
Prolongation de la durée de vie d'une session de chargement
Si la connexion entre Direct Access gateway et Qlik Cloud est inactive pendant au moins 20 secondes, l'opération de chargement peut parfois échouer en affichant l'erreur suivante :
Invalid object name '#<TempTableName>' (indicating that the Direct Access gateway temp tables are unavailable).
La durée de vie par défaut d'une session est de 20 secondes, mais si vous rencontrez souvent cette erreur, vous pouvez prolonger la durée de vie de la session comme suit :
-
Ouvrez C:\ProgramData\Qlik\Gateway\configuration.properties en tant qu'administrateur. Si vous le faites via Windows Explorer, assurez-vous que l'option Show hidden files, folders, and drives (Afficher les fichiers, dossiers et lecteurs masqués) est sélectionnée.
- Recherchez le paramètre ODBC_RELOAD_SESSION_LIFE et augmentez sa valeur en fonction des besoins.
- Enregistrez le fichier configuration.properties et redémarrez le service Qlik Data Gateway - Direct Access.
Extension du délai d'expiration des demandes de chargement
En cas d'interruptions de réseau, il se peut que les chargements échouent avec les erreurs suivantes :
Connector error: The session does not exist (DirectAccess-1509)
Connector error: The stream session expired for the load data request (DirectAccess-1012)
Si vous rencontrez souvent les erreurs ci-dessus, essayez de définir le paramètre EXTEND_FIRST_REQUEST_TIMEOUT sur 5-10 minutes.
Pour effectuer cette action :
-
Ouvrez C:\ProgramData\Qlik\Gateway\configuration.properties en tant qu'administrateur. Si vous le faites via Windows Explorer, assurez-vous que l'option Show hidden files, folders, and drives (Afficher les fichiers, dossiers et lecteurs masqués) est sélectionnée.
- Recherchez le paramètre EXTEND_FIRST_REQUEST_TIMEOUT et augmentez sa valeur à 5-10 minutes. La valeur par défaut est 0.
- Enregistrez le fichier configuration.properties et redémarrez le service Qlik Data Gateway - Direct Access.
Atténuation des plantages de connecteur lors du chargement
L'isolation de processus permet aux administrateurs disposant d'un accès direct au système d'exploitation du serveur de passerelles de contrôler le nombre de processus disponibles pour les chargements par type de connecteur. La diffusion des chargements sur plusieurs processus de connecteur augmente le niveau d'isolement en réduisant le nombre de chargements exécutés simultanément sur chaque processus de connecteur. Cette opération, à son tour, améliore la stabilité générale de Direct Access gateway en cas de plantage de certains connecteurs.
Nécessite Direct Access gateway 1.6.1 ou une version ultérieure.
Désactivation de l'isolation de processus
Le Support Qlik peut vous demander de désactiver l'isolation de processus à des fins de dépannage.
Pour désactiver l'isolation de processus :
- Ouvrez le fichier C:\ProgramData\Qlik\Gateway\configuration.properties. Si vous le faites via Windows Explorer, assurez-vous que l'option Show hidden files, folders, and drives (Afficher les fichiers, dossiers et lecteurs masqués) est sélectionnée.
-
Définissez [ODBC|SAPBW|SAPSQL|SAPPACKAGE]_PROCESS_ISOLATION_MODE (Colorer toutes les lignes par condition) sur None (Lignes spécifiées).
- Enregistrez le fichier configuration.properties et redémarrez le service Qlik Data Gateway - Direct Access.
Activation de l'isolement de processus ou modification du nombre de chargements simultanés
Pour activer l'isolement de processus ou modifier le nombre de chargements simultanés :
-
Ouvrez C:\ProgramData\Qlik\Gateway\configuration.properties en tant qu'administrateur. Si vous le faites via Windows Explorer, assurez-vous que l'option Show hidden files, folders, and drives (Afficher les fichiers, dossiers et lecteurs masqués) est sélectionnée.
Le fichier contient trois préfixes correspondant aux différents types de connecteur : ODBC_<property-name>, SAPBW_<property-name>, SAPSQL_<property-name> et SAPPACKAGE_<property-name>.
-
Définissez [ODBC|SAPBW|SAPSQL|SAPPACKAGE]_PROCESS_ISOLATION_MODE sur Load et [ODBC|SAPBW|SAPSQL|SAPPACKAGE]_MAX_PROCESS_COUNT sur N.
où :
N = un processus de commande + nombre de processus de chargement simultanés à allouer. Par exemple, une valeur 10 signifie un maximum de 9 chargements simultanés.
- Enregistrez le fichier configuration.properties et redémarrez le service Qlik Data Gateway - Direct Access.
Exemples d'isolation de processus du connecteur ODBC
L'extrait de fichier configuration.properties suivant montre comment activer l'isolation de processus du connecteur ODBC pour un maximum de 12 chargements :
ODBC_PROCESS_ISOLATION_MODE=Load
ODBC_MAX_PROCESS_COUNT=13
Mise en cache des données pour les charger de nouveau en cas de problème
Pour chaque opération de chargement, Direct Access gateway peut mettre en cache des blocs de données en mémoire et les décharger sur le disque (lorsque la taille allouée à la mise en cache est dépassée). Cela s'avère particulièrement utile si vous n'utilisez pas la récupération automatique et si vous rencontrez régulièrement des erreurs 4025, 4020 et 4021. Vous activez cette fonctionnalité en définissant le seuil de taille de cache pour décharger des blocs de données sur le disque (par chargement). Lorsque le seuil spécifié est atteint, la passerelle décharge les blocs chiffrés suivants sur le disque du poste Direct Access gateway.
Pour définir la taille de cache :
-
Ouvrez C:\ProgramData\Qlik\Gateway\configuration.properties en tant qu'administrateur. Si vous le faites via Windows Explorer, assurez-vous que l'option Show hidden files, folders, and drives (Afficher les fichiers, dossiers et lecteurs masqués) est sélectionnée.
-
Définissez RELOAD_CACHE_MEMORY_MB sur N (la valeur par défaut est 0, qui indique que la fonctionnalité n'est pas activée).
où :
N = quantité de mémoire allouée pour la mise en cache des blocs de données (par chargement)
Note InformationsL'activation de cette fonctionnalité augmente la consommation de mémoire sur le poste Direct Access gateway ; c'est pourquoi, lorsque cette fonctionnalité est activée, nous recommandons de surveiller son impact sur la mémoire. La définition de la valeur RELOAD_CACHE_MEMORY_MB sur 100 devrait suffire dans la plupart des cas. - Enregistrez le fichier configuration.properties et redémarrez le service Qlik Data Gateway - Direct Access.
Remplacement du répertoire de cache de blocs par défaut
Pour chaque opération de chargement, Direct Access gateway peut mettre en cache des blocs de données en mémoire et les décharger sur le disque (lorsque la taille allouée à la mise en cache est dépassée). Vous pouvez remplacer le répertoire de cache de blocs par défaut (C:\ProgramData\Qlik\Gateway\tmp) si vous ne disposez pas de suffisamment d'espace disque sur le lecteur système.
Pour effectuer cette action :
- À l'aide d'un éditeur de texte, ouvrez C:\ProgramData\Qlik\Gateway\configuration.properties en tant qu'administrateur. Si vous le faites via Windows Explorer, assurez-vous que l'option Afficher >Éléments masqués est sélectionnée.
-
Localisez la propriété OVERRIDE_CHUNKS_CACHE_DIR et définissez-la sur le répertoire de votre choix.
Exemple :
OVERRIDE_CHUNKS_CACHE_DIR=C:\tmp
Note InformationsNe placez pas le chemin d'accès entre guillemets. - Enregistrez le fichier configuration.properties et redémarrez le service Qlik Data Gateway - Direct Access.
Remplacement du type de données Qlik Cloud par défaut lors de l'utilisation du connecteur ODBC (via Direct Access gateway)
Parfois, en raison d'un problème lié à la gestion des types de données sources par le pilote ODBC du fournisseur, une erreur se produit lors du chargement ou des données incorrectes sont chargées sur Qlik Cloud. Dans ce cas, vous pouvez remplacer le type de données Qlik Cloud ou sa spécification (échelle ou précision, par exemple).
Pour effectuer cette action :
- À l'aide d'un éditeur de texte, ouvrez C:\ProgramData\Qlik\Gateway\custom_type_mapping.json en tant qu'administrateur. Si vous le faites via Windows Explorer, assurez-vous que l'option Afficher >Éléments masqués est sélectionnée. Ce fichier contient un exemple de source mappé vers des types de données Qlik Cloud.
-
Ajoutez une section qui mappe le type de données problématique au type de données Qlik Cloud souhaité.
Dans l'exemple suivant (qui est inclus dans le fichier custom_type_mapping.json), le client doit remplacer la taille du type de données Qlik Cloud DateTime par 27.
{
"Identifier": "Amazon Athena ODBC (x64)",
"NativeDataType": "timestamp with time zone",
"QlikDataType": "DateTime",
"Size": 27,
"IsBit": false
}
- Enregistrez le fichier custom_type_mapping.json et redémarrez le service Qlik Data Gateway - Direct Access.
- Rechargez les données.
Forcer Direct Access gateway à se reconnecter à Qlik Cloud
Par défaut, si Direct Access gateway se déconnecte de Qlik Cloud, il doit se reconnecter au bout de 45 secondes. Si vous notez que cela prend beaucoup plus de temps, vous pouvez forcer la passerelle à se reconnecter plus tôt.
Pour effectuer cette action :
- À l'aide d'un éditeur de texte, ouvrez C:\ProgramData\Qlik\Gateway\configuration.properties en tant qu'administrateur. Si vous le faites via Windows Explorer, assurez-vous que l'option Afficher >Éléments masqués est sélectionnée. Ce fichier contient un exemple de source mappé vers des types de données Qlik Cloud.
-
Ajoutez AGENT_PONG_TIMEOUT_SECONDS=<time-in-seconds> à la section # Connector Agent au début du fichier.
Exemple :
AGENT_PONG_TIMEOUT_SECONDS=30
Note InformationsLa durée minimale est de 30 secondes. - Enregistrez le fichier configuration.properties et redémarrez le service Qlik Data Gateway - Direct Access.
Augmentation du détail des messages d'erreur lors de la connexion à des sources de données ODBC
Pour des raisons de sécurité, le message d'erreur par défaut renvoyé par le pilote ODBC contient un minimum d'informations. Toutefois, dans certains cas, vous pourriez avoir besoin de plus d'informations pour résoudre un problème spécifique. Pour obtenir un message d'erreur plus détaillé, ajoutez la propriété ShowErrorDetailMessage à la section Avancé de la boîte de dialogue du connecteur et définissez-la sur True. Une fois le problème résolu, pour une sécurité optimale, il est vivement recommandé de supprimer la propriété ou de la définir sur False.