Travailler avec des fichiers journaux


Tableau Server crée des fichiers journaux dans le cadre de ses opérations habituelles. Vous pouvez être amené à utiliser ces fichiers journaux pour la résolution de problèmes de Tableau Server ou si l’équipe d’assistance Tableau vous demande des fichiers journaux afin de vous aider à résoudre un problème.

Vous pouvez créer une archive de fichiers journaux compressée en utilisant la commande tsm maintenance ziplogs. L’archive compressée contient des copies des fichiers journaux que vous pouvez décompresser et examiner, ou envoyer à l’équipe d’assistance Tableau. Une fois que vous avez copié l’archive, vous pouvez la supprimer de votre serveur. Pour plus d’informations sur les archives de fichiers journaux, consultez Instantanés de fichiers journaux (archives de fichiers journaux).

Vous trouverez ci-après des renseignements sur la façon de créer des archives de fichiers journaux, les contenus de fichiers journaux spécifiques, ainsi que des conseils concernant l’utilisation de ces fichiers journaux.

Contenu des fichiers journaux Tableau Server

Chaque processus Tableau Server écrit des données sur ce qu’il fait dans son propre fichier journal. Chaque journal fournit des informations détaillées sur les actions de chaque processus. Pris ensemble, ces fichiers journaux contiennent des renseignements détaillés sur la communication interne entre les composants de Tableau Server tout en traitant les demandes des utilisateurs ou en effectuant des tâches automatisées. Les fichiers journaux Tableau Server ne contiennent que des données techniques utiles pour la résolution des problèmes, l’état des différents composants, les mesures prises par différents processus, les tentatives de communication, les requêtes envoyées aux bases de données (résultats non inclus) et les horaires des demandes, par exemple.

Les fichiers journaux peuvent contenir certaines données spécifiques telles que les noms des serveurs de base de données, ainsi que leurs adresses IP et ports, les noms ou adresses IP des ordinateurs Tableau Server, ainsi que les URL et les noms des classeurs et des vues consultés par les utilisateurs.

Les fichiers journaux ne contiennent pas de données client sensibles telles que les mots de passe, les résultats des requêtes ou les données affichées sur les vues.

Remarque : lorsqu’on se connecte au niveau DEBUG, des renseignements complets sur l’environnement sont collectés au démarrage de Tableau. Cela signifie que si une variable d’environnement contient des renseignements sensibles, ils peuvent être inclus dans un fichier journal. Lorsqu’on se connecte au niveau INFO par défaut, seuls des renseignements sécurisés sur l’environnement sont collectés.

La commande tsm maintenance ziplogs permet aux utilisateurs non seulement de générer une archive compressée de fichiers journaux, mais aussi d’inclure des données de référentiel Tableau Server si l’option -d est spécifiée. Le référentiel contient des métadonnées de Tableau Server (par exemple, noms d’utilisateur, groupes, projets, autorisations sur Tableau Server, extraits des programmations d’actualisation). Le référentiel comprend également des informations de mise en page et de connexion pour les classeurs, mais n’inclut pas de données telles que les mots de passe, les données réelles de la base de données ou les données affichées sur la vue.

Les données affichées dans les vues proviennent de fichiers d’extraits ou des bases de données, et sont mises en cache dans la mémoire. Elles ne sont pas enregistrées dans les fichiers journaux ou, dans le cas des connexions en direct, dans des fichiers distincts sur les ordinateurs Tableau Server. Les fichiers d’extraits sont stockés sur les ordinateurs Tableau Server en tant que fichiers .hyper dans le dossier dataengine, mais ne sont jamais inclus dans l’archive compressée de fichiers journaux.

Recherche de solutions aux problèmes de Tableau Server

En raison de la diversité et de la complexité des problèmes susceptibles de survenir sur Tableau Server, il n’existe pas de processus unique à suivre pour résoudre tous les problèmes. Toutefois, les étapes suivantes peuvent de manière générale vous aider à trouver des solutions :

  1. Nettoyez les fichiers journaux existants pour réduire leur taille. Pour plus d’informations, consultez Supprimer les fichiers superflus.

    Important : Si vous voulez obtenir l’aide de l’assistance Tableau pour résoudre un problème, assurez-vous de créer une archive compressée de vos fichiers journaux avant de les nettoyer. Le nettoyage peut supprimer les informations importantes dont l’assistance pourrait avoir besoin. Pour plus de détails sur la création d’archives de fichiers journaux, consultez Instantanés de fichiers journaux (archives de fichiers journaux).

  2. Définissez le niveau d’enregistrement approprié. L’équipe d’assistance Tableau vous fournira les instructions relatives à cette étape. Pour plus d’informations, y compris l’impact des différents niveaux de fichiers journaux, consultez Modifier les niveaux d’enregistrement.
  3. Reproduisez le problème que vous êtes en train de résoudre afin que les fichiers journaux capturent les événements associés aux problèmes.

  4. Créez une archive de fichiers journaux. Pour plus d’informations, consultez Instantanés de fichiers journaux (archives de fichiers journaux).

    Important : Utilisez cette archive lorsque vous consultez les fichiers journaux. Vous ne devez pas modifier, déplacer ou supprimer des fichiers directement sur le serveur.

  5. Consultez le fichier journal du Contrôleur d’administration TSM  (\tabadmincontroller\tabadmincontroller_node<n>-<n>.log) pour comprendre la configuration ou le déploiement effectué(e) par TSM depuis la ligne de commande, l’interface utilisateur Web ou l’API, y compris les tâches démarrées par TSM. Commencez par le fichier journal du contrôleur. C’est là que vous trouverez les informations les plus utiles.

    Remarque : la commande tsm.log est moins détaillée que tabadmincontroller_*.log mais peut fournir des informations de dépannage complémentaires utiles.

  6. Recherchez dans les fichiers journaux Apache (\httpd\access.####_##_##_##_##_##.log et \httpd\error.log) des requêtes pouvant être liées au problème que vous cherchez à résoudre.

    Les fichiers journaux Apache contiennent une grande quantité de « bruit » qui n’a aucun lien avec les problèmes que vous rencontrez.

    • Si vous trouvez une requête qui semble être liée à votre problème, recherchez, dans le répertoire vizqlserver, les entrées contenant l’ID de requête unique issu des fichiers journaux Apache.
    • Recherchez le code de réponse et le message associés à l’ID de la requête.
    • Recherchez le nom du classeur, de la vue, du tableau de bord ou de la source de données liés à votre problème. Assurez-vous de rechercher un horodatage pertinent.
    • Si vous trouvez une requête qui vous semble liée à votre problème, regardez le code de réponse associé à la requête. (les 200 sont bons, les 500 indiquent des problèmes.)
    • Localisez l’ID de requête unique associée à la requête que vous avez identifiée (l’ID de requête unique est une chaîne alphanumérique de 24 caractères à la toute fin de la requête).

  7. Vérifiez l’archive du fichier journal en profondeur pour y chercher d’autres messages et des erreurs possibles.

    • Utilisez l’ID de requête des fichiers journaux Apache pour rechercher dans le dossier vizqlserver de l’archive des fichiers contenant les entrées de fichiers journaux concernées. Cherchez des signes indiquant un problème (par exemple, des messages d’erreur ou des demandes de longue date).
    • L’outil open source gratuit Logshark peut être une option utile pour l’examen des archives de fichiers journaux. Pour plus d’informations, consultez Résolution des problèmes de Tableau Server(Le lien s’ouvre dans une nouvelle fenêtre) dans Tableau Blueprint.

  8. Consultation des journaux de script.

    Tableau Server inclut des fichiers journaux pour la plupart des scripts qui se trouvent dans le répertoire de scripts. Par défaut :C:\Program Files\Tableau\Tableau Server\packages\scripts.<version_code>\ Ces fichiers journaux sont enregistrés sur :

    • <install_drive>\<install\path>\logs\
      par défaut : 
    • C:\ProgramData\Tableau\Tableau Server\logs\

  9. Contacter l’assistance

    Si vous n’êtes pas en mesure de résoudre le problème vous-même ou si l’équipe d’assistance de Tableau vous le demande, envoyez l’archive compressée à Tableau.

Retour en haut
Merci de vos commentaires!Votre commentaire s été envoyé avec succès. Merci!