GitXplorerGitXplorer
d

mysql_maxdiskusage

public
15 stars
1 forks
1 issues

Commits

List of commits on branch master.
Unverified
48ab7247cc6570b8064ff032a656db44dba12ed6

New version: 1.0

ddveeden committed 4 years ago
Verified
6fc51c2cfd7250e04195a325879763dafd606495

Merge pull request #5 from dveeden/clang_format

ddveeden committed 4 years ago
Unverified
b96418170e9c41f377069e7fcce69dcc4d300bf3

Mention clang-format in the README

ddveeden committed 4 years ago
Verified
a9261188c566433d956ba542c0515ffd5f632a58

Making the plugin block connections if disk space usage exceeds a configured percentage. (#4)

MMGaafar committed 4 years ago
Unverified
ac16cd01b6ec901c9254af070697b5403f926a22

Update README: add MySQL version info

ddveeden committed 6 years ago
Unverified
6584282bfcdd79c729362bea884dd105a6a8d984

Update README: add note setting

ddveeden committed 6 years ago

README

The README file for this repository.

Usage

mysql> INSTALL PLUGIN maxdiskusage SONAME 'maxdiskusage.so';
mysql> SET GLOBAL maxdiskusage_minfree=1000;
mysql> SET GLOBAL maxdiskusage_monitor_fs='/var/lib/mysql';
mysql> SET GLOBAL maxdiskusage_action='WARN';

With WARN:

mysql> INSERT INTO t1() VALUES();
Query OK, 1 row affected, 1 warning (0.00 sec)

mysql> SHOW WARNINGS;
+---------+------+------------------------------------------+
| Level   | Code | Message                                  |
+---------+------+------------------------------------------+
| Warning | 1642 | Writing to a server with high disk usage |
+---------+------+------------------------------------------+
1 row in set (0.00 sec)

With BLOCK:

mysql> INSERT INTO t1() VALUES();
ERROR 3164 (HY000): Aborted by Audit API ('MYSQL_AUDIT_TABLE_ACCESS_INSERT';1).

This message is also written to the error log:

2018-02-21T08:55:10.490978Z 12 [ERROR] Plugin maxdiskusage reported: 'BLOCKING QUERY: Free filesystem space on /home (7682 MB) is less than 10000 MB: INSERT INTO t1() VALUES()'

Settings

Setting Default Description
maxdiskusage_action WARN WARN, BLOCK or WARN_AND_BLOCK
maxdiskusage_note '' Note to add to the warning message
maxdiskusage_minfree 0 Act if less than x MB of free space is available
maxdiskusage_monitor_fs /var/lib/mysql Directory to monitor, usally @@datadir
maxdiskusage_pct 100 Execute the action if over this percentage of usage
maxdiskusage_block_pct 100 Block if over this percentage of usage if action is WARN_AND_BLOCK
maxdiskusage_warn_skip_count 1000 Skip every x events, reduces warning rate

These can be set with SET GLOBAL, but you probably want to put those in your my.cnf

Building

This is tested against MySQL 5.7 and MySQL 8.0. Pull requests for other MySQL and MariaDB versions are welcome.

Copy the mysql_maxdiskusage directory to the plugin directory of the MySQL source code. Build the code as usual or just run make maxdiskusag. Either use the resulting build or copy maxdiskusage.so to the plugin_dir.

https://dev.mysql.com/doc/refman/5.7/en/compiling-plugin-libraries.html

Might contain some code from https://github.com/gkodinov/audit_tripwire

Contributing

Please open issues and send pull requests on GitHub.

Please format your code with clang-format.

Related links