Creating Tableau Server Log Files
Last Modified Date: 01 Oct 2015
Article Note: This article is no longer actively maintained by Tableau. We continue to make it available because the information is still valuable, but some steps may vary due to product changes.
Creating logs in Tableau Server can be useful to assist Tableau in determining the causes of issues you experience. For most scenarios, you will not need to stop the Tableau Server to generate log files. Tableau Support will notify you if the Server must be stopped before running the log files. Use the directions below to generate and send log files to Tableau Support. If you are running a distributed environment installation of Tableau Server, perform this task from the primary machine. Any worker machine logs will be included in the log files.
Note: If you use an automated cleanup process, as described in the Server Backup and Maintenance article, the
cleanup command will remove all of your log files. To ensure that you have the ability to access existing log files, consider including a
ziplogs command in your automated cleanup process. This will save your log files in case you need them.
Creating log files
Click the Start button, and then select All Programs > Accessories. Right-click Command Prompt and select Run as administrator.
Type one of the following commands, based on your operating system:
cd C:\Program Files\Tableau\Tableau Server\[version]\bin
cd C:\Program Files (x86)\Tableau\Tableau Server\[version]\bin
[version] with the version of Tableau Server that you are running.
Create the log file by typing the following command:
tabadmin ziplogs -l -n -d mm/dd/yyyy
-l is lower case L. Also, replace
mm/dd/yyyy with an actual date that is two days prior to the day you experienced the issue.
This creates a file named logs.zip in the Tableau Server "bin" folder that was created during installation.
Send Tableau this logs.zip file as an attachment when you report your issue.
Options for creating log files
There are additional options when using the
tabadmin ziplogs command. You can run the command with
-h to see the full list of options.
Below are some commonly used options.
Limit the included dump files to only the most recent one to help reduce file size. By default the 10 most recent dump files are included.
Force overwrite of existing file.
Includes information about which ports are in use and additional Netstat information.
-d, --minimumdate mm/dd/yyyy
Includes files created on or after date. Default is 7 days prior to current date.
Includes all files (ignore -d switch).
Includes PostgreSQL data folder ('psql/data'). A useful option when working with Tableau Support to diagnose issues.
Note: With Tableau Server 9.0 and earlier, the server must be stopped to use the -p option. Beginning with version 9.1, you can use the -p option even if Tableau Server is running. When Tableau Server is running, this option collects the PostgreSQL data as binary dump files.
Sending the Tableau Server log file
Follow the directions for sending large files in the article Sending Large Files. When attaching the file, browse to the logs.zip file in the "bin" folder of the Tableau Server directory. For example,
C:\Program Files\Tableau\Tableau Server\[version]\bin where
[version] is the version of Tableau Server you are running.
If the file transfer times out or otherwise fails to send, please contact Tableau Support for additional assistance.Alternate Search Terms:server, server logs, server log file, server log files, log files, data source, downloads, upgrades, licenses, installation,