lottip

KO | EN

gitlite — search

#hacktoberfest #ai #golang #go #android #machine-learning #rust #linux #docker #cli #kubernetes #vue #mcp #open-source

(★ 273)

Simple MySQL proxy for query logging with web GUI

File Explorer

Download Latest Version (.zip)

- client.go
- hub.go
- states.go
- Dockerfile
- run.sh
- const.go
- decoder.go
- decoder_test.go
- packet.go
- - modules.xml
  - web.iml
  - workspace.xml
- - bootstrap-theme.min.css
  - bootstrap.min.css
  - style.css
- - favicon.png
- - app.js
  - bootstrap.min.js
  - clipboard.min.js
  - jquery.min.js
  - lodash.min.js
  - vue.min.js
- index.html
.gitignore
fs.go
http.go
LICENSE.md
main.go
proxy.go
README.md
utils.go

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# 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`|`<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&...&paramN=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

lottip

File Explorer

Today's picks

Was this content helpful?

Recent Feedback

lottip

File Explorer

Today's picks

Was this content helpful?

Recent Feedback

Download README