A Tableau log file analysis utility
Switch branches/tags
Nothing to show
Clone or download
Permalink
Failed to load latest commit information.
ArtifactProcessors Merge 2.1 into master (#46) Jun 6, 2018
LogParsers.Base Merge 2.1 into master (#46) Jun 6, 2018
Logshark.ArtifactProcessorLib Merge 2.1 into master (#46) Jun 6, 2018
Logshark.ArtifactProcessorModel Merge 2.1 into master (#46) Jun 6, 2018
Logshark.CLI.Installer.Bundle Integrating development into master (#23) Sep 27, 2017
Logshark.CLI.Installer Merge 2.1 into master (#46) Jun 6, 2018
Logshark.CLI Merge 2.1 into master (#46) Jun 6, 2018
Logshark.Common Merge 2.1 into master (#46) Jun 6, 2018
Logshark.ConfigSection Merge 2.1 into master (#46) Jun 6, 2018
Logshark.ConfigSectionGenerator Merge 2.1 into master (#46) Jun 6, 2018
Logshark.ConnectionModel Merge 2.1 into master (#46) Jun 6, 2018
Logshark.Core Merge 2.1 into master (#46) Jun 6, 2018
Logshark.PluginLib Merge 2.1 into master (#46) Jun 6, 2018
Logshark.PluginModel Merge 2.1 into master (#46) Jun 6, 2018
Logshark.RequestModel Merge 2.1 into master (#46) Jun 6, 2018
Logshark.Tests Merge 2.1 into master (#46) Jun 6, 2018
Plugins Merge 2.1 into master (#46) Jun 6, 2018
Tableau.RestApi Merge 2.1 into master (#46) Jun 6, 2018
Templates Merge 2.1 into master (#46) Jun 6, 2018
docs Updated download link on install page Jul 30, 2018
wix/3.10.1 Initial commit. Nov 2, 2016
.gitignore Merge 2.1 into master (#46) Jun 6, 2018
LICENSE Initial commit Sep 17, 2016
Logshark Artifact Processor Project Template.vsix Merge 2.1 into master (#46) Jun 6, 2018
Logshark Workbook Creation Plugin Project Template.vsix Merge 2.1 into master (#46) Jun 6, 2018
Logshark.sln Merge 2.1 into master (#46) Jun 6, 2018
README.md Updated readme.md with new download link (#47) Jun 6, 2018
Test.runsettings Initial commit. Nov 2, 2016

README.md

Logshark

Community Supported

Logshark is a command line utility that you can run against Tableau Server logs to generate a set of workbooks that provide insights into system performance, content usage, and error conditions.

Some common use cases for Logshark include:

  • Troubleshooting issue(s) that are recorded in the logs.
  • Analyzing system metrics from log data.
  • Self-solving problems in Tableau without the fear of exposing sensitive corporate information.
  • Regularly validating Tableau Server application behavior against historical data when taking a new build or making a system change.

Sample Apache Workbook Screenshot

How do I set up Logshark?

Download Logshark

Setup Logshark

Logshark is deployed via a custom installer, which you can download from the releases page. The installer manages dependencies and also bundles MongoDB for ease of setup for new users. You will need to set up a Postgres database. To get up and running, download the installer and then follow the instructions in the installation guide to configure it.

Logshark requires a 64-bit version of Windows in order to run, and must be run as an account with administrator privileges.

NOTE: If you are upgrading from a previous version of Logshark, the installer will handle most of the upgrade work for you, but during the upgrade your Logshark.config file will be overwritten. If there are settings from this config you wish to preserve, please make a backup.

How do I analyze results from Logshark?

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.

For the truly adventurous, Logshark features a plugin framework, so you can even build your own analysis plugin to leverage Logshark’s log parsing engine!

What do I need to build Logshark from source?

The current development requirements are:

  1. Windows operating system. (64-bit)
  2. Visual Studio 2015 or later.
  3. WiX Toolset Visual Studio Extension v3.10.1 or later - Required if you wish to to modify the installer projects.
  1. Configuration Section Designer Visual Studio Extension - Required if you wish to modify & regenerate the "LogsharkConfigSection" custom config section class.

It is recommended that you install the Logshark Workbook Creation Plugin Project Template extension by running the "Logshark Workbook Creation Plugin Project Template.vsix" file found in the root directory. This adds a "Logshark Workbook Creation Plugin" project type to Visual Studio which you can use to easily get up and running developing a new plugin.

Note that you do not need to build Logshark from source to use it; a pre-built installer is available on the releases page.

Is Logshark supported?

Logshark is Community Supported. This is intended to be a self-service tool and includes a user guide. Any bugs discovered should be filed in the Logshark Git issue tracker.

How can I contribute to Logshark?

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.