SYNOPSIS¶

Usage: pmp-check-mysql-innodb [OPTIONS]
Options:
  -C CHECK        What to alert on; default idle_blocker_duration.
                  Other options: waiter_count, max_duration.
  -c CRIT         Critical threshold; default varies.
  --defaults-file FILE Only read mysql options from the given file.
                  Defaults to /etc/nagios/mysql.cnf if it exists.
  -H HOST         MySQL hostname.
  -l USER         MySQL username.
  -L LOGIN-PATH   Use login-path to access MySQL (with MySQL client 5.6).
  -p PASS         MySQL password.
  -P PORT         MySQL port.
  -S SOCKET       MySQL socket file.
  -w WARN         Warning threshold; default varies.
  --help          Print help and exit.
  --version       Print version and exit.
Options must be given as --option value, not --option=value or -Ovalue.
Use perldoc to read embedded documentation with more details.

DESCRIPTION¶

This Nagios plugin alerts on various aspects of InnoDB status in several ways, depending on the value of the -C option:

idle_blocker_duration

This is the default behavior. It alerts when a long-running transaction is blocking another, and the blocker is idle (Sleep). The threshold is based on how long the transaction has been idle. Long-running idle transactions that have acquired locks but not released them are a frequent cause of application downtime due to lock wait timeouts and rollbacks, especially because applications are often not designed to handle such errors correctly. The problem is usually due to another error that causes a transaction not to be committed, such as performing very long tasks in the application while holding the transaction open.

This check examines the INFORMATION_SCHEMA tables included with InnoDB version 1.0 and newer. The default critical level is 600, and warning is 60. If the tables do not exist, the exit status is OK, with a note that the tables do not exist.

waiter_count

Alerts if too many transactions are in LOCK WAIT status. Uses information from SHOW ENGINE INNODB STATUS if the INFORMATION_SCHEMA tables are not available. The default critical level is 25, and warning is 10.

max_duration

Alerts if any transaction is too old. Uses information from SHOW ENGINE INNODB STATUS if the INFORMATION_SCHEMA tables are not available. The default critical level is 600, and warning is 60.

PRIVILEGES¶

This plugin executes the following commands against MySQL:

• SHOW ENGINE INNODB STATUS.
• SELECT against the INFORMATION_SCHEMA InnoDB transaction and lock tables.

This plugin executes no UNIX commands that may need special privileges.

VERSION¶

Percona Monitoring Plugins pmp-check-mysql-innodb 1.1.8