{"id":31943444,"url":"https://github.com/lausser/check_db2_health","last_synced_at":"2025-10-14T09:56:12.904Z","repository":{"id":812351,"uuid":"520579","full_name":"lausser/check_db2_health","owner":"lausser","description":" A plugin (monitoring-plugin, not nagios-plugin, see also http://is.gd/PP1330) which checks various parameters of DB2 database servers. This plugin is also part of OMD, go to https://labs.consol.de/repo/, install OMD and there you have check_db2_health.","archived":false,"fork":false,"pushed_at":"2021-07-09T12:21:45.000Z","size":210,"stargazers_count":8,"open_issues_count":6,"forks_count":1,"subscribers_count":7,"default_branch":"master","last_synced_at":"2024-04-17T00:19:08.504Z","etag":null,"topics":["db2","icinga","monitoring","naemon","nagios","nagios-plugins"],"latest_commit_sha":null,"homepage":"https://omd.consol.de/docs/plugins/check_db2_health","language":"Perl","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/lausser.png","metadata":{"files":{"readme":"README","changelog":"ChangeLog","contributing":null,"funding":null,"license":"COPYING","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2010-02-16T17:10:24.000Z","updated_at":"2023-07-11T17:20:31.000Z","dependencies_parsed_at":"2022-08-16T11:00:21.740Z","dependency_job_id":null,"html_url":"https://github.com/lausser/check_db2_health","commit_stats":null,"previous_names":[],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/lausser/check_db2_health","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/lausser%2Fcheck_db2_health","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/lausser%2Fcheck_db2_health/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/lausser%2Fcheck_db2_health/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/lausser%2Fcheck_db2_health/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/lausser","download_url":"https://codeload.github.com/lausser/check_db2_health/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/lausser%2Fcheck_db2_health/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":279018549,"owners_count":26086404,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-10-14T02:00:06.444Z","response_time":60,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["db2","icinga","monitoring","naemon","nagios","nagios-plugins"],"created_at":"2025-10-14T09:56:11.874Z","updated_at":"2025-10-14T09:56:12.896Z","avatar_url":"https://github.com/lausser.png","language":"Perl","funding_links":[],"categories":["Nagios Monitoring"],"sub_categories":["Nagios Monitoring Plugins"],"readme":"check_db2_health Nagios Plugin README\n---------------------\n\nThis plugin is used to monitor a variety of db2 database metrics. \n\n* For instructions on installing this plugin for use with Nagios,\n  see below. In addition, generic instructions for the GNU toolchain\n  can be found in the INSTALL file.\n\n* For major changes between releases, read the CHANGES file.\n\n* For information on detailed changes that have been made,\n  read the Changelog file.\n\n* This plugin is self documenting.  All plugins that comply with\n  the basic guidelines for development will provide detailed help when\n  invoked with the '-h' or '--help' options.\n\nYou can check for the latest plugin at:\n  http://www.consol.com/opensource/nagios/check-db2-health\n\nThe documentation in this README covers only the most common features.\nTo view the full documentation and examples, go to \n  http://www.consol.com/opensource/nagios/check-db2-health or\n  http://www.consol.de/opensource/nagios/check-db2-health\n\nSend mail to gerhard.lausser@consol.de for assistance.\nPlease include the OS type/version and the Perl DBI/DBD version\nthat you are using.\nAlso, run the plugin with the '-vvv' option and provide the resulting \nversion information.  Of course, there may be additional diagnostic information\nrequired as well.  Use good judgment.\n\nFor patch submissions and bug reports, please send me a mail. You can also find\nme at http://www.nagios-portal.de\n\n\n\n\nHow to \"compile\" the check_db2_health script.\n--------------------------------------------------------\n\n1) Run the configure script to initialize variables and create a Makefile, etc.\n\n\t./configure --prefix=BASEDIRECTORY --with-nagios-user=SOMEUSER --with-nagios-group=SOMEGROUP --with-perl=PATH_TO_PERL --with-statefiles-dir=STATE_PATH\n\n   a) Replace BASEDIRECTORY with the path of the directory under which Nagios\n      is installed (default is '/usr/local/nagios')\n   b) Replace SOMEUSER with the name of a user on your system that will be\n      assigned permissions to the installed plugins (default is 'nagios')\n   c) Replace SOMEGRP with the name of a group on your system that will be\n      assigned permissions to the installed plugins (default is 'nagios')\n   d) Replace PATH_TO_PERL with the path where a perl binary can be found.\n      Besides the system wide perl you might have installed a private perl\n      just for the nagios plugins (default is the perl in your path).\n   e) Replace STATE_PATH with the directory where you want the script to\n      write state files which transport information from one run to the next.\n      (default is /tmp)\n\n   Simply running ./configure will be sufficient to create a check_db2_health\n   script which you can customize later.\n      \n\n2) \"Compile\" the plugin with the following command:\n\n\tmake\n\n    This will produce a \"check_db2_health\" script. You will also find\n    a \"check_db2_health.pl\" which you better ignore. It is the base for\n    the compilation filled with placeholders. These will be replaced during\n    the make process.\n\n\n3) Install the compiled plugin script with the following command:\n\n\tmake install\n\n   The installation procedure will attempt to place the plugin in a \n   'libexec/' subdirectory in the base directory you specified with\n   the --prefix argument to the configure script.\n\n\n4) Verify that your configuration files for Nagios contains\n   the correct paths to the new plugin.\n\n\nCommand line parameters\n-----------------------\n\n--connect=\u003cthe db2 connect string\u003e\n   This is what you would also use with tnsping and sqlplus.\n\n--user=\u003cusername\u003e\n   This is the user which reads the system tables.\n\n--password=\u003csecret\u003e\n   This is the user's password.\n\n--mode=\u003coperation mode\u003e\n   This parameter tells the plugin what it should check.\n   The list of known modes may grow frequently. Please look at \n   http://www.consol.com/opensource/nagios/check-db2-health for a list\n   of features.\n\n--tablespace=\u003ctablespace name\u003e\n  Tablespace-related modes check all tablespaces in one run by default.\n  If only a single tablespace should be checked, use this parameter.\n\n--warning=\u003cwarning threshold\u003e\n  If the metric is out of this range, the plugin returns a warning.\n\n--critical=\u003ccritical threshold\u003e\n  If the metric is out of this range, the plugin returns a critical.\n\n   \n\nHow to prepare the database for monitoring\n--------------------------------------\n\nDatabase user:\n[root@dbsrv12 ~]# groupadd nagios\n[root@dbsrv12 ~]# useradd -g nagios -s /bin/false nagios \n[root@dbsrv12 ~]# passwd nagios\n\nGrant sysmon authority:\ndb2inst1$ db2 update dbm cfg using sysmon_group nagios\ndb2inst1$ db2 grant select,update on table SYSTOOLS.STMG_DBSIZE_INFO to nagios\n\nSwitch on the performance counters:\ndb2 update dbm cfg using dft_mon_bufpool   on\ndb2 update dbm cfg using dft_mon_lock      on\ndb2 update dbm cfg using dft_mon_timestamp on\n\n--------------------------------------\nThat's it.  If you have any problems or questions, feel free to send mail\nto gerhard.lausser@consol.de\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Flausser%2Fcheck_db2_health","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Flausser%2Fcheck_db2_health","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Flausser%2Fcheck_db2_health/lists"}