Modifier les niveaux d’enregistrement

Par défaut, Tableau Services Manager (TSM) et Tableau Server enregistrent les événements au niveau Information. Vous pouvez modifier le niveau d’enregistrement si vous souhaitez collecter davantage d’informations (par exemple, si vous travaillez avec l’équipe d’assistance Tableau).

Il est recommandé de ne pas augmenter les niveaux d’enregistrement sauf lorsque vous résolvez un problème, conformément aux instructions de l’assistance. Nous vous recommandons d’utiliser le niveau « debug » uniquement lorsque vous souhaitez régler un problème particulier. Modifier les niveaux d’enregistrements peut avoir les impacts suivants :

  • Le passage au niveau d’enregistrement supérieur debug ou trace augmente la quantité d’information enregistrée. Cela peut avoir un impact important sur les performances. Une fois le problème réglé, redéfinissez le niveau d’enregistrement sur« info ».
  • Définir le niveau d’enregistrement sur warn ou error peut réduire la quantité d’information au point qu’elle ne sera plus guère utile à l’assistance Tableau.

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.

Niveaux d’enregistrement

Les niveaux d’enregistrement suivants sont classés par ordre croissant selon la quantité d’informations enregistrées :

  • off (désactivé)
  • fatal (irrécupérable)
  • error (erreur)
  • warn (avertir)
  • info (the default) (info (valeur par défaut))
  • debug (déboguer)
  • trace (suivre)

Modifier les niveaux d’enregistrement

Vous pouvez définir les niveaux d’enregistrement pour TSM et les processus Tableau Server à l’aide des clés de configuration tsm configuration set. La clé que vous utilisez dépend du composant de TSM ou de Tableau Server dont vous souhaitez modifier le niveau d’enregistrement.

Configuration dynamique du niveau d’enregistrement

Dans la version 2020.2, nous avons introduit la configuration dynamique. La fonctionnalité a été étendue dans les versions ultérieures. Si vous modifiez uniquement les niveaux de journalisation pour un ou plusieurs de ces composants et que vous exécutez la version appropriée de Tableau, vous pouvez modifier les niveaux de journalisation sans redémarrer Tableau Server.

Ces niveaux de journalisation sont configurables dynamiquement, à partir des versions suivantes :

  • 2020.2 - services tsm (tsm.log.level ) et contrôler les services d’application (tsm.controllerapp.log.level ).
  • 2020.3 - gestionnaire de processus en arrière-plan (backgrounder.log.level), contrôleur de grappe (clustercontroller.log.level), serveur de données (dataserver.log.level), stockage de fichiers (filestore.log.level), propriétés de sources de données (tdsservice.log.level) et Serveur VizQL (vizqlserver.log.level).
  • 2020.4 - ajoute un conteneur de microservice interactif (tomcatcontainer.log.level) et un serveur d’applications (vizportal.log.level).

 

Clés de configuration pour modifier les niveaux de journalisation

Cette table inclut à la fois les clés configurables dynamiquement et celles qui ne le sont pas.

Clé de configurationEmplacement des fichiers journaux affectés

(le chemin d’accès commence par /var/opt/tableau/tableau_server/data/tabsvc/logs/)

tsm.log.level

Modifie les niveaux d’enregistrement TSM pour : clientfileservice, licenseservice, tabadminagent, tabadmincontroller, tabsvc

/<service>/<service>_node<n>-<instance>.log

exemple: /clientfileservice/clientservice_node1-0.log

tsm.controlapp.log.level

Modifie les niveaux d’enregistrement TSM pour : Applications de contrôle

/<service>/control_<service>_node<n>-<instance>.log

exemples: /clientfileservice/control_clientservice_node1-0.log

/filestore/control_filestore_node1-0.log

<process>.native_api.log.level

Les noms de processus valides sont backgrounder, vizportal, vizqlserver ou dataserver

Remarque : ils ne sont pas configurables de manière dynamique.

/vizqlserver/*.txt

backgrounder.log.level

Modifie les niveaux d’enregistrement pour : Gestionnaire de processus en arrière-plan

/backgrounder/*.log

clustercontroller.log.level

Modifie les niveaux d’enregistrement pour : Contrôleur de grappe

/clustercontroller/*.log

dataserver.log.level

Modifie les niveaux d’enregistrement pour : Serveur de données

/dataserver/*.log

filestore.log.level

Modifie les niveaux d’enregistrement pour : stockage de fichiers

/filestore/*.log

gateway.log.level

Modifie les niveaux d’enregistrement pour : Processus de contrôle de passerelle

/gateway/*.log

gateway.httpd.loglevel

Remarque : ajouté dans la version 2021.3.0

Modifie les niveaux d’enregistrement pour : Passerelle

/gateway/*.log

hyper.log.level

Modifie les niveaux d’enregistrement pour : Hyper

/hyper/*.log

tdsservice.log.level

Modifie les niveaux d’enregistrement pour : Service Propriétés de la source de données

/tdsservice/*.log

tomcatcontainer.log.level

Modifie les niveaux d’enregistrement pour les microservices dans : Conteneur de microservices interactif et Conteneur de microservices non interactif

/tomcatcontainer/*.log

vizportal.log.level

Modifie les niveaux d’enregistrement pour : Serveur d’applications

/vizportal/*.log

vizqlserver.log.level

Modifie les niveaux d’enregistrement pour : VizQL Server

/vizqlserver/*.log

Consultez Options tsm configuration set pour plus d’informations.

Si vous modifiez uniquement les niveaux d’enregistrement configurables de manière dynamique, vous n’avez pas besoin d’arrêter ou de démarrer le serveur (pour plus d’informations, consultez Configuration dynamique du niveau d’enregistrement ci-dessus). Si vous modifiez les niveaux d’enregistrement de Tableau Server, vous devez peut-être arrêter Tableau Server avant de modifier les niveaux d’enregistrement, et le redémarrer par la suite. Si tel est le cas, vous serez invité.

Sur une installation distribuée de Tableau Server, définissez les niveaux d’enregistrement depuis le nœud initial.

Pour changer le niveau d’enregistrement :

  1. (Facultatif pour les niveaux d’enregistrement configurables de manière dynamique dans la version 2020.2.0 et versions ultérieures) Arrêtez Tableau Server en ouvrant une invite de commande et en tapant :

    tsm stop

  2. Définissez le niveau d’enregistrement en entrant tsm configuration set -k <config.key> -v <config_value>

    <config.key> est l’une des clés dans la table ci-dessus et <config_value> est un niveau d’enregistrement valide.

    Exemples :

    • tsm configuration set -k backgrounder.native_api.log.level -v debug                    
    • tsm configuration set -k tsm.log.level -v debug
    • tsm configuration set -k tsm.controlapp.log.level -v debug
  3. Appliquez les modifications en attente à l’aide de la commande tsm pending-changes apply.
  4. (Facultatif, seulement si le serveur est arrêté) Démarrez Tableau Server en exécutant la commande suivante :

    tsm start

Réinitialiser les niveaux d’enregistrement

Après avoir reproduit le problème et recueilli les informations liées au problème, réinitialisez les niveaux d’enregistrement afin qu’il n’y ait pas d’impact durable sur les performances et qu’aucun espace de disque supplémentaire ne soit utilisé.

Vous pouvez réinitialiser le niveau d’enregistrement par défaut (info) à l’aide de la commande appropriée et d’une option -d. Vous devez appliquer les modifications en attente après la réinitialisation du niveau, et si vous réinitialisez les niveaux d’enregistrement pour les processus Tableau Server, vous devez peut-être arrêter le serveur avant d’effectuer la modification, et le démarrer après avoir appliqué les modifications en attente.

Exemples :

  • tsm configuration set -k backgrounder.native_api.log.level -d
  • tsm configuration set -k tsm.log.level -d
Merci de vos commentaires!Votre commentaire s été envoyé avec succès. Merci!