Trabalhar com arquivos de log

Criar arquivos de registro é uma parte regular das atividades do Tableau Server. Os arquivos de registro do servidor podem ser necessários ao solucionar problemas com o Tableau Server ou se o Suporte do Tableau solicitar os registros para ajudar a resolver um problema.

É possível criar um arquivo de registro compactado por meio do comando tsm maintenance ziplogs. O arquivo compactado contém cópias dos registros que podem ser descompactadas e examinadas ou enviadas para o Suporte do Tableau. Depois de criar uma cópia do arquivo, você pode excluir o arquivo do servidor. Para obter mais informações sobre arquivos de registro, consulte Instantâneos do arquivo de log (Arquivar logs).

Este conjunto de tópicos fornece informações sobre como criar arquivo de logs, o conteúdo de arquivos de registro específicos e detalhes sobre quando e como verificar um log.

Investigação de problemas do Tableau Server

A variedade e a complexidade de problemas possíveis no Tableau Server indicam que não existe um processo simples a ser usado na investigação de todos os problemas, e sim uma abordagem geral que inclui estas etapas:

  1. Apague os arquivos de registro existentes para reduzir seu tamanho. Para obter mais informações, consulte Remover arquivos desnecessários.
  2. Defina o nível de registro apropriado. Isso é algo que o Suporte do Tableau o instruirá a fazer. Para obter mais informações, consulte Alterar níveis de registro.
  3. Reproduza o problema que você está solucionando para que os logs capturem os eventos relacionados ao problema.
  4. Crie um arquivo dos logs. Para obter mais informações, consulte Instantâneos do arquivo de log (Arquivar logs).

    Importante: use esse arquivo ao examinar os arquivos de registro. É aconselhável não editar, mover ou excluir nenhum arquivo diretamente no servidor.

  5. Examine o log do controlador de administração do TSM \tabadmincontroller\tabadmincontroller_node<n>-<n>.log para entender qualquer configuração ou implantação feita pelo TSM na linha de comando, UI da Web ou API, inclusive tarefas iniciadas pelo TSM. Comece com o log do controlador. É onde você obterá informações mais úteis.

  6. Analise os registros do Apache (\httpd\access.####_##_##_##_##_##.log e \httpd\error.log) por solicitações que possam estar relacionadas ao problema sendo investigado.

    Os logs do Apache conterão muito "ruído" que não se aplica a problemas que você está enfrentando.

    • Se você encontrar uma solicitação que pareça estar relacionada ao problema, procure no diretório vizqlserver por entradas que incluam a ID de solicitação exclusiva dos registros do Apache.
    • Procure o código de resposta e a mensagem associados à ID de solicitação.
    • Pesquise pelo nome da pasta de trabalho, exibição, painel ou fonte de dados que está relacionada ao seu problema. Procure um carimbo de data/hora pertinente.
    • Se encontrar uma solicitação que pareça estar relacionada ao seu problema, examine o código de resposta associado à solicitação. (200s são bons, 500s indicam problemas).
    • Localize a ID de solicitação exclusiva associada com a solicitação identificada (a ID de solicitação exclusiva é uma cadeia de 24 caracteres alfanuméricos no final da solicitação).
  7. Revise o arquivo de registro mais detalhadamente para procurar outras mensagens e possíveis erros.

    • Use a ID de solicitação dos logs do Apache para procurar a pasta vizqlserver do arquivo de log por arquivos que contêm entradas de registro relacionadas. Procure indicações de um problema (por exemplo, mensagens de erro ou consultas em execução há muito tempo)
  8. Analise o registro do script.

    O Tableau Server inclui logs da maioria dos scripts reunidos no diretório de scripts Como padrão:C:\Program Files\Tableau\Tableau Server\packages\scripts.<version_code>\. Esses log são salvos em:

    • <install_drive>\<install\path>\logs\
      por padrão: 
    • C:\ProgramData\Tableau\Tableau Server\logs\
  9. Entre em contato com o suporte

    Se você não conseguir resolver o problema por conta própria, ou se o Suporte do Tableau pedir, envie o arquivo compactado para o Tableau.

Outros artigos nesta seção

Obrigado pelo feedback! Ocorreu um erro ao enviar seu feedback. Tente novamente ou envie-nos uma mensagem..