README.md

dissect-tester

This project presents a simple web UI to test a collection of log line samples against a pattern supported by the Filebeat dissect processor.

Both Logstash and Elasticsearch pipelines have a similar filter/processor that uses the same configuration pattern. Therefore, this UI can be used to test a pattern that will be used in either Logstash or Elasticsearch pipelines.

🎮 Installing / Getting started

🔗 If you only want to test some samples you can go directly to the demo instance running in http://dissect-tester.jorgelbg.me/.

New releases are published to a public Docker image. To run it you can use the following command:

docker run --rm -ti -p 8080:8080 jorgelbg/dissect-tester

The terminal should print a couple of messages similar to

{"level":"info","timestamp":"2020-06-30T01:42:16.838+0200","caller":"dissect-tester/main.go:112","msg":"maxprocs: Leaving GOMAXPROCS=8: CPU quota undefined"}
{"level":"info","timestamp":"2020-06-30T01:42:16.838+0200","caller":"dissect-tester/main.go:137","msg":"Server is running","port":8080}

Indicating the the server is running. Head your browser to http://localhost:8080/ and enjoy 🎉.

Your browser should show the following:

👨🏻‍💻 Developing

git clone https://github.com/jorgelbg/dissect-tester
cd dissect-tester/
make

This will build a binary placed in bin/github.com/jorgelbg/dissect-tester for your native platform.

If you want to build a new Docker image use the following command:

make docker

For running all tests you can use:

make test

🤚🏻 Contributing

If you'd like to contribute, please fork the repository and use a feature branch. Pull requests are warmly welcome.

🚀 Links

• Project homepage/Demo: http://dissect-tester.jorgelbg.me/
• The project icon is based on the icon made by monkik in www.flaticon.com
• Icons made by Pixel perfect from www.flaticon.com