Server Log File Locations in the Ziplog Archive

Tableau Server generates log files during normal operations. The logs are on a running server, and you can find them, but we strongly recommend that if you are going to be looking at the logs, or if you need to send them to Tableau Support, you use the tsm maintenance ziplogs command to generate an archive of the logs. This command not only gathers together and zips up the logs, but provides you with a copy you can examine, move to another computer, or send to Tableau, without impacting the functioning of Tableau Server.

By default, the tsm maintenance ziplogs command creates a zipped archive called logs.zip in a predefined location. You can copy the archive from the server to a local computer and open it there, or send it to Tableau Support. You can specify a different file name when you create the archive, and change the location. For details on the file location, see tsm File Paths.

When you unzip the archive, a series of files are created that start with the directory names shown below, and that end with a version number. These files contain the log files from the corresponding directories. The table in this topic explains the possible contents of these 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

By default most Tableau Server log files are found in sub-folders in the following location: C:\ProgramData\Tableau\Tableau Server\data\tabsvc\logs\. The following information focuses on log files in a ziplogs archive.

Logs not included in the ziplog archive

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

  • The TSM log. The tsm.log file is located in C:\Users\<user>\.tableau\tsm .
  • Install and upgrade logs. These logs are associated with the installation and initializing of Tableau Services Manager (TSM). If your installation or upgrade fails, especially after starting the TSM initialization, check these logs first for errors.
    • The install log. By default the app-install.log file is located in C:\ProgramData\Tableau\Tableau Server\logs.
    • The additional node install log. By default the app-worker-install.log file is located in C:\ProgramData\Tableau\Tableau Server\logs on additional nodes.
    • The upgrade log. By default the app-upgrade.log file is located in C:\ProgramData\Tableau\Tableau Server\logs.
  • Setup program logs. These logs are associated with the Setup program.
    • The Tableau_Server_<version_code>_#######.log file is located in C:\Users\<user>\AppData\Local\Temp.
    • The Tableau_Server_<version_code>_#######_Tableau.log file is located in C:\Users\<user>\AppData\Local\Temp.

Shell script logging

Tableau Server scripts are located in the scripts directory (By default: C:\Program Files\Tableau\Tableau Server\packages\scripts.<version_code>\.) and many of these generate logs. These logs are not included in the log file archive. Instead, each time a script is run, the log is saved to:

  • <install_drive>\<install\path>\logs\
  • by default: 

    C:\ProgramData\Tableau\Tableau Server\logs\

Install logs for tabcmd

  • The tabcmd Setup program creates the following logs in C:\Users\<user>\AppData\Local\Temp:
    • Tableau_Server_Command_Line_Utility_(<version_code>)_#######.log
    • Tableau_Server_Command_Line_Utility_(<version_code>)_#######.log_Tableau.log
  • Log Archive File Locations (unzipped archive)

    Files/folders in logs.zip

    Folder names include an instance number and build number:

    <folder>_<instance-number>.<version>.

    Example:

    vizqlserver_0.20182.18.0627.22306037514547718839174

    Details Files

    Note: Logs with names starting control_ are generated by small "control" applications that run briefly when the services are starting up.

    Generated by

    Location on Tableau Server

    (active logs)

    Default base location: C:\ProgramData\Tableau\Tableau Server\data\tabsvc\logs

    activemqserver Logs related to the Tableau Server Messaging Service. control_activemqserver_node<n>-<instance>.log

    stdout_activemqserver_node<n>-<instance>.yyyy-mm-dd.log

    activemq.log

    run-activemqserver_0.cmd \activemqserver
             
    appzookeeper Logs related to the Tableau Server Coordination Service. appzookeeper_node<n>-<n>.log

    control_appzookeeper_node<n>-<n>.log

    appzookeeper.exe \appzookeeper
    backgrounder Logs related to subscriptions and scheduled activities like extract refreshes, "Run Now" tasks, and tabcmd tasks. backgrounder_node<n>-<n>.log

    control_backgrounder_node<n>-<n>.log

    run-backgrounder.exe \backgrounder
    backuprestore Logs related to backup and restore jobs. control_backuprestore_node<n>-<n>.log

    backuprestore.exe \backuprestore
    cacheserver

    Logs related to the Cache Server process.

    control_cacheserver_node<n>-<n>.log

    redis-server.exe \cacheserver
    clientfileservice

    Logs related to the Client File Service process.

    clientfileservice_node<n>-<n>.log

    control_clientfileservice_node<n>-<n>.log

    clientfileservice.exe \clientfileservice
    clustercontroller

    Logs related to the Cluster Controller process.

    clustercontroller.log

    control_clustercontroller_node<n>-<n>.log

    run-clustercontroller.exe \clustercontroller
    databasemaintenance

    Logs related to database maintenance jobs.

    control_databasemaintenance_node<n>-<n>.log

     

    databasemaintenance.exe \databasemaintenance
    dataserver Information about connections to Tableau Server data sources.

    control_dataserver_node<n>-<n>.log

    dataserver_node<n>-<n>.log

    nativeapi_dataserver_<n>-<n>.txt

    run-dataserver.exe \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

      \elasticserver
    filestore File Store logs.

    control_filestore_node<n>-<n>.log

    filestore.log

    run-filestore.exe \filestore
    flowprocessor Logs related to Tableau Prep Conductor.

    control_flowprocessor_node<n>-<n>.log

    flowprocessor_node<n>-<n>.log

    nativeapi_flowprocessor.txt

    stdout_flowprocessor_node<n>-<n>.log

    tdeserver_flowprocessor.txt

    tomcat_flowprocessor_node<n>-<n>.log

    run-flowprocessor.exe \flowprocessor
    gateway

    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

    control_gateway_node<n>-<n>.log

    gateway.log

    Apache daemon \httpd
    hyper There will be a hyper log file for each day with information about data extracts and queries, and responses to VizQL server requests.

    control_hyper_node<n>-<n>.log

    hyper_<n>_####_##_##_##_##_##.log

    hyperd.exe

    \hyper
    interactive Logs related to the Interactive Microservice Container. control_interactive_<node>-<instance>.log

    interactive_<node>-<instance>.log

    stdout_interactive_<node>-<instance>.yyyy-mm-dd.log

    tomcat_noninteractive_<node>-<instance>.yyyy-mm-dd.log

      \interactive
    licenseservice Logs related to licensing.

    control_licenseservice_node<n>-<n>.log

    tablicsrv.log

      \licenseservice
    metrics Logs related to the Metrics service in Tableau Server. control_metrics_node<n>-<n>.log 

    metrics_node1-<n>-<n>.log

      \metrics
    nlp Logs related to the Ask Data service in Tableau Server. control_nlp_node<n>-<n>.log 

    stdout_nlp_node1-<n>-<n>.log

      \nlp
    noninteractive Logs related to the Non-Interactive Microservice Container. control_noninteractive_<node>-<instance>.log

    noninteractive_<node>-<instance>.log

    stdout_noninteractive_<node>-<instance>.yyyy-mm-dd.log

    tomcat_noninteractive_<node>-<instance>.yyyy-mm-dd.log

      \noninteractive
    pgsql PostgreSQL database logs, including files related to launching server processes. control_pgsql_node<n>-<n>.log tabspawn \pgsql
    samlservice Site SAML logs. control_samlservice_node<n>-<n>.log samlservice.exe \samlservice
    searchserver Logs related to search indexing.

    control_searchserver_node<n>-<n>.log

    searchserver_node<n>_<n>.log

    searchserver.exe \searchserver
    siteimportexport Logs related to site import and site export.

    control_siteimportexport_node<n>-<n>.log

    siteimportexport.exe \siteimportexport
    tabadminagent Logs related to the TSM Administration Agent.

    control_tabadminagent_node<n>-<n>.log

    tabadminagent_node<n>-<n>.log

      \tabadminagent
    tabadmincontroller Logs related to the TSM Administration Controller.

    control_tabadmincontroller_node<n>-<n>.log

    tabadmincontroller_node<n>-<n>.log

    tabadmincontroller.exe \tabadmincontroller
    tabsvc  

    control_tabsvc_node<n>-<n>.log

    tabsvc_node<n>-<n>.log

    tabsvc.exe \tabsvc
    tdsnativeservice Logs related to the Internal Data Source Properties service. control-tdsnativeservice_node<n>-#.log

    nativeapi_tdsnativeservice_#.log

      \tdsnativeservice
    tdsservice Logs related to the Data Source Properties service. control-tdsservice-#.log

    tomcat_tdsservice_#.log

      \tdsservice
    vizportal Information related to administrative tasks, workbook and permissions management, authentication, sign-ins, initial view requests, and publishing requests.

    REST API requests. Log entries related to REST API requests 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.

    control_vizportal_node<n>-<n>.log

    vizportal_node<n>-<n>.log

    run-vizportal.exe \vizportal
    vizqlserver Related to showing 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<n>-<n>.log

    vizqlserver_node<n>-<n>.log

    run-vizqlserver.exe \vizqlserver

     

    Tableau Server Log File Locations

    If you installed Tableau Server in the default location, the log directory is C:\ProgramData\Tableau\Tableau Server\data\tabsvc\logs\. The ProgramData folder is hidden unless you explicitly make it visible.

    The following log files track activities related to the web application, database, and index:

    C:\ProgramData\Tableau\Tableau Server\data\tabsvc

     

    If you have installed Tableau Server to a non-default location (for example, on a drive other than the system drive), then the logs directory is located at <installation path or drive>\Tableau\Tableau Server\logs. For more information, see Before you install....

    Temporary Files

    Any file that starts with exe_ in the folder below is a Tableau Server file and can be deleted.

    C:\ProgramData\Tableau\Tableau Server\temp

    Thanks for your feedback! There was an error submitting your feedback. Please try again.