Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/faressoft/mysql-punisher
☠️ Watch and kill active mysql queries that exeeded a specefic timeout
https://github.com/faressoft/mysql-punisher
Last synced: about 2 months ago
JSON representation
☠️ Watch and kill active mysql queries that exeeded a specefic timeout
- Host: GitHub
- URL: https://github.com/faressoft/mysql-punisher
- Owner: faressoft
- License: mit
- Created: 2016-09-05T15:42:29.000Z (over 8 years ago)
- Default Branch: master
- Last Pushed: 2018-06-17T07:04:23.000Z (over 6 years ago)
- Last Synced: 2024-09-26T15:11:15.690Z (3 months ago)
- Language: JavaScript
- Homepage:
- Size: 34.2 KB
- Stars: 1
- Watchers: 3
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- awesome-jordan - MySQL Punisher - Watch and kill active mysql queries that exeeded a specefic timeout. (NodeJS / Gists)
README
# MySQL Punisher
[](https://www.npmjs.com/package/mysql-punisher)
[](https://github.com/faressoft/mysql-punisher/blob/master/LICENSE)
Watch and kill active mysql queries that exeeded a specefic timeout.
# Needs
If you have a limited mysql connection pool and you are not sure if you may have unexpected queries that may take a really long time and allocate the pool for this time. So use the `mysql-punisher` to watch the exceeded execution time for the active query processes, killed them, log them and let your app work as expected for all end users.
# Installation
To use the mysql-punisher from you command line interface, you have to
```
npm install mysql-punisher -g
```
### Usage
```
mysql-punisher -h -u -p
```
or
```
mpun -h -u [-p ]
```
### Using PM2 (Recommended)
PM2 is a process manager for Node.js applications.
```
npm install -g pm2
pm2 start mysql-punisher -- -h -u -p
pm2 startup
pm2 save
```
### Logs
All killed process will be logged into the stdout in the following format:
```
KILL {id} {time}s {query}
```
Example
```
KILL 8978 31s SELECT SLEEP(100)
```
### Requirements
The user that used to establish the connection usign the option `-u` should have the privilege to execute `SHOW FULL PROCESSLIST` for the desired processes.
### Testing
To check if everything is working fine and the mysql-punisher kills the queries, you can make a dump long query by:
```
SELECT SLEEP(100);
```
### Options
* --help **output usage information**
* -h, --host <host> **host name (default: 'localhost')**
* -u, --user <user> **user name (default: 'root')**
* -p, --password <password> **password (default: '')**
* -t, --timeout <seconds> **timeout in seconds (default: 30)**
* -i, --interval <millisecond> **timer's interval in millisecond (default: 1000)**
* --watch-database <database> **watch a specefic database processes (default: 'all')**
* --watch-host <host> **watch a specefic host's processes (default: 'all')**
* --watch-user <user> **watch a specefic user's processes (default: 'all')**
# License
This project is under the MIT license.