# lottip **Repository Path**: runningnoob/lottip ## Basic Information - **Project Name**: lottip - **Description**: Simple MySQL proxy for query logging with web GUI - **Primary Language**: Unknown - **License**: MIT - **Default Branch**: master - **Homepage**: None - **GVP Project**: No ## Statistics - **Stars**: 0 - **Forks**: 0 - **Created**: 2021-05-27 - **Last Updated**: 2021-05-27 ## Categories & Tags **Categories**: Uncategorized **Tags**: None ## README # Lottip 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. # Screenshots | Query list |Freezed query|Query error |In app results | |---------------|-------------|--------------|---------------------| |![Example 1](https://image.ibb.co/fjzeQF/query_list.png)|![Example 2](https://image.ibb.co/iPt65F/sleep.png)|![Example 3](https://image.ibb.co/c464sv/error.png)|![Example 4](https://image.ibb.co/fVCoKa/dialog.png)| # Main features **Lottip is on it's early stage of development.** For now you can: 1. See all queries sent from your application to MySQL grouped by connection it belongs to. 2. Track query execution result: success(green indicator), pending(yellow indicator) and error(red indicator). 3. See query execution time(it includes time to transfer data over network). 4. Filter queries by string. 5. Execute any query and see results immediately. 6. Run lottip in Docker container. Thanks to [@tm-lmathieu](https://github.com/tm-lmathieu) # Installation ###### Binary Get binaries from [releases](https://github.com/orderbynull/lottip/releases) page ###### From sources on Mac/Linux 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 # How to run There're 4 simple steps to get everything up and running: 1. 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'` 2. Tell your app to connect to MySQL via port *4041* instead of *3306*. 3. Go to [http://127.0.0.1:9999](http://127.0.0.1:9999) and you'll see nice GUI. 4. 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.** # Use cases Here're few use cases i use on my everyday basis so it may be helpful to someone. ###### Use locally 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. ###### Use remotely 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: 1. Upload lottip binary to remote dev server and run it like this: `./lottip_linux_amd64` 2. 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 `:9999` to remote `:9999` 3. Tell your remote app to use MySQL on port `:4041` 4. Open [http://127.0.0.1:9999](http://127.0.0.1:9999) locally. # Options You can change default values to whatever you need. | option available | default value | description | ---------------------- |-----------------|------------------------------------------------------------------------------------------------- | `--proxy` | `127.0.0.1:4041`|`:` 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`|`:` of MySQL server. *Example: `--mysql=192.168.0.195:3308`* | `--gui` | `127.0.0.1:9999`|`:` 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@/`* # ToDo - [ ] Write Unit tests - [ ] Implement more features of MySQL protocol - [x] Add query filtering by string - [ ] Add sql code highlighting - [ ] Add sql code formatting - [x] Add possibility to execute query right from GUI and see results - [ ] Add ssl support - [ ] Add support of PostgreSQL protocol - [ ] ... and more # Known problems 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](https://dev.mysql.com/doc/refman/5.7/en/secure-connection-options.html#option_general_ssl-mode) # Contribute You're very welcome to report bugs, make pull requests, share your thoughts and ideas! # Licence MIT