---
schema_version: "1"
id: 9dd66fc57b15c52c0f51c080eab8a204401b4f72e63ae2d5b3e89f0070042dc2
title: Modifier les niveaux d’enregistrement
collection: tableau
version: next
locale: fr-fr
portal_url: https://docs.salesforce.com/tableau/next/fr-fr/server-linux/logs_debug_level.md
canonical_url: https://help.tableau.com/v0.0/server-linux/fr-fr/logs_debug_level.htm
source_site: help.tableau.com
content_type: documentation
content_hash: 171d6e13a5293df90c73935d49839056dc82dd4e1e029a6a542fc0199c15fc03
description: Change logging levels for Tableau Services Manager and Tableau Server.
---
[Passer au contenu principal](#main-content)

# Modifier les niveaux d’enregistrement

Par défaut, Tableau Services Manager (TSM) et Tableau Server enregistrent les événements au niveau **Informations**. 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’informations enregistrées. 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’informations au point qu’elles ne seront plus guère utiles à l’assistance Tableau.

**Remarque :** lors de la connexion au niveau `DEBUG`, des informations complètes sur l’environnement sont collectées au démarrage de Tableau. Cela signifie que si une variable d’environnement contient des informations sensibles, elles peuvent être incluses dans un journal. La journalisation au niveau par défaut `INFO` ne recueille que des informations sur l’environnement sûr.

## 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 les niveaux d’enregistrement pour un ou plusieurs de ces composants seulement et que vous exécutez la version appropriée de Tableau, vous pouvez le faire sans redémarrer Tableau Server.

Ces niveaux de journalisation sont configurables de manière dynamique, à partir des versions suivantes :

- 2020.2 - services tsm (`tsm.log.level` ) et contrôler les services d’application (`tsm.controllerapp.log.level` ).
- 2020.3 - backgrounder (`backgrounder.log.level`), contrôleur de cluster (`clustercontroller.log.level`), serveur de données (`dataserver.log.level`), répertoire de fichiers (`filestore.log.level`), propriétés de sources de données (`tdsservice.log.level`) et VizQL Server (`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 de manière dynamique et celles qui ne le sont pas.

<table class="table--plain"><tbody><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1"><b>Clé de configuration</b></td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1"><b>Emplacement des fichiers journaux affectés</b><p>(le chemin d’accès commence par <code>/var/opt/tableau/tableau_server/data/tabsvc/logs/</code>)</p></td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1"><p><code>tsm.log.level</code></p><p>Modifie les niveaux de journalisation TSM pour&nbsp;: activationservice, appzookeeper, backuprestore, clientfileservice, databasemaintenance, licenseservice, siteimportexport, tabadminagent, tabadmincontroller, tabsvc</p></td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1"><p><code>/&lt;service&gt;/&lt;service&gt;_node&lt;n&gt;-&lt;instance&gt;.log</code></p><p>exemple&nbsp;:<code> /clientfileservice/clientservice_node1-0.log</code></p></td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1"><p><code>tsm.controlapp.log.level</code></p><p>Modifie les niveaux d’enregistrement TSM pour&nbsp;: Applications de contrôle</p></td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1"><p><code>/&lt;service&gt;/control_&lt;service&gt;_node&lt;n&gt;-&lt;instance&gt;.log</code></p><p>exemples&nbsp;:<code> /clientfileservice/control_clientservice_node1-0.log</code></p><p><code> /filestore/control_filestore_node1-0.log</code></p></td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1"><p><code> &lt;process&gt;.native_api.log.level</code></p><p>Les noms de processus valides sont backgrounder, vizportal, vizqlserver ou dataserver</p><p><strong>Remarque&nbsp;:</strong> ils ne sont pas configurables de manière dynamique.</p></td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1"><code>/vizqlserver/*.txt</code></td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1"><p><code>backgrounder.log.level</code></p><p>Modifie les niveaux d’enregistrement pour&nbsp;: Backgrounder</p></td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1"><code>/backgrounder/*.log</code></td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1"><p><code>clustercontroller.log.level</code></p><p>Modifie les niveaux d’enregistrement pour&nbsp;: Contrôleur de cluster</p></td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1"><code>/clustercontroller/*.log</code></td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1"><p><code>dataserver.log.level</code></p><p>Modifie les niveaux d’enregistrement pour&nbsp;: Serveur de données</p></td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1"><code>/dataserver/*.log</code></td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1"><p><code>filestore.log.level</code></p><p>Modifie les niveaux d’enregistrement pour&nbsp;: Répertoire de fichiers</p></td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1"><code>/filestore/*.log</code></td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1"><p><code>gateway.log.level</code></p><p>Modifie les niveaux d’enregistrement pour&nbsp;: Processus de contrôle de passerelle</p></td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1"><code>/gateway/*.log</code></td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1"><p><code>gateway.httpd.loglevel</code></p><p><strong>Remarque&nbsp;:</strong>&nbsp;ajouté dans la version 2021.3.0</p><p>Modifie les niveaux d’enregistrement pour&nbsp;: Passerelle</p></td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1"><code>/gateway/*.log</code></td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1"><p><code>hyper.log.level</code></p><p>Modifie les niveaux d’enregistrement pour&nbsp;: Hyper</p></td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1"><code>/hyper/*.log</code></td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1"><p><code>tdsservice.log.level</code></p><p>Modifie les niveaux d’enregistrement pour&nbsp;: Service Propriétés de la source de données</p></td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1"><code>/tdsservice/*.log</code></td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1"><p><code>tomcatcontainer.log.level</code></p><p>Modifie les niveaux d’enregistrement pour les microservices dans&nbsp;: Conteneur de microservices interactif et Conteneur de microservices non interactif</p></td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1"><code>/tomcatcontainer/*.log</code></td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1"><p><code>vizportal.log.level</code></p><p>Modifie les niveaux d’enregistrement pour&nbsp;: Serveur d’applications</p></td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1"><code>/vizportal/*.log</code></td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1"><p><code>vizqlserver.log.level</code></p><p>Modifie les niveaux d’enregistrement pour&nbsp;: VizQL Server</p></td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1"><code>/vizqlserver/*.log</code></td></tr></tbody></table>

Consultez [Options tsm configuration set](https://help.tableau.com/v0.0/server-linux/fr-fr/cli_configuration-set_tsm.htm) 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, voir [Configuration dynamique du niveau d’enregistrement](#DynamicLogLevel) ci-dessus). Si vous modifiez d’autres niveaux d’enregistrement , vous devrez peut-être arrêter Tableau Server avant de modifier les niveaux d’enregistrement, puis le redémarrer par la suite. Si tel est le cas, vous recevrez une invite.

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>`
    
    où `<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 à son sujet, réinitialisez les niveaux d’enregistrement afin d’éviter un d’impact durable sur les performances et l’utilisation d’espace disque supplémentaire.

Dans Tableau Server 2026.2 et versions ultérieures, vous pouvez afficher et réinitialiser tous les niveaux d’enregistrement de service à leurs valeurs par défaut à l’aide des commandes `tsm maintenance log-levels`. Pour plus d’informations, voir [tsm maintenance](https://help.tableau.com/v0.0/server-linux/fr-fr/cli_maintenance_tsm.htm).

- Pour voir toutes les configurations de niveau d’enregistrement avant la réinitialisation, exécutez :
    
    `tsm maintenance log-levels list`
- Pour définir toutes les configurations de niveau d’enregistrement à leurs valeurs par défaut, exécutez :
    
    `tsm maintenance log-levels reset`

Pour des versions antérieures de Tableau Server, ou pour réinitialiser des clés spécifiques, exécutez la commande `tsm configuration set` avec l’option `-d` .

Exemples :

- tsm configuration set -k backgrounder.native\_api.log.level -d
- tsm configuration set -k tsm.log.level -d

Vous devez appliquer les modifications en attente après avoir réinitialisé les niveaux d’enregistrement. Si vous réinitialisez les niveaux d’enregistrement pour les processus Tableau Server, consultez la liste des modifications en attente. Si la mise à jour nécessite un redémarrage, arrêtez le serveur, appliquez les modifications, puis redémarrez-le.