jutian / tableau-log-viewer

Tableau Log Viewer is a cross-platform tool for quickly glancing over Tableau log files

Tableau Log Viewer

Master branch
Dev branch

Tableau Log Viewer is a cross-platform tool with a simple interface that has a single purpose of making it easy to quickly glance over Tableau log files.

Overview

• Tableau log file representation in easy to read columnar format
• Live capture from Tableau's log files
• Advanced event search, filtering and highlighting
• Query syntax highlighting
• Compatible with Windows, Mac and, most likely, Linux

How do I use Tableau Log Viewer?

You can get the latest release in the Releases Section. Download the ZIP file of the latest release for your operating system (Windows and Mac OS available) and extract the ZIP file. Finally, launch the application (tlv.exe for Windows and tlv.app for Mac).

To view logs, drag'n'drop a Tableau log file into the application. Both Tableau Desktop and [most] Tableau Server log files are supported. Take a look at our wiki to get more details on the features and usage of TLV.

Using Pre-Built Tableau Log Viewer on M1 Mac If you are trying to open a downloaded pre-built version of Tableau Log Viewer on an M1 Mac, this may fail as the application is not code-signed. You can code-sign the application yourself using sudo codesign --force --deep -s - /path/to/tlv.app and then launch it for the first time via CTRL + <right-click Open>.

How do I build Tableau Log Viewer?

See INSTALL.md

Is Tableau Log Viewer supported?

Tableau Log Viewer is supported by the community. This is intended to be a self service tool and includes a user guide. Any requests or issues discovered should be filed in the Issue Tracker.

How can I contribute to Tableau Log Viewer?

Code contributions & improvements by the community are welcomed & encouraged! See the LICENSE file for current open-source licensing and use information. Also, if you are new to GitHub - read this handy guide on how to get started!

A Word About Licenses

Tableau Log Viewer is released under MIT license however it relies on several other components:

• Qt. We are using Qt's components that are licensed under LGPLv3 license. Qt source code is located here and instructions for obtaining it are located here. We will be keeping these links up to date and making sure they provide clear directions for obtaining Qt's source code in case you need it.
• Query Graphs. This is our side project that is used for query tree visualization. It is released under the MIT license and uses the d3js library, released under the BSD license.
• Solarized theme. This a collection of colors and guidelines for UI applications designed by Ethan Schoonover. The "Solarized Light" and "Solarized Dark" themes in TLV are using these color schemes. It is released under the MIT license.