diff options
Diffstat (limited to 'nagios-plugins-contrib-24.20190301~bpo9+1/check_mysql_health/check_mysql_health-2.2.2/README')
-rwxr-xr-x | nagios-plugins-contrib-24.20190301~bpo9+1/check_mysql_health/check_mysql_health-2.2.2/README | 140 |
1 files changed, 140 insertions, 0 deletions
diff --git a/nagios-plugins-contrib-24.20190301~bpo9+1/check_mysql_health/check_mysql_health-2.2.2/README b/nagios-plugins-contrib-24.20190301~bpo9+1/check_mysql_health/check_mysql_health-2.2.2/README new file mode 100755 index 0000000..e98b9b3 --- /dev/null +++ b/nagios-plugins-contrib-24.20190301~bpo9+1/check_mysql_health/check_mysql_health-2.2.2/README @@ -0,0 +1,140 @@ +check_mysql_health Nagios Plugin README +--------------------- + +This plugin is used to monitor a variety of mysql database metrics. + +* For instructions on installing this plugin for use with Nagios, + see below. In addition, generic instructions for the GNU toolchain + can be found in the INSTALL file. + +* For major changes between releases, read the CHANGES file. + +* For information on detailed changes that have been made, + read the Changelog file. + +* This plugin is self documenting. All plugins that comply with + the basic guidelines for development will provide detailed help when + invoked with the '-h' or '--help' options. + +You can check for the latest plugin at: + http://www.consol.com/opensource/nagios/check-mysql-health + +The documentation in this README covers only the most common features. +To view the full documentation and examples, go to + http://www.consol.com/opensource/nagios/check-mysql-health or + http://www.consol.de/opensource/nagios/check-mysql-health + +Send mail to gerhard.lausser@consol.de for assistance. +Please include the OS type/version and the Perl DBI/DBD version +that you are using. +Also, run the plugin with the '-vvv' option and provide the resulting +version information. Of course, there may be additional diagnostic information +required as well. Use good judgment. + +For patch submissions and bug reports, please send me a mail. You can also find +me at http://www.nagios-portal.de + + + + +How to "compile" the check_mysql_health script. +-------------------------------------------------------- + +1) Run the configure script to initialize variables and create a Makefile, etc. + + ./configure --prefix=BASEDIRECTORY --with-nagios-user=SOMEUSER --with-nagios-group=SOMEGROUP --with-perl=PATH_TO_PERL --with-statefiles-dir=STATE_PATH + + a) Replace BASEDIRECTORY with the path of the directory under which Nagios + is installed (default is '/usr/local/nagios') + b) Replace SOMEUSER with the name of a user on your system that will be + assigned permissions to the installed plugins (default is 'nagios') + c) Replace SOMEGRP with the name of a group on your system that will be + assigned permissions to the installed plugins (default is 'nagios') + d) Replace PATH_TO_PERL with the path where a perl binary can be found. + Besides the system wide perl you might have installed a private perl + just for the nagios plugins (default is the perl in your path). + e) Replace STATE_PATH with the directory where you want the script to + write state files which transport information from one run to the next. + (default is /tmp) + + Simply running ./configure will be sufficient to create a check_mysql_health + script which you can customize later. + + +2) "Compile" the plugin with the following command: + + make + + This will produce a "check_mysql_health" script. You will also find + a "check_mysql_health.pl" which you better ignore. It is the base for + the compilation filled with placeholders. These will be replaced during + the make process. + + +3) Install the compiled plugin script with the following command: + + make install + + The installation procedure will attempt to place the plugin in a + 'libexec/' subdirectory in the base directory you specified with + the --prefix argument to the configure script. + + +4) Verify that your configuration files for Nagios contains + the correct paths to the new plugin. + + +Command line parameters +----------------------- + +--hostname=<the mysql connect string> + This is what you would also use with tnsping and sqlplus. + +--username=<username> + This is the user which reads the system tables. + +--password=<secret> + This is the user's password. + +--mode=<operation mode> + This parameter tells the plugin what it should check. + The list of known modes may grow frequently. Please look at + http://www.consol.com/opensource/nagios/check-mysql-health for a list + of features. + +--replication-user=<username of replication user> + This is the username used to authenticated mysql replication, this is useful + with the longprocs mode where the replication users process is not counted as + a longrunning process. + +--warning=<warning threshold> + If the metric is out of this range, the plugin returns a warning. + +--critical=<critical threshold> + If the metric is out of this range, the plugin returns a critical. + + + +How to prepare the database for monitoring +-------------------------------------- + +GRANT USAGE ON *.* TO 'nagios'@'nagiosserver' IDENTIFIED BY 'nagiospassword'; + +-------------------------------------- + +That's it. If you have any problems or questions, feel free to send mail +to gerhard.lausser@consol.de + +Please do not send me a mail like this: + ++-------------------------------------------------+ +| I need monitor of database urgent. Please help. | +| Suresh | ++-------------------------------------------------+ + +I will answer you: + ++-------------------------------------------------+ +| A drumm Schelln konnst hom | +| Gerhard | ++-------------------------------------------------+ |