LumberSnake

Tableau VizQL log analysis tool. Processes Tableau Server logs into .hyper files for performance analysis in Tableau.

Requirements

• Python 3.10+
• Tableau Server 2018.2+ (TSM versions)

Installation

pip install .

Or for development:

pip install -e ".[dev]"

Usage

Process a zip file of Tableau Server logs:

lumbersnake process logs.zip

Process an extracted log directory:

lumbersnake process /path/to/logs --source-type directory

Options:

--output, -o      Output file path (default: LumberSnake.hyper)
--append          Append to existing hyper file
--force, -f       Overwrite without prompting
--no-telemetry    Disable Tableau telemetry
--keep-temp       Keep extracted temp files

Output

The tool creates a LumberSnake.hyper file with three tables:

• qplog - Query performance data from VizQL logs
• excplog - Exception data from VizQL logs
• HTTP - Access log data

Open LumberSnake (HyperAPI).twb in Tableau and connect to the generated .hyper file.

Development

Run tests:

pytest

Type checking:

mypy src/lumbersnake/

Archive

Legacy scripts and workbooks are preserved in the archive/ folder for reference.

Credits

@Ludwig Ehlert & Adrian Vogelsgesang for contributions to the original implementation.