Refactoring: Moved more storage check parameters from unsorted.py to dedicated module...
[check_mk.git] / checkman / check_sql
blob3eefc6ad78c4fd814d91a2ada7cf53283247557a
1 title: SQL database request check
2 agents: active
3 catalog: agentless
4 license: GPL
5 distribution: check_mk
6 description:
7   This is an active check that connects to a database server, sends an SQL
8   statement to that server, and checks for the following result:
10   The query must return three columns, a number, a text, and optional
11   performance data in the third column. The columns are comma-separated.
12   Performance data must be in the standard format of nagios performance data.
13   If upper and lower levels are given, the number is checked
14   against these levels and the according state is being computed.
15   Otherwise the number ist treated as a Nagios state (0,1,2,3).
16   State, text and the performance data are being returned.
18   The check works with MySQL, Postgresql, MSSQL and Oracle databases using the
19   python drivers MySQLdb, psycopg2, pymssql and cx_Oracle. For cx_Oracle the
20   Oracle instantclient needs to be installed as well, and the
21   LD_LIBRARY_PATH needs to be modified to point to the libclntsh.so of
22   that package.
24   The oracle check supports procedure calls. It must return excactly one output
25   variable. The value of the variable must be in the same format as the return
26   value of the sql statement described above.
28   This check can be configured by WATO.
30   See the {usage} page of the check for details about the invocation on the command line.