LogShark is a tool for analyzing and troubleshooting Tableau Server and Tableau Desktop. LogShark extracts data from log files and builds workbooks that can help you identify and understand error conditions, performance bottlenecks, and background activity. LogShark works by running a set of targeted plugins that pull specific data out of the log files, building data sources, and generating Tableau workbooks which can be used for analysis.
LogShark can help you:
- Troubleshoot issues that are recorded in the logs.
- Analyze system metrics from log data.
- Solve problems in Tableau without exposing sensitive corporate information.
- Validate Tableau Server application behavior against historical data when taking a new build or making a system change.
See the releases page for a full list of updates.
There are 2 ways you can use LogShark.
Download and unzip the precompiled self-contained application from the following links:
Note that LogShark is configured by the LogSharkConfig.json file in the Config directory. If you are replacing an existing copy of LogShark, be mindful of any changes made to this configuration file.
LogShark is a .NET Core 2.1 application. To compile it yourself, first clone or download the repository. Then run the following command:
Windows
dotnet publish LogShark -c Release -r win-x64 --self-contained true
Mac
dotnet publish LogShark -c Release -r osx-x64 --self-contained true
The best way to analyze results is to run LogShark on your own logset and explore the generated workbooks via Tableau. Beyond what is included, you can configure LogShark to output your own custom workbooks. See the installation guide for more details on how to do this.
LogShark is released as a Community-Supported tool. It is intended to be a self-service tool and includes this user guide. Any bugs discovered should be filed in the LogShark Git issue tracker.
Code contributions & improvements by the community are welcomed and encouraged! See the LICENSE file for current open-source licensing & use information. Before we can accept pull requests from contributors, we do require a Contributor License Agreement. See http://tableau.github.io for more details.