Knowledge Base

Creating Tableau Server Log Files

Product(s): Tableau Server
Version(s): All
Last Modified Date: 04 Apr 2014

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

Step 1

Click the Start button, and then select All Programs > Accessories. Right-click Command Prompt and select Run as administrator.

Step 2

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

Note: Replace [version] with the version of Tableau Server that you are running.

Step 3

Create the log file by typing the following command: tabadmin ziplogs -l -n -d mm/dd/yyyy

Note: The -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.

Step 4

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.

  • -l, --with-latest-dump

    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.

  • -f, --force

    Force overwrite of existing file.

  • -n, --with-netstat-info

    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.

  • -a, --all

    Includes all files (ignore -d switch).

  • -p

    Includes PostgreSQL data folder ('psql/data'). A useful option when working with Tableau Support to diagnose issues.

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,
Did this article resolve the issue?

Attachments

Search Knowledge Base