Parsing, dumping, viewing and analysing tools for SAZ (Fiddler) files
npm install saz-tools
!GitHub go.mod Go version
!Docker Image Version (latest by date)
Tools for parsing SAZ files (Fiddler logs) and either [printing their content] on the console, or [viewing them on a web page] and offering basic analysis and export. Try the [on-line version] of the SAZ Viewer.
If you have [Go] installed, using [go get] to install a global module is the easiest way:
$ GO111MODULE=off go get -u github.com/prantlf/saz-tools/...
If you have [Node.js] installed, you can use [NPM], [Yarn] or [PNPM] to install a global module easily:
npm i -g saz-tools
yarn global add saz-tools
pnpm i -g saz-tools
If you have the standard sh available, you can use the installation script from [GoBinaries]:
curl -sf https://gobinaries.com/prantlf/saz-tools | sh
If you manage your software using [Homebrew], you can install the tools using their formula:
brew install prantlf/tap/saz-tools
Windows users can install using the [Scoop manifest]:
scoop bucket add prantlf https://github.com/prantlf/scoop-bucket.git
scoop install prantlf/saz-tools
Ubuntu users can install the [Snap package]:
sudo snap install saz-tools
If you work on Linux which uses deb or rpm packages, you can download and install a package from [GitHub releases].
Or download and unpack a binary archive for your operation system from [GitHub releases] directly.
If you want to install a specific commit or the latest master and you do not have the development environment to build it, you can use Docker to [build]:
git clone https://github.com/prantlf/saz-tools.git
cd saz-tools
docker run --rm -it -v ${PWD}:/work -w /work \
prantlf/golang-make-nodejs-git clean prepare all DOCKER=1
If you want to run the tools using [Docker] images, see the instructions below.
``
$ sazdump.go -h
Usage: sazdump [options]
Options:
-version | -v : print the version of this tool and exit
$ sazdump foo.saz
Number Timeline Method Code URL Begin End Duration Size Encoding Cache Process
1 00:00.000 GET 200 https://example.com/foo 16:11:58.755 16:11:59.013 00:00.257 506 gzip max-age=31536000 chromium:18160
2 00:01.573 GET 200 https://example.com/bar 16:11:59.419 16:11:59.873 00:00.454 1,201 raw no-store,no-cache chromium:18160
...
$ sazserve -h
Usage: sazserve [options]
Options:
-browser : start the web browser automatically (default false)
-port
-version | -v : print the version of this tool and exit
$ sazserve
$ open http://localhost:7000/
`
* [parser].ParseFile ([] [parser.Session], error)
* [parser].ParseReader ([] [parser.Session], error)
* [analyzer].Analyze ([] [analyzer.Session], error)
* [dumper].Dump error
`go
import (
"github.com/prantlf/saz-tools/pkg/analyzer"
"github.com/prantlf/saz-tools/pkg/dumper"
"github.com/prantlf/saz-tools/pkg/parser"
)
func main() {
rawSessions, _ := parser.ParseFile("foo.saz")
fineSessions, _ := analyzer.Analyze(rawSessions)
dumper.Dump(rawSessions)
}
`
You need [Go], [Make], [Node.js], [NPM] and [Patch] to build all parts of this module from sources.
# Install build tools only once:
make prepare
# Build all targets:
make
# Dump a SAZ file analysis on the console:
make run-dump SAZ="..."
# Start a SAZ file viewer as a browser application with bundled assets:
make run-serve
# Start a SAZ file viewer as a browser application with filesystem assets:
make debug-serve
# Remove all build output:
make clean
 
[The sazdump image] and [the sazserve image] allows you to execute the tools described above. They are built automatically on the top of the tag latest from the [scratch image].
The following tags are available for the prantlf/sazdump and prantlf/sazserve images:
- latest
Download the latest image to your disk:
docker pull prantlf/sazdump
docker pull prantlf/sazserve
# or
docker pull prantlf/sazdump:latest
docker pull prantlf/sazserve:latest
Print usage description with command-line parameters:
docker run --rm -it prantlf/sazdump -h
For example, dump the context of the foo.saz file:
docker run --rm -it -v ${PWD}:/work -w /work sazdump foo.saz
Or start the browser application to analyse SAZ files on your machine:
docker run --rm -it -p 7000:7000 sazserve
You can also put [sazdump] and [sazserve] scripts to PATH:
#!/bin/sh
docker run --rm -it -v ${PWD}:/work -w /work sazdump "$@"
#!/bin/sh
docker run --rm -it -v -p 7000:7000 sazserve
and execute then from any location by supplying parameters to it, for example:
sazdump foo.saz
sazserve
Local images are built as sazdump and sazserve and they are pushed to the docker hub as prantlf/sazdump:latest and prantlf/sazserve:latest.
# Check the Dockerfiles:
make docker-lint
# Build new local images:
make docker-build
# Print the help for the SAZ file dumper:
make docker-run-help
# Dump a SAZ file analysis on the console:
make docker-dump-example SAZ="..."
# Start a SAZ file viewer as a web application:
make docker-serve-example
# Tag local images for pushing:
make docker-tag
# Login to the docker hub:
make docker-login
# Push local images to the docker hub:
make docker-push
# make all changes, bump the version and tag it
make clean prepare lint all
conventional-changelog -p angular -i CHANGELOG.md -s
# update the tag
snapcraft login --with snap.login
goreleaser release --rm-dist
# pull and update brew, update scoop
# push to heroku
Copyright (c) 2020-2021 Ferdinand Prantl
Licensed under the MIT license.
[on-line version]: https://viewsaz.herokuapp.com/
[go get]: https://golang.org/cmd/go/#hdr-Add_dependencies_to_current_module_and_install_themsazdump
[Go]: https://golang.org/
[golang repository]: https://hub.docker.com/_/golang
[Homebrew]: https://brew.sh/
[Snap package]: https://snapcraft.io/saz-tools
[Scoop manifest]: https://github.com/prantlf/scoop-bucket#prantlfscoop-bucket
[Docker]: https://www.docker.com/
[Make]: https://www.gnu.org/software/make/
[Patch]: http://man7.org/linux/man-pages/man1/patch.1.html
[Node.js]: https://nodejs.org/
[NPM]: https://docs.npmjs.com/cli/npm
[Yarn]: https://classic.yarnpkg.com/docs/cli/
[PNPM]: https://pnpm.js.org/pnpm-cli
[GoBinaries]: https://gobinaries.com/
[GitHub releases]: https://github.com/prantlf/saz-tools/releases
[The image]: https://hub.docker.com/repository/docker/prantlf/sazdumpsazserve
[the image]: https://hub.docker.com/repository/docker/prantlf/sazservebuild
[scratch image]: https://hub.docker.com/_/scratch
[]: bin/buildsazdump
[]: bin/sazdumpsazserve`]: bin/sazserve
[
[printing their content]: https://godoc.org/github.com/prantlf/saz-tools/cmd/sazdump
[viewing them on a web page]: https://godoc.org/github.com/prantlf/saz-tools/cmd/sazserve
[parser]: https://godoc.org/github.com/prantlf/saz-tools/pkg/parser
[parser.Session]: https://godoc.org/github.com/prantlf/saz-tools/pkg/parser#Session
[ParseFile]: https://godoc.org/github.com/prantlf/saz-tools/pkg/parser#ParseFile
[ParseReader]: https://godoc.org/github.com/prantlf/saz-tools/pkg/parser#ParseReader
[analyzer]: https://godoc.org/github.com/prantlf/saz-tools/pkg/analyzer
[analyzer.Session]: https://godoc.org/github.com/prantlf/saz-tools/pkg/analyzer#Session
[Analyze]: https://godoc.org/github.com/prantlf/saz-tools/pkg/analyzer#Analyze
[dumper]: https://godoc.org/github.com/prantlf/saz-tools/pkg/dumper
[Dump]: https://godoc.org/github.com/prantlf/saz-tools/pkg/dumper#Dump