Lottip is proxy for MySQL RDBMS with web GUI. It will show you what's happening under the hood of your database layer. As it sits between your application and MySQL server there's no need to use tools like Wireshark or enable general logs to see which queries are being executed. It comes as single binary with zero dependencies and consists of 2 parts: proxy server and embedded GUI.
| Query list | Freezed query | Query error | In app results |
|---|---|---|---|
 |
 |
 |
 |
Lottip is on it's early stage of development.
For now you can:
- See all queries sent from your application to MySQL grouped by connection it belongs to.
- Track query execution result: success(green indicator), pending(yellow indicator) and error(red indicator).
- See query execution time(it includes time to transfer data over network).
- Filter queries by string.
- Execute any query and see results immediately.
- Run lottip in Docker container. Thanks to @tm-lmathieu
Get binaries from releases page
go get github.com/orderbynull/lottip
go install github.com/mjibson/esc
cd $GOPATH/src/github.com/orderbynull/lottip
$GOPATH/bin/esc -o fs.go -prefix web -include=".*\.css|.*\.js|.*\.html|.*\.png" web
go build
./lottip
There're 4 simple steps to get everything up and running:
-
Run binary from terminal like this:
./lottip_linux_amd64. You'll see something like this:Forwarding queries from '127.0.0.1:4041' to '127.0.0.1:3306'Web gui available at 'http://127.0.0.1:9999' -
Tell your app to connect to MySQL via port 4041 instead of 3306.
-
Go to http://127.0.0.1:9999 and you'll see nice GUI.
-
Play with your app and see all SQL-queries flowing between your app and MySQL. No need for page refresh because websockets are used to communicate between frontend and backend.
Here're few use cases i use on my everyday basis so it may be helpful to someone.
Just run lottip on your local machine and point your app to it. You can also run few lottip instances each on it's own port. This is an easy way to keep multiple app separated and view queries independently.
Let's say you're writing your PHP code locally but run it on dev server and do not want to expose lottip to outside world. In this case here's what you may do:
- Upload lottip binary to remote dev server and run it like this:
./lottip_linux_amd64 - Create ssh tunnel from your local machine to remote dev server like this:
ssh -nNT -L 9999:127.0.0.1:9999 user@your-devserver.com. This command will map your local:9999to remote:9999 - Tell your remote app to use MySQL on port
:4041 - Open http://127.0.0.1:9999 locally.
You can change default values to whatever you need.
| option available | default value | description |
|---|---|---|
--proxy |
127.0.0.1:4041 |
<ip>:<port> of proxy server. Your code should make connections to that address to make proxy work. Example: --proxy=127.0.0.1:4045 |
--mysql |
127.0.0.1:3306 |
<ip>:<port> of MySQL server. Example: --mysql=192.168.0.195:3308 |
--gui |
127.0.0.1:9999 |
<ip>:<port> of embedded GUI. Example: --gui=127.0.0.1:8080 |
--mysql-dsn |
"" |
If you need to execute queries from the app you need to provide DSN for MySQL server. DSN format: [username[:password]@][protocol[(address)]]/[dbname[?param1=value1&...¶mN=valueN]] All values are optional. So the minimal DSN is /dbname. If you do not want to preselect a database, leave dbname empty: / Example: --mysql-dsn=root:root@/ |
- Write Unit tests
- Implement more features of MySQL protocol
- Add query filtering by string
- Add sql code highlighting
- Add sql code formatting
- Add possibility to execute query right from GUI and see results
- Add ssl support
- Add support of PostgreSQL protocol
- ... and more
Currently lottip does not support secure connections via ssl. The workaround is to disable SSL on MySQL server or connect with option like --ssl-mode=DISABLED
You're very welcome to report bugs, make pull requests, share your thoughts and ideas!
MIT