Log File Snapshots (Archive Logs)

Tableau Server includes functionality to generate a snapshot of log files for archival purposes. If you plan to clean up and delete old log files as part of regular server maintenance, you may consider archiving log files to an off-server storage location before deleting them.

Or, if you are working with Tableau Support on a case, the support engineer may request a server log file snapshot.

This topic describes:

  • How to generate a log file snapshot
  • How to send the snapshot directly to Tableau Support from the Tableau Server administration tools
  • How to download the snapshot
  • How to delete archived logs
  1. Open TSM in a browser:

    https://<tsm-computer-name>:8850. For more information, see Sign in to Tableau Services Manager Web UI.

  2. Click the Maintenance.

  3. Generate a log file snapshot.

    1. On the Server Maintenance page, under Log Files, click Generate Log File Snapshot.

      An options dialog displays:

    2. On the Options page, enter or select the options you want, including a Description, time Range of log files to be included, and the optional types of logs to be included (Include Postgres Data, Include Recent Crash Dumps), then click Generate Log File Snapshot.

    The log file snapshot is saved to a fixed location on the computer where TSM and Tableau Server are installed. If you have a multi-node installation, the snapshot is saved to the initial node of the cluster. The location is specified by the basefilepath_log_archives variable.

    By default the snapshot is saved to:

    /var/opt/tableau/tableau_server/data/tabsvc/files/log-archives

    You can find the current location by querying the basefilepath.log_archives setting, and change the location by specifying a new value for basefilepath.log_archive. For more information, see tsm File Paths.

  4. After you generate the snapshot, you can select it and upload it to Technical Support, download it to your local machine, or delete it:

  5. To download a local copy of the snapshot or to delete it, select the snapshot under Log Files and then select the appropriate Action.

Uploading log snapshots for Tableau Support

  1. Click the Maintenance tab.

  2. Select the snapshot you want to send.

  3. Click Upload to Technical Support Case.

  4. In the dialog that displays, enter the Support Case Number and your Contact Email Address, then click Upload Snapshot.

For additional methods to send log archives to Tableau Support, see Sending Large Files to Tableau(Link opens in a new window) in Salesforce Help.

You create a snapshot archive of Tableau Server log files using the tsm maintenance ziplogs command.

By default, this command creates a zip file containing all of the log files. If you are running a distributed installation of Tableau Server, perform this step from the initial node. Logs from all nodes will be included in the zip file.

Note: If you cannot run the ziplogs command successfully, you can manually zip the Tableau Server logs. For more information, see Troubleshoot Tableau Server on Linux.

To create a log file snapshot:

  1. On the initial node, open a terminal session.

  2. Type the following command:

    tsm maintenance ziplogs -l -f <filename>

    where <filename> is name of the zipped archive file you want to create. Choose a unique name with no spaces. If an existing ziplog with the same file name already exists the creation of the file will fail unless you include the -o option to force an overwrite, delete the existing file, or specify a different name in the command.

    You can specify a time range for the snapshot and the types of logs to include. For example, if you know when an error occurred, use the --startdate and --enddate options to capture logs from a few hours before and after the error:

    tsm maintenance ziplogs -f <filename> --startdate "<mm/dd/yyyy H:mm>" --enddate "<mm/dd/yyyy H:mm>"

    For more information, see tsm maintenance ziplogs.

    The log file snapshot is saved to a fixed location on the computer where TSM and Tableau Server are installed. If you have a multi-node installation, the snapshot is saved to the initial node of the cluster. The location is specified by the basefilepath_log_archives variable.

    By default the log file snapshot is saved to:

    /var/opt/tableau/tableau_server/data/tabsvc/files/log-archives

    You can find the current location by querying the basefilepath.log_archives setting:

    tsm configuration get -k basefilepath.log_archive

    and change the location by specifying a new value for basefilepath.log_archive:

    tsm configuration set -k basefilepath.log_archive -v "<drive>:/new/directory/path"

    For more information, see tsm File Paths.

Sending log archives to Tableau Support

You can send log files to Tableau Support as a part of a customer support case (a customer support case number is required). Before sending a log file, use tsm maintenance ziplogs command to combine the log files into a single zip file archive.

  • In a terminal session, type the following command:

    tsm maintenance send-logs -f <zip file name> -c <case number> -e <email address>

    where <case number> is your support case number, <email address> is your contact email for this support case, and <zip file name> is the file name of your archive with .zip file extension.

For additional methods to send log archives to Tableau Support, see Sending Large Files to Tableau(Link opens in a new window) in Salesforce Help.

Thanks for your feedback!Your feedback has been successfully submitted. Thank you!