---
schema_version: "1"
id: 48b13e199a0ff30f70204bc7a2826b82c3e1b06c676b3ab9328716bd4030be4e
title: Alterar níveis de registro
collection: tableau
version: next
locale: pt-br
portal_url: https://docs.salesforce.com/tableau/next/pt-br/server-linux/logs_debug_level.md
canonical_url: https://help.tableau.com/v0.0/server-linux/pt-br/logs_debug_level.htm
source_site: help.tableau.com
content_type: documentation
content_hash: 521e78000463bd8fab72e0b676cce381934b29fff5fb20eb7f9ef830429b7770
description: Change logging levels for Tableau Services Manager and Tableau Server.
---
[Pular para o conteúdo principal](#main-content)

# Alterar níveis de registro

Por padrão, o Tableau Services Manager (TSM) e o Tableau Server registram eventos no nível **Informações**. Você poderá alterar isso se precisar obter mais informações (se estiver trabalhando com o Suporte do Tableau, por exemplo).

Como prática recomendada, você não deve aumentar os níveis de registro, exceto em resolução de problemas, conforme instruído pelo Suporte. Você só deve definir um nível de registro como depuração ao investigar um problema específico. A alteração dos níveis de registro pode ter esses impactos:

- O aumento do nível de registro para `debug` ou `trace` aumenta o volume de informações registradas e pode ter um impacto significativo sobre o desempenho. Reproduza o problema e redefina o nível de registro como informações.
- Definir o nível de registro para `warn` or `error` pode reduzir tanto a quantidade de informações, de modo que não sejam úteis para o suporte do Tableau.

**Observação:** ao fazer login no`DEBUG` nível, as informações completas do ambiente são coletadas quando o Tableau é iniciado. Isso significa que, se você tiver informações confidenciais em uma variável de ambiente, elas poderão ser incluídas em um registro. Registrar no nível `INFO` padrão apenas reúne informações de ambiente seguro.

## Níveis de registro

Os níveis de registro a seguir são listados na ordem do volume de informações registradas crescente:

- off (desativado)
- fatal (fatal)
- error (erro)
- warn (aviso)
- info (the default) (informações (o padrão))
- debug (depuração)
- trace (rastreamento)

## Alterar níveis de registro

Defina os níveis de registro para processo do TSM e do Tableau Server usando as chaves de configuração **tsm configuration set**. A chave usada depende de qual componente do TSM ou do Tableau Server cujo nível de registro você deseja alterar.

### Configuração dinâmica de nível de registro

Na versão 2020.2, introduzimos a configuração dinâmica. A capacidade foi expandida em versões subsequentes. Se você estiver alterando apenas os níveis de registro de um ou mais desses componentes e estiver executando a versão apropriada do Tableau, poderá alterar os níveis de registro sem reiniciar o Tableau Server.

Esses níveis de registro são configuráveis dinamicamente, começando com estas versões:

- 2020.2 - serviços tsm (`tsm.log.level` ) e serviços de aplicativos de controle (`tsm.controllerapp.log.level` ).
- 2020.3 - processador em segundo plano (`backgrounder.log.level` ), controlador de cluster (`clustercontroller.log.level` ), servidor de dados (`dataserver.log.level` ), armazenamento de arquivos (`filestore.log.level` ), propriedades da fonte de dados (`tdsservice.log.level` ) e servidor VizQL (`vizqlserver.log.level` ).
- 2020.4 - adiciona contêiner de microsserviço interativo (`tomcatcontainer.log.level`) e servidor de aplicativo (`vizportal.log.level`).

## Chaves de configuração para alterar os níveis de registro

Esta tabela inclui chaves configuráveis dinamicamente e aquelas que não são configuráveis dinamicamente.

<table class="table--plain"><tbody><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1"><b>Chave de configuração</b></td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1"><b>Local dos logs afetados</b><p>(o caminho começa com <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>Altera os níveis de registro do TSM para:&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>exemplo:<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>Altera os níveis de registro do TSM para: aplicativos de controle</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>exemplos:<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>Os nomes de processo válidos são processadores em segundo plano, vizportal, vizqlserver e dataserver</p><p><strong>Observação:</strong> esses não são dinamicamente configuráveis.</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>Altera os níveis de registro para: processador em segundo plano</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>Altera os níveis de registro para: controlador 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>Altera os níveis de registro para: servidor de dados</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>Altera os níveis de registro para: armazenamento de arquivos</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>Altera os níveis de registro para: processos de controle de gateway</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>Observação:</strong>&nbsp;adicionado na versão 2021.3.0</p><p>Altera os níveis de registro para: gateway</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>Altera os níveis de registro para: 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>Altera os níveis de registro para: serviço de propriedades de origem de dados</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>Altera os níveis de registro de microsserviços em: contêiner de microsserviço interativo e contêiner de microsserviço não interativo</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>Altera os níveis de registro para: servidor de aplicativos</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>Altera os níveis de registro para: servidor VizQL</p></td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1"><code>/vizqlserver/*.log</code></td></tr></tbody></table>

Para obter mais informações, consulte [Opções do tsm configuration set](https://help.tableau.com/v0.0/server-linux/pt-br/cli_configuration-set_tsm.htm).

Se você estiver apenas alterando os níveis de registro dinamicamente configuráveis, não precisará parar ou iniciar o servidor (para obter mais informações, consulte [Configuração dinâmica de nível de registro](#DynamicLogLevel) acima). Se estiver alterando outros níveis de registro, é possível interromper o Tableau Server antes de alterar os níveis de registro e reiniciá-lo depois. Se este for o caso, você receberá uma solicitação.

Em uma instalação de vários nós do Tableau Server, defina os níveis de registro no nó inicial.

Para alterar o nível de registro:

1. (Opcional para níveis de registro configuráveis dinamicamente na versão 2020.2.0 e posterior) Interrompa o Tableau Server abrindo um prompt de comando e digitando:
    
    `tsm stop`
2. Defina o nível de registro digitando `tsm configuration set -k <config.key> -v <config_value>`
    
    em que `<config.key>` é uma das chaves na tabela acima e registro `<config_value>` é um nível de registro válido.
    
    Exemplos:
    
    - 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. Aplique as alterações pendentes por meio do comando `tsm pending-changes apply`.
4. (Opcional, somente se o servidor estiver interrompido) Inicie o Tableau Server executando o seguinte comando:
    
    `tsm start`

## Redefinir níveis de registro

Após reproduzir o problema e coletar informações sobre ele, redefina os níveis de registro para evitar impactos persistentes no desempenho e uso adicional de espaço em disco.

No Tableau Server 2026.2 e posterior, você pode exibir e redefinir todos os níveis de log de serviço para seus valores padrão com os comandos `tsm maintenance log-levels`. Para obter mais informações, consulte [tsm maintenance](https://help.tableau.com/v0.0/server-linux/pt-br/cli_maintenance_tsm.htm).

- Para ver todas as configurações de nível de log antes de redefinir, execute:
    
    `tsm maintenance log-levels list`
- Para definir todas as configurações de nível de log com seus valores padrão, execute:
    
    `tsm maintenance log-levels reset`

Para obter versões anteriores do Tableau Server ou para redefinir chaves específicas, execute o comando `tsm configuration set` com a opção `-d`.

Exemplos:

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

Você deve aplicar alterações pendentes após redefinir os níveis de log. Se você estiver redefinindo os níveis de registro dos processos do Tableau Server, verifique a lista de alterações pendentes. Se a atualização exigir uma reinicialização, interrompa o servidor, aplique as alterações e inicie-a novamente.