Server Log File Locations

By default, Tableau Server log file archives are gathered in a zip file called logs.zip, but you can specify a different filename when you create the archive with the tsm maintenance ziplogs command. You can copy the archive from the server to a local computer and open it there, or send it to Tableau Support.

When you unzip the archive, a series of zip files are created that start with the directory names shown below, and that end with a version number. These zip files contain the log files from the corresponding directories. The table in this topic explains the possible contents of these zip files, along with the original location the files came from on Tableau Server, the process that created the log files, and details about the files.

Tableau Server Log and Configuration File Locations

The Tableau Server log files are found in the following directory: /var/opt/tableau/tableau_server/data/tabsvc/logs/

Logs not included in the ziplog archive

The tsm maintenance ziplogs command creates an archive of most of the Tableau Server logs, but some logs are not zipped up in the archive. Important logs not included in a log file archive:

  • The TSM log. The tsm.log file is located in <home dir>/.tableau/tsm .
  • The install log. The app-install.log file is located in /var/opt/tableau/tableau_server/logs .
  • The upgrade log. The app-upgrade.log file is located in /var/opt/tableau/tableau_server/logs .

Bash script logging

Tableau Server includes logs for most of the bash scripts that are included in the scripts directory at /opt/tableau/tableau_server/packages/scripts.<version>. These logs are not included in the log file archive. Instead, the logs are saved to the /var/tmp directory each time a script is run.

System information

The log archives include system information gathered by running a number of system commands. The output for those commands are included in a subdirectory of the tabadminagent directory called sysinfo. See tabadminagent in the table below for more information.

Log Archive File Locations (unzipped archive)

Log Archives in logs.zip Details Files Generated by Location on Tableau Server
appzookeeper Logs related to the Tableau Server Coordination Service. appzookeeper-#.log

control_appzookeeper-#.log

spawn.####.log

zookeeper.exe /logs/appzookeeper
backgrounder Logs related to subscriptions and scheduled activities like extract refreshes, "Run Now" tasks, and tabcmd tasks. backgrounder-#.log

spawn.####.log

tomcat-#.####-##-##.log

backgrounder.exe /logs/backgrounder
backuprestore Logs related to backup and restore scenarios. control-backuprestore-#.log   /logs/backuprestore
cacheserver Logs related to the Cache Server process. control-cacheserver-#.log

redis_#.log

redis-server.exe /logs/cacheserver
clustercontroller Logs related to the Cluster Controller process. clustercontroller.log

clustercontroller.log-####-##-##

clustercontroller.exe /logs/clustercontroller
databasemaintenance Logs related to database maintenance. control-databasemaintenance-#.log

databasemaintenance-#.log

db-migrate.log

migration.log

spawn.####.log

  /logs/databasemaintenance
dataserver Logs related to connections to Tableau Server data sources. dataserver-#.log dataserver.exe /logs/dataserver
elasticserver Logs related to the Elastic Server process that is used by Ask Data.

control_elasticserver_node<n>-<n>.log

elasticsearch.log

elasticsearch_deprecation.log

elasticsearch_index_indexing_slowlog.log

elasticsearch_index_search_slowlog.log

stdout_elasticserver_node<n>-<n>.log

  /logs/elasticserver
filestore Logs related to the Tableau Server File Store process that controls the storage of extracts and syncs extracts across nodes. filestore.log filestore.exe /logs/filestore
httpd Apache logs. Look here for authentication entries. Each request in the Apache log will have a request ID associated with it. This request ID is used throughout the server logs and you can use it to associate log entries with a request. access.####-##-##.##-##-##.log error.log

startup.log

Apache daemon /logs/httpd
hyper

Logs related to Tableau data engine.

A log file is generated each day with information about data extracts and queries, and responses to VizQL server requests.

checklicense.log

control-hyper-0.log

hyper_####_##_##_##_##.log

  /logs/hyper
licenseservice Logs related to licensing processes. control-licenseservice.log

tabclicsrv.log

  /logs/licenseservice
nlp Logs related to the Ask Data service in Tableau Server. control_nlp_node<n>-<n>.log 

stdout_nlp_node1-<n>-<n>.log

  /logs/nlp
pgsql Logs related to the PostgreSQL database (repository), including files related to launching server processes control-pgsql-#.log

shutdownCommand.#####.log

 

tabspawn /logs/pgsql
samlservice Logs related to the Security Assertion Markup Language (SAML) service in Tableau Server. control-samlservice-#.log   /logs/samlservice
searchserver Logs related to search indexing. control-searchserver-#.log

tomcat_#.####-##-##.log

  /logs/searchserver
siteimportexport Logs related to site import and export operations. control-siteimportexport-0.log

siteimportexport-0.log

  /logs/siteimportexport
tabadminagent

Logs related to configuration and topology changes on each server node.

Also included in a /sysinfo subdirectory is output from various system commands that provide details on the server machine and its state.

control_tabadminagent_node<#>-<instance#>.log

tabadminagent_node<#>-<instance#>.log

 

/logs/tabadminagent_<instance#>.<version_code>/config

/logs/tabadminagent_<instance#>.<version_code>/logs

/logs/tabadminagent_<instance#>.<version_code>/sysinfo

tabadmincontroller Logs related to the Tableau Services Manager (TSM) CLI and TSM API. control-tabadmincontroller-#.log

tabadmincontroller-#.log

  /logs/tabadmincontroller
tabsvc Logs related to the startup and shutdown of other Tableau Server service processes. control-tabsvc-#.log

tabsvc.log

  /logs/tabsvc
vizportal Logs related to administrative tasks, workbook and permissions management, authentication, sign-ins, initial view requests, and publishing requests.

These log files also include entries related to REST API requests. REST API log entries start with the receipt of the HTTP request, followed by information related to the processing of that request. If the request is completed, these log entries end with the HTTP response code for that request.

vizportal-0.log

vizportal-0.log.####-##-##

vizportal.exe /logs/vizportal
vizqlserver Logs related to displaying and interacting with views.

When running multiple instances of VizQL Server, the instances are distinguished by port number.

notify-production logs contain exceptional events.

control_vizqlserver_node#-0.log

tomcat_#.####-##-##.log

vizql-client-0.log.####-##-##

vizqlserver_node#-0.log

spawn.####.log

vizqlserver.exe /logs/vizqlserver

 

Thanks for your feedback! There was an error submitting your feedback. Try again or send us a message.