Check mysql-user-security


Check user’s security in MySQL/MariaDB. Logic is taken from MySQLTuner script, v1.9.8.

The users mysql.sys and mariadb.sys, which are system users used as the definer for view, procedures, and functions in the sys schema, are ignored, because they use an invalid password. This ensures that should these accounts get unlocked by mistake, it is still impossible to login. It is thus recommended not to reset the password. These users are required as long as a sys schema is installed.


  • On RHEL 7+, one way to install the Python MySQL Connector is via pip install pymysql

  • Compared to check_mysql / MySQLTuner this check currently:

    • supports only simple login with username/password (not via SSL/TLS)

    • does not support a connection via socket

Fact Sheet

Check Plugin Download

Check Interval Recommendation

Once a day

Can be called without parameters


Available for

Python 3, Windows


Python module pymysql; User with SELECT privileges on mysql.user, locked down to - for example monitoring@ Usernames in MySQL/MariaDB are limited to 16 chars in specific versions.


usage: mysql-user-security [-h] [-V] [--always-ok] [-H HOSTNAME]
                           [-p PASSWORD] [--port PORT]
                           [--severity {warn,crit}] [-u USERNAME]

Check user's security in MySQL/MariaDB.

  -h, --help            show this help message and exit
  -V, --version         show program's version number and exit
  --always-ok           Always returns OK.
  -H HOSTNAME, --hostname HOSTNAME
                        MySQL/MariaDB hostname. Default:
  -p PASSWORD, --password PASSWORD
                        Use the indicated password to authenticate the
                        connection. Default:
  --port PORT           MySQL/MariaDB port. Default: 3306
  --severity {warn,crit}
                        Severity for alerts that do not depend on thresholds.
                        One of "warn" or "crit". Default: warn
  -u USERNAME, --username USERNAME
                        MySQL/MariaDB username. Default: root

Usage Examples

./mysql-user-security --hostname localhost --username root --password mypassword


1 anonymous user account [WARNING]. 1 user with username as password [WARNING]. 1 account without hostname restriction [WARNING].

Remove anonymous users:
* DROP USER ''@'centos7.loc';

Change user passwords:
* SET PASSWORD FOR 'root'@'localhost' = PASSWORD("I9n2eSGZ8u9MrScx0ckWYhGpQk6ouKh1yMn7Jnwj");

Restrict users:
* RENAME USER 'mariadb-admin'@'%' TO 'mariadb-admin'@'LimitedIPRangeOrLocalhost';


  • WARN if anonymous users are found

  • WARN if users having empty passwords are found

  • WARN if users with user / uppercase / capitalise user as password are found (does not work on MySQL 8, ignored)

  • WARN if users without hostname restriction are found

Perfdata / Metrics

There is no perfdata.

Credits, License